付费 工具 RptToolbox —— 工具箱 · 一键开末影箱/工作台/锻造台 · 全 GUI · 不用放方块 [1.21 ~ 26.2] 1.0.0

关于这个插件​

RptToolbox 是一个服务端侧的「工具箱」。
玩家不用在身上带工作台，也不用跑到附魔台旁边 —— 一条指令或点一下菜单图标，对应的原版界面就直接打开。实现方式是调用服务端自身的界面接口（Location 传 null + force = true），不放置任何方块、不生成虚拟方块，所以关掉界面后世界里不会留下任何东西。
对服主来说，它是可配置的：菜单标题、行数、9 个工具各自的名字与说明、摆在第几格、冷却几秒、是否要消耗一件「门票物品」、每个工具要什么权限 —— 全部写在 config.yml 里，改完 /rpttb reload 立即生效，不需要重启服务端。

功能说明​

1. 工具箱菜单（GUI）​

• /rpttb 直接打开一个箱子界面，9 个工具的图标按配置摆好，鼠标悬停即可看到名字与说明。
• 菜单标题、行数（16 行 = 954 格）、空格子填充物都能在配置里改；空格子默认用灰色玻璃板填充。
• 点击图标即打开对应的原版界面（会先自动关掉菜单，再打开真正的界面 —— 避免客户端把新界面当成"旧界面关闭"而丢掉）。
• 菜单里所有点击与拖拽都会被拦下：图标拿不走、也塞不进东西，不会出现"把菜单当仓库用"的情况。

2. 九种工具​

• 每个工具都能单独开关（enabled）、改名字 / 改说明（name / lore，支持 MiniMessage 富文本）、指定摆在菜单第几格（slot）。
• 关掉某个工具后，它在菜单里不显示，指令也打不开。

3. 指令直开（不经过菜单）​

• /rpttb <工具id> —— 例如 /rpttb workbench，比开菜单再点更快。
• 输入工具 id 时支持 Tab 补全（只补全当前启用的工具）。

4. 冷却​

• cooldown-seconds 决定每个玩家、每个工具各自的冷却秒数（默认 3，填 0 表示不限制）。
• 冷却中再点会提示还剩几秒。
• 拥有权限 rpttb.bypass.cooldown 的玩家无视冷却。
• 玩家下线时会自动清掉他的冷却记录，长时间开服的服务器不会因此堆积内存。

5. 消耗物品（门票制）​

• 打开 consume-item.enabled 后，每次打开工具都要先扣掉指定物品（默认关；示例配置为 1 个钻石）。
• 物品不足会直接拒绝打开，并提示需要什么；扣成功会给一条消耗提示。
• 拥有权限 rpttb.bypass.consume 的玩家不消耗。
• 扣物品前会先精确统计背包数量（含快捷栏），数量不够时一件都不扣。

6. 管理员功能​

支持版本与环境​

目标用户​

• 想让玩家少跑腿的生存服 / 公益服服主 —— 工作台、附魔台、末影箱随手就能开，省掉一堆"放工作台被拆走"的纠纷。
• 正在用 Folia 核心的服主 —— 市面上的工具箱类插件大多直接调用 Bukkit.getScheduler()，在 Folia 上根本跑不起来；本插件从设计上就是双端兼容。
• 想按权限分级发放功能的服主 —— 9 个工具各有独立权限节点，可以只给 VIP 开末影箱、只给某些组开附魔台。
• 想拿工具箱当"付费权益"的服主 —— 权限默认只给 OP，普通玩家要授权才有，天然适合做成会员/购买后可用的功能。

是否付费​

付费插件。 具体定价与授权方式以资源页「售价」项为准。

• 插件不含任何联网校验、授权服务器或机器绑定，购买后安装即用，离线环境照常运行。
• 不区分免费版 / 高级版，买到的就是完整功能（9 个工具 + 全部配置项）。
• 插件未做任何混淆，欢迎安全审查。

获取作者帮助​

使用教程​

安装​

1. 把 RptToolbox-1.0.0.jar 放进服务端 plugins/ 目录。
2. 重启服务端（换 jar / 新装插件不支持热加载）。
3. 首次启动会生成 plugins/RptToolbox/config.yml，默认配置开箱可用，不改也能直接跑。
4. 按需修改 config.yml，然后执行 /rpttb reload 生效，不需要重启服务端。

玩家打开工具箱的最快方式：直接输入 /rpttb（不带参数），或 /toolbox、/rptbox。

点击展开...

指令列表​

主指令为 /rpttb，别名 /toolbox、/rptbox。

点击展开...

权限节点​

默认口径：普通玩家默认没有任何功能权限（避免白嫖），OP 默认全部拥有（服主开箱即用）。 要给普通玩家开放，用权限插件逐个授予即可，例如 LuckPerms： /lp user <玩家> permission set rpttb.use true

点击展开...

主要配置项（config.yml）​

配置写错（空值、非法 MiniMessage、不存在的物品名、槽位越界或重复）时，插件会自动退回默认值并在控制台提示一次，不会把异常抛给玩家、也不会让插件加载失败。

点击展开...

常见问题​

• 为什么我（OP）打不开，提示没有权限？ 请确认权限节点是 rpttb.use（以及对应的 rpttb.use.<工具id>）。本插件默认只给 OP，如果服务端装了权限插件（LuckPerms 等），OP 组若被显式设置了 -rpttb.use 之类的负权限，需要一并检查。
• 普通玩家怎么开放？ 给 rpttb.use + 想开放的 rpttb.use.<工具id> 两个节点即可，其余工具不给就用不了。
• 附魔台为什么只能附出低级附魔？ 便携式附魔台没有书架加成（书架能量为 0），这是所有"随身附魔台"的固有限制，原版放着附魔台右键才有书架加成。介意的话可以把 tools.enchanting.enabled 设为 false 关掉它。
• 冷却和门票怎么配？ cooldown-seconds 管冷却（每玩家每工具独立）；consume-item.enabled + material + amount 管门票。门票是全局统一的，不区分工具。
• 能只给某些玩家开末影箱吗？ 能。给这些玩家 rpttb.use + rpttb.use.enderchest，其他工具的节点不发即可。
• 改完配置要重启吗？ 不用，/rpttb reload 即可；但换 jar 必须重启（服务端不支持热替换插件本体）。
• 菜单行数改小会怎样？ 槽位超出新范围的工具不会显示在菜单里，但用指令仍然能打开，控制台会提示是哪几个。把行数改回去就恢复。