TradeUpX

TRADEUPX
Put 5 items of the same tier in, get 1 random item of the next tier out. TradeUPX brings the CS-style trade-up contract to Rust: weighted item pools, a case-opening reveal strip, a jackpot guarantee, contracts, skins and a lucky DOUBLE UP that skips a whole tier.

Players love it because every pile of spare gear becomes a gamble with real odds shown on screen, and every jackpot gets announced to the server. Owners love it because it is a scrap sink that is fully configurable, ships with a ready-made roster, and is built so it cannot be duped, split or farmed.

- Core Features -

Trade-Up Rules

• 5 items of one tier in (2-8, your choice), 1 item of the next tier out.
• The first item sets the tier for every slot; the top tier cannot be traded up.
• Items stay in the player's inventory until Trade Up is pressed. Nothing is taken earlier.
• The item picker greys out items it can't use and says why: top tier, other tier, not in the contract, in use, skinned, below the minimum condition.

Tiers & Weighted Pools

• Any number of tiers, each with a name, a colour, a trade cost and its own item pool.
• Every item has a Weight (relative chance), an Amount (e.g. 2 satchels or 20 explosive ammo) and optional skins.
• Weight 0 = can be traded in but never comes out.
• POSSIBLE RESULT shows the real % of every item the next trade can give, with luck and the contract included.
• The TIERS page shows every pool in a scrolling row, with jackpot items marked.

Default Item Roster

• 102 items in 5 tiers (Common, Uncommon, Rare, Epic, Legendary), ordered by workbench level, loot-only status and PvP strength.
• Every weapon, armor / protective clothing piece and explosive: from the Eoka and burlap up to the AK, heavy plate, M249, Minigun, rocket launchers, satchels and C4.
• 10 jackpot items by default (e.g. Double Barrel, Metal Facemask, AK, M249, C4).
• Autofill: one admin command scans the game and adds any weapon, armor or explosive the pools miss (after a Rust update, for example), placed by workbench level or rarity. A dry run lists the additions first.

Reveal Animation

• A CS-case style strip spins and lands on the result, with an end sound effect.
• Duration 1-10 s (default 3), or turn it off. Players can always SKIP.
• The item is given BEFORE the strip starts: closing the window, dying or disconnecting never loses it.

Jackpot Guarantee (Pity)

• Jackpot items are tagged in the UI, announced, and count for pity and VIP luck.
• After 20 trades into a tier without its jackpot (configurable), the next result from that tier is a jackpot item.
• One counter per result tier, shown as a bar with "N trades left". Cheap tiers can't build pity for expensive ones.

Contracts

• ANY, WEAPONS, ARMOR, TOOLS or EXPLOSIVES: pick one and the result is drawn only from that type.
• Every input must then be of that type too. Unavailable contracts are greyed out and say why.
• Contract types are set by Rust item categories; explosives by a shortname list (C4, satchel, grenades, rockets, explosive ammo).

Skins

• Give each pool item a list of workshop skin IDs: the result gets one at random.
• Skinned inputs are blocked by default so no paid skin is lost by accident.
• Optional: allow skinned inputs and let the result keep the input skin when it is on the result's list.

Double Up

• A 3% chance (configurable) to skip one extra tier: the result comes from two tiers up.
• Its own DOUBLE UP screen shows the skipped tier. Never goes past the top tier.

Trade Cost & Economy

• Each tier has its own cost per trade: an item (scrap by default: 50 / 100 / 250 / 500), Economics, ServerRewards or free.
• The cost and the player's balance are shown before trading.
• Optional cooldown between trades that survives reloads and restarts.

Exploit-Proof by Design

• Every item, the cost and the cooldown are checked again on Trade Up, and the trade completes in one server tick.
• A stack result can't be split over several slots: an input slot takes the pool Amount (shown "x20").
• A stack can only fill as many slots as it holds; an item that leaves the inventory leaves its slot.
• Items placed in the slots can't also pay the trade cost.
• Inputs must be at full condition by default (repair-worn max condition counts), so broken loot can't be laundered.
• Attachments, loaded ammo and fuel of traded items are given back; a full inventory drops the result at the player's feet.
• Window clicks are rate-limited, so binds and F1 loops can't flood the server.
• A broken config or data file is never overwritten.
• Other plugins can veto any trade through a hook.

Announcements & Discord

• Server-wide chat line (each player reads it in their own language), plus an optional toast.
• Pick which pulls are announced: every trade, jackpots, double ups; set a minimum result tier.
• Discord webhook: an embed with the player, the item, its tier and the tier colour. A test command shows the HTTP result.

VIP Profiles

• Any number of profiles, each one a permission. A player with several gets the best value of each.
• Cost Multiplier (0.8 = 20% off, 0 = free), own cooldown, Luck Multiplier for jackpot weights, Double Up bonus %.
• Default tradeupx.vip: 20% off, no cooldown, 25% more jackpot luck, +1% double up.

Player UI

• Trade Up, Tiers and History pages, a help screen and live checks (same tier, slots filled, jackpot progress).
• History of the last 20 trades with time, inputs, result, skin, JACKPOT and DOUBLE UP flags.

What you can change in the config

• General: Chat Command, Permission, Items Per Trade (2-8), Cooldown Seconds, Min Input Condition %, Allow Skinned Items, Keep Input Skin When Possible, Log Trades To File, Prune History After Inactive Days.
• Wipe (new map): Reset History, Reset Pity, Reset Cooldowns.
• Contracts: Enabled, Weapons / Armor / Tools (item categories), Explosives (item shortnames).
• Autofill: Weight Of Added Items, Never Add (item shortnames).
• Pity: Enabled, Trades Without Jackpot Before Guarantee.
• Double Up: Chance %.
• Reveal Animation: Enabled, Duration Seconds, End Effect Prefabs.
• Announcements: Chat Broadcast, Toast, Events (Trade, Jackpot, DoubleUp), Min Result Tier.
• Discord: Webhook URL, Events.
• VIP Profiles: Cost Multiplier, Cooldown Seconds, Luck Multiplier, Double Up Bonus %.
• Tiers: Name, Color, Trade Cost (Currency: None / Item / Economics / ServerRewards, Amount, Item Shortname), Items (Shortname, Amount, Weight, Jackpot, Skins).

Languages

• 10 languages included: English, Romanian, German, Spanish, French, Italian, Japanese, Brazilian Portuguese, Russian, Simplified Chinese.
• Each player sees the language of their Rust client; announcements too.

Commands

• /tradeupx - Open the Trade Up window (chat command name is configurable).
• /tradeupx reload (tradeupx.reload) - Reload the config.
• /tradeupx resetpity <player> (tradeupx.resetpity) - Reset a player's jackpot counters.
• /tradeupx resethistory <player> (tradeupx.resethistory) - Clear a player's trade history.
• /tradeupx givepity <player> <tier> <amount> (tradeupx.givepity) - Add jackpot progress for a tier.
• /tradeupx testwebhook (tradeupx.testwebhook) - Send a Discord test message.
• /tradeupx autofill [dryrun] (tradeupx.autofill) - Add missing weapons, armor and explosives to the tiers.
• <player> is a Steam ID (offline players too) or part of a name. Every admin command is logged.

Permissions

• tradeupx.use - Open the window and trade (configurable; leave empty to allow everyone).
• tradeupx.admin - Reload and run the admin commands (also allows trading).
• tradeupx.vip - Default VIP profile; every profile in the config becomes its own permission.

API for Developers

• int GetTotalTrades(ulong steamId) - Total trades a player has made.
• List<Dictionary<string, object>> GetHistory(ulong steamId) - The last 20 trades, newest first (time, inputs, result, amount, skin, jackpot, doubleUp).
• Dictionary<int, int> GetPity(ulong steamId) - Jackpot progress per result tier.

Hooks

• object CanTradeUpX(BasePlayer player, List<Item> inputs) - Called before a trade; return non-null to block it (a string is shown to the player as the reason).
• void OnTradeUpX(BasePlayer player, List<string> inputs, Item result) - Called after a trade.
• void OnTradeUpXJackpot(BasePlayer player, Item result, int tier) - Called after a jackpot result.

Requirements

• Oxide or Carbon. Economics or ServerRewards only if a tier uses them as the trade cost.