Up Items Plugin

Up Items Plugin

Up Items Plugin adds a risk-and-reward item upgrader to your Paper server. A player puts an item on the altar, picks the item they actually want, and spins. Win and the item is delivered straight to their inventory. Lose and the item they put in is gone for good.

It’s built for survival, SMP and economy servers that want a late-game item sink with a bit of tension. Players with spare resources get a reason to gamble them, and you get a way to take excess items (and money) out of circulation.

How it works

1. Run /up to open the upgrader menu.
2. Put an item in the left slot. This is your stake.
3. Click the center frame to open the catalog (every obtainable item, paged) and choose the item you want. A sign button lets you search by name through chat.
4. Set the amount you want: left click +1, right click −1, Shift for ±10.
5. Press UPGRADE. The menu spins with sound effects, then gives the result.

The success chance is shown on the button before you commit, so nothing is hidden from the player.

How the chance is calculated

chance = (value of what you give / value of what you want) × (1 − house edge)

The result is clamped between a minimum and a maximum chance (default 1% to 95%), so no upgrade is ever guaranteed.

With the default values, 10 iron ingots (value 100) for 1 netherite ingot (value 400) gives about 22.5%. Damaged tools and armor are worth less, and items that shouldn’t be tradable (bedrock, spawners, command blocks, etc.) are excluded automatically. You can set your own value for any item, or blacklist items entirely.

Features

• Catalog with paging and in-chat search
• Fully configurable odds: house edge, min/max chance, global value multiplier
• Custom item values and a blacklist in config.yml
• Spin animation with sounds
• Attempt limit (for example 5 tries per minute) to stop spam
• If a player logs out during a spin, the result is still delivered
• Optional money loss through Vault or VaultUnlocked: when a player loses, a sum is also taken from their balance, either based on the burned item’s value or a fixed amount. If no economy plugin is installed, balances are simply not touched
• UpgradeEvent so other plugins can listen to or cancel upgrades
• /up works as a plain command even if another plugin (such as WorldEdit) also uses it

Commands and permissions

With LuckPerms: /lp group default permission set upgrader.use true

Configuration

Everything lives in plugins/UpItemsPlugin/config.yml:

house-edge: 0.10
min-chance: 0.01
max-chance: 0.95
attempt-limit: 5
attempt-window-seconds: 60
loss-charge-enabled: true
loss-charge-mode: item-value   # or: fixed
money-per-value: 1.0
value-overrides:
  DIAMOND: 100
  NETHERITE_INGOT: 400
blacklist:
  - BEDROCK
  - SPAWNER

Use /up reload after editing, no restart needed.

Installation

1. Download the jar that matches your server version (1.20.4 or 1.21.4).
2. Put it in your plugins folder and restart the server.
3. Give players the upgrader.use permission.

FAQ

Does it need Vault? No. Vault or VaultUnlocked is only used for the optional money loss.

Can regular players use it? Only if you give them upgrader.use. By default it’s OP only.

Does it work on Fabric or Forge? No, this is a Paper plugin.

Can I change item prices? Yes, via value-overrides and global-value-multiplier.