Up Items Plugin 为你的 Paper 服务器添加了一个充满风险与回报的物品升级器。玩家将物品放置在祭坛上,选择他们真正想要的目标物品,然后进行旋转抽奖。如果获胜,目标物品会直接送入他们的背包;如果失败,放入的物品将永久消失。
它专为生存模式、多人联机(SMP)和经济类服务器设计,旨在提供具有紧张感的后期游戏物品回收机制。拥有闲置资源的玩家有了挥霍它们的理由,而你也获得了一种从流通中移除多余物品(以及金钱)的手段。
工作原理 运行
/up
打开升级器菜单。在左侧插槽中放入一件物品,这是你的赌注。点击中间框架以打开目录(包含所有可获取的物品,分页显示),并选择你想要的物品。通过聊天中的名称搜索功能可以查找物品。设置你需要的数量:左键单击 +1,右键单击 −1,按住 Shift 键 ±10。点击 UPGRADE(升级)。菜单开始旋转并伴有音效,随后给出结果。
在你确认之前,按钮上会显示成功率,因此对玩家来说没有任何隐藏信息。
概率计算方式
chance = (你所提供物品的价值 / 你想要物品的价值) × (1 − 庄家优势)
结果会被限制在最小值和最大值之间(默认为 1% 到 95%),因此没有任何升级是绝对保证成功的。
使用默认值时,用 10 个铁锭(价值 100)换取 1 个下界合金锭(价值 400)的成功率约为 22.5%。受损的工具和盔甲价值较低,不可交易的物品(如基岩、刷怪笼、命令方块等)会被自动排除。你可以为任何物品设置自定义价值,或者完全禁用某些物品。
功能特性 带有分页和聊天内搜索功能的目录
完全可配置的概率:庄家优势、最小/最大成功率、全局价值倍率
自定义物品价值和配置文件中的黑名单
带有音效的旋转动画
尝试次数限制(例如每分钟 5 次)以防止滥用
如果玩家在旋转过程中登出,结果仍会送达
通过 Vault 或 VaultUnlocked 实现可选的金钱扣除:当玩家失败时,除了消耗物品外,还会从其余额中扣除一定金额,金额基于被销毁物品的价值或固定数额。如果没有安装经济插件,则不会触碰余额
UpgradeEvent 事件,允许其他插件监听或取消升级操作
即使其他插件(如 WorldEdit)也使用了该命令,/up 仍可作为一个普通命令使用
命令和权限
命令 描述
/up 打开升级器
/up reload 重新加载配置
权限 描述 默认值
upgrader.use 使用 /up OP
upgrader.admin 使用 /up reload OP
upgrader.free 升级失败时不扣除金钱 无
upgrader.bypass 忽略尝试次数限制 无
配合 LuckPerms 使用:
/lp group default permission set upgrader.use true
配置
所有内容都位于 plugins/UpItemsPlugin/config.yml 中:
yaml
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 # 或者: fixed
money-per-value: 1.0
value-overrides:
DIAMOND: 100
NETHERITE_INGOT: 400
blacklist:
- BEDROCK
- SPAWNER
编辑后请使用 /up reload 重新加载,无需重启服务器。
安装 下载与你服务器版本匹配(1.20.4 或 1.21.4)的 jar 文件。将其放入 plugins 文件夹并重启服务器。给予玩家 upgrader.use 权限。
常见问题
是否需要 Vault?不需要。Vault 或 VaultUnlocked 仅用于可选的金钱扣除功能。
普通玩家可以使用它吗?只有当你赋予他们 upgrader.use 权限时才可以。默认情况下仅限 OP 使用。
它能在 Fabric 或 Forge 上运行吗?不能,这是一个 Paper 插件。
我可以更改物品价格吗?可以,通过 value-overrides 和全局价值倍率进行调整。
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 Run
/up
to open the upgrader menu. Put an item in the left slot. This is your stake. 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. Set the amount you want: left click +1, right click −1, Shift for ±10. 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
Command Description
/up Open the upgrader
/up reload Reload the config
Permission Description Default
upgrader.use Use /up OP
upgrader.admin Use /up reload OP
upgrader.free No money loss on a failed upgrade nobody
upgrader.bypass Ignore the attempt limit nobody
With LuckPerms:
/lp group default permission set upgrader.use true
Configuration
Everything lives in plugins/UpItemsPlugin/config.yml:
yaml
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 Download the jar that matches your server version (1.20.4 or 1.21.4). Put it in your plugins folder and restart the server. 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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧