About ItemX
ITEMX
ItemX is a premium, comprehensive RPG-style progression plugin for Rust that transforms standard equipment into a deep, meaningful progression journey. Featuring 1 to 100 upgrade levels, dynamic enchantments, a player-driven marketplace with integrated social features, and a powerful in-game Admin Dashboard, it is the ultimate solution for servers looking to add depth, economy, and player retention.
In-Game Admin Dashboard
Manage your entire progression system through a sleek, interactive UI.
- **Item Configuration**: Add/Remove items, set custom display names, skin IDs for tiers 9/10, and tier-specific stats.
- **Real-time Settings**: Toggle every module (Upgrade, Enchant, Market, etc.) and adjust global variables instantly.
- **Material Management**: Configure custom crafting recipes for tokens with full skin support.
- **Command Control**: Fully customize every chat command to fit your server's theme.
Modular Permission System
- **Tab-Based Access**: Every module (Upgrade, Enchant, Market, Trade-Up, Deposit, Craft) has its own independent permission.
- **Granular Control**: Set specific permissions per tab or leave blank for "Admins Only" default access.
- Core Features -
Item Upgrade System
- **1 to 100 Upgrade Levels**: Progressive stat bonuses that feel powerful and rewarding.
- **Customizable Logic**: Configure success rates, destruction risks (Levels 8-10), and destruction thresholds.
- **Tier 9 & 10 Specialization**:
- Level 9: Items become **Indestructible**.
- Level 10: Massive damage/protection bonuses (+50% base multipliers).
- **Dynamic Skin System**: Automated skin application for high-tier upgrades to show off power.
- **Resource Support**: Use Scrap, Economics, or ServerRewards for upgrade costs.
Advanced Enchantment System
- **4 Custom Slots**: Unlock the 4th slot using a special Slot Token.
- **Rarity Tiers**: Common, Uncommon, Rare, Epic, Legendary.
- **Available Stats**:
- **Combat**: Dmg/Prot bonuses.
- **Gathering**: Wood, Stone, Scrap, Metal Ore yield multipliers.
- **Utility**: Health regeneration and movement speed.
- **Reroll & Upgrade**: Re-roll specific enchantments or upgrade their values with a risk/reward system.
Global Marketplace & Social System
- **Player Driven Economy**: List upgraded items for scrap or custom currency.
- **Advanced UI**: Search, filter by level/rarity/type, and manage items with a smooth pagination system.
- **Integrated Social Suite**:
- **Player Profiles**: Reputation ratings (1-5 stars) and detailed statistics.
- **Direct Messaging**: Negotiate prices through a dedicated, persistent chat system.
- **Transaction Logs**: Full history of sales, purchases, and earnings.
Trade-Up & Quality Score
- **Quality Mathematic Logic**: Combined Level and Durability calculate an item's "Quality Score."
- **Sacrifice Mechanic**: Combine 5 items to attempt a higher-rarity reward.
- **Outcome Probability**: Dynamically calculated chances for Major Upgrades, Same Tier, or Downgrades.
Secure Storage & Deposit
- **Upgraded-Only Slots**: Safely store your most valuable gear with data preservation.
- **Unlockable Capacity**: Start with free slots and unlock more via custom currency.
- **Withdrawal Cooldowns**: Configurable timers to prevent combat exploit.
Advanced Crafting System
- **Custom Token Creation**: Craft Perfect Tokens (100% success), Bonus Tokens, and Slot Tokens.
- **Customizable Ingredients**: Set unique material requirements for every token via the Admin UI.
Full Localization Support
Supports **10 languages** with live synchronization:
- English, Romanian, German, Spanish, French, Italian, Japanese, Portuguese, Russian, and Chinese.
Commands
- `/upadmin` - **[Admin]** Open the Configuration Dashboard.
- `/upgrade` - Open the Item Upgrade interface.
- `/enchant` - Open the Enchantment table.
- `/marketplace` - Access the Global Marketplace.
- `/tradeup` - Combine items for better gear.
- `/deposit` - Access secure upgraded storage.
- `/iteminfo` - View detailed stats and enchantments of equipped items.
- `/social` - Access profiles and direct messages.
API for Developers
- `bool IsItemUpgradeable(ulong itemUID)` - Check if item is valid.
- `int GetItemUpgradeLevel(ulong itemUID)` - Get current level.
- `Hash<string, object> GetItemUpgradeData(ulong itemUID)` - Get full statistics.
- `void SetItemUpgradeLevel(ulong itemUID, int level)` - Direct level modification.
