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 (It can be locked at 10 levels or however much the server owner wants), 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 this plugin you don't have to mess with the config file, absolutely everything is solved from the admin ui, along with translations for crafting items. Very easy to use and understand.
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.
Expanded Weapon & Armor Roster
The upgrade system now covers a significantly wider range of equipment. Every item below is fully compatible with Upgrade,
Enchant, TradeUp, and the Marketplace out of the box.
Weapons: AK-47 (all variants), Bolt Rifle, L96, LR-300, M39, Semi-Auto Rifle, SKS, MP5, Thompson, Custom SMG, Tier-1 SMG, Pump
Shotgun, SPAS-12, Double Barrel, M4 Shotgun, Waterpipe, Blunderbuss, Krieg Shotgun, Python, Revolver, HC Revolver, Semi-Auto
Pistol, M92, Prototype 17, Eoka Pistol, Nailgun, Speargun, Mini Crossbow, Blowpipe, Flame Thrower, M249, HMLMG, Minigun, M16A2,
Multiple Grenade Launcher, Homing Missile Launcher, Rocket Launcher (all variants), Hunting Bow, Compound Bow, Crossbow,
Salvaged Sword.
Armor: Metal Facemask, Metal Chest Plate, Riot Helmet, Coffee Can Helmet, Bucket Helmet, Road Sign Jacket, Road Sign Kilt, Wood
Armor Jacket, Wood Armor Pants.
Advanced Enchantment System
- 4 Custom Slots: Unlock the 4th slot using a special Slot Token.
- Rarity Tiers: Common, Uncommon, Rare, Epic, Legendary.
- Available Stats:
- Offensive: Fire Damage, Cold Damage, Explosive Damage, Radiation Damage, Armor Penetration, Animal Damage, NPC Damage,
Player Damage, Wet (combos with Cold), Bullet Save.
- Defensive: Fire, Cold, Explosive, Radiation Protection, Generic Damage Reduction, Dry Protection (counters Wet).
- Gathering: Wood, Stone, Scrap/Metal yield multipliers.
- 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.
Performance & Stability
- Smart Save System: Data is saved automatically every 30 seconds only when something has actually changed, instead of after
every single player action. Manual saves on server save and player disconnect are preserved.
- Bonus Caching: Damage and protection multipliers are pre-calculated at startup and cached — no recalculation on every hit.
- Optimized Hot Paths: OnEntityTakeDamage, OnWeaponFired, and gather hooks no longer create unnecessary database entries for
items without upgrades or enchants. Keeps your data file clean and lean regardless of player count.
Full Localization Support
Supports 10 languages with live synchronization:
English, Romanian, German, Spanish, French, Italian, Japanese, Portuguese, Russian, and Chinese.
Commands
- /iu_admin — [Admin] Open the Configuration Dashboard.
- /upgrade — Open the Item Upgrade interface.
- /enchant — Open the Enchantment table.
- /market — 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.
All commands are fully configurable via the Admin Dashboard or config file.
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.
