授权转载 闭源 世界管理 📦 补偿系统插件 — 管理员自定义玩家补偿 轻量 · 灵活 · 一键发放 支持 Spigot 1.12.2，全版本兼容（理论可支持 1.8+）

补偿系统插件 — 管理员自定义玩家补偿
轻量 · 灵活 · 一键发放
支持 Spigot 1.12.2，全版本兼容（理论可支持 1.8+）

插件简介
你是否遇到过以下情况？

服务器维护后需要给特定玩家发放补偿物品；

需要为不同玩家设置不同的补偿礼包；

希望玩家能通过指令自助领取，且不可重复领取。

本插件专为解决此类需求而生！
管理员只需通过 /buchang set <玩家ID> 打开一个箱子界面，将补偿物品放入其中，关闭后系统自动保存。
玩家输入 /buchang get 即可一键领取属于他的补偿，且无法重复领取。

功能特性
可视化设置：管理员通过箱子界面直接放置物品，无需手动编辑配置文件。

玩家独立补偿：每个玩家可拥有不同的补偿物品列表。

不可重复领取：系统自动记录领取状态，防止刷取。

数据持久化：所有补偿数据保存在 plugins/BuChangPlugin/compensations.yml，可手动修改或备份。

权限控制：管理员命令受 buchang.admin 权限保护，普通玩家仅能使用领取指令。

简单易用：仅两个命令，无复杂配置。

命令 & 权限
命令 说明 权限
/buchang set <玩家ID> 打开箱子界面，为指定玩家设置补偿物品 buchang.admin（默认 OP）
/buchang get 领取属于自己的补偿（若存在） 默认所有玩家可用
权限节点：

buchang.admin —— 允许使用设置命令，默认 OP 拥有。

buchang.use —— 允许使用 /buchang get，默认所有玩家拥有。

安装步骤
下载插件 Jar 文件（见下方下载地址）。

将 Jar 文件放入服务器 plugins/ 目录。

重启服务器或使用 /reload 加载插件。

（可选）给予管理员权限：

若使用 OP：直接输入 /op <玩家名> 即可。

若使用权限插件（如 LuckPerms）：执行 lp user <玩家名> permission set buchang.admin true。

使用教程
管理员设置补偿
在游戏内输入 /buchang set Notch（Notch 为玩家 ID）。

自动打开一个 27 格箱子界面（标题为“设置补偿: Notch”）。

将需要补偿的物品（可多个）放入箱子任意格子。

关闭箱子界面，系统自动保存并提示成功。

提示：如果放入的物品为空气或没有物品，设置将被取消。

玩家领取补偿
玩家输入 /buchang get。

若有未领取的补偿，物品将直接加入背包，并提示“补偿物品已发放到你的背包中！”。

若已领取过，会提示“你已经领取过补偿了！”。

若无补偿，会提示“你没有可领取的补偿！”。

数据存储
所有补偿数据保存在 plugins/BuChangPlugin/compensations.yml，格式如下：

yaml
Notch:
items:
- ==: org.bukkit.inventory.ItemStack
type: DIAMOND_SWORD
amount: 1
claimed: false
Steve:
items:
- ==: org.bukkit.inventory.ItemStack
type: GOLD_INGOT
amount: 64
- ==: org.bukkit.inventory.ItemStack
type: DIAMOND
amount: 16
claimed: true
items：物品列表（支持附魔、NBT，但建议通过游戏内设置自动生成）。

claimed：true 表示已领取，false 表示未领取。

注意：请勿手动编辑此文件，除非您熟悉物品序列化格式。建议通过游戏内指令操作。

常见问题Q：支持 1.8+ 版本吗？A：理论上支持，但仅测试过 1.12.2，若有兼容性问题可反馈作者。
Q：补偿物品可以包含附魔、药水效果吗？A：可以，通过箱子界面放入任何合法物品即可，插件会完整保存其属性。
Q：玩家领取时背包满了怎么办？A：物品会尝试加入背包，若背包已满，多余物品会掉落在地上（原版行为），建议玩家提前清理背包。
Q：如何删除某个玩家的补偿？A：管理员可以再次执行 /buchang set <玩家ID>，然后清空箱子并关闭，即可覆盖为新设置（或空）。也可直接删除配置