RptShulkerBox —— 在背包内右键潜影盒即开，不用拿在手上 [1.21 ~ 26.2]
关于这个插件原版里想用潜影盒掏个东西，得走完「放地上 → 打开 → 拿东西 → 敲掉 → 捡起来」一整套操作。在生存服里翻战利品、整理材料时，这套动作每天要重复几十遍。RptShulkerBox 把潜影盒变成随身容器：手持潜影盒右键一下直接打开，不放置任何方块、不改变世界、不产生掉落物。打开的是你手里那个潜影盒里的东西，关掉就自动写回，随时继续带走。
同时它把「打开」和「放置」分得很干净：右键方块默认仍是原版放置行为，想摆出来用照常摆，不会出现「一边打开界面、一边把方块放到地上」的混乱。
功能说明1. 两种默认打开方式
方式
操作
配置项默认
右键空气手持潜影盒对着空气右键allow-interact-airhttps://www.minebbs.com/styles/joypixels/2705.png 开
背包内右键在背包 / 合成界面里右键潜影盒allow-in-inventoryhttps://www.minebbs.com/styles/joypixels/2705.png 开
右键方块手持潜影盒对着普通方块右键allow-interact-blockhttps://www.minebbs.com/styles/joypixels/274c.png 关
其它插件 GUI在商店 / 菜单等第三方界面里右键潜影盒allow-in-other-guihttps://www.minebbs.com/styles/joypixels/274c.png 关
四个场景互相独立，服主按服内习惯自由取舍。默认只开最实用的两种，不会干扰原版操作。
右键方块默认关闭，是为了保住原版的「放置潜影盒」。把它打开后，右键方块会改为打开潜影盒，此时右键方块不再放置，请按需选择。
2. 不落地、不改变世界
[*]打开的是潜影盒物品本身装的东西，不会在世界里放下任何方块，也不会产生掉落物。
[*]关闭界面时内容会自动写回物品，背包（或光标）里的那个潜影盒就是你刚编辑完的那一个。
[*]支持全部 17 种潜影盒（普通潜影盒 + 16 种染色潜影盒）。
[*]打开时会尊重潜影盒的自定义名字：给潜影盒改过名，界面标题就用你起的名字；没改过则用配置里的 gui-title。
3. 与原版操作不冲突
[*]右键方块默认不拦截，原版放置潜影盒的行为完全保留。
[*]只在主手触发的场景生效，副手不影响。
[*]背包内右键只在指定场景拦截，其余点击一律放行，不干扰正常整理背包。
[*]打开与关闭都带原版潜影盒音效（block.shulker_box.open / .close），音量与音高可调，也可以设为 NONE 彻底静音。
[*]界面在下一个游戏刻才弹出，避开原版右键事件的处理时机，不会出现界面被立刻关掉或与原版动作打架的情况。
4. 打开冷却，防连点误触
[*]cooldown-ms（默认 500，即 0.5 秒）内重复右键不会重复开箱，只提示「冷却中… 请稍后」。
[*]避免玩家快速连点导致界面闪动、或与原版动作叠加。
5. 防盒套盒（潜影盒套潜影盒）
[*]prevent-shulker-in-shulker（默认开启）会拦住「把潜影盒塞进正在打开的潜影盒里」的全部四条途径：
[*]光标拿着潜影盒点进打开的盒子；
[*]Shift 点击把自己背包里的潜影盒快速移进打开的盒子；
[*]用数字键把快捷栏的潜影盒换进打开的盒子；
[*]用副手交换把潜影盒换进打开的盒子。
[*]命中时直接拦截并提示「不能将潜影盒放入潜影盒内！」。
[*]这一条能有效避免「潜影盒套娃」带来的物品丢失纠纷 —— 也是很多服主最在意的一点。
6. 打开期间禁止丢弃
[*]正在打开状态下的那个潜影盒无法被丢出（Q 键 / 拖出界面都会拦住），提示「请先关闭潜影盒再丢弃！」。
[*]目的是防止「丢出去 → 内容无处写回」造成的内容丢失。
7. 世界黑名单
[*]disabled-worlds 里列出的世界里，打开相关的逻辑完全不介入：右键不会被拦截、不会打开界面、不会发拦截提示，全部走原版。
[*]适合在副本、竞技场、活动地图等不想让玩家原地开背包的维度单独关掉。
8. ActionBar 操作提示（自带新手引导）
[*]玩家切到手持潜影盒的快捷栏格子、或进服时主手拿着潜影盒，屏幕下方会显示一行提示（默认「右键空气打开潜影盒」）。
[*]提示在 actionbar-duration（默认 1 秒）内每秒刷新一次，随客户端自身的淡出节奏显示；玩家一放下潜影盒就立即停止刷新，很快淡出，不刷屏。
[*]不需要写教程公告，玩家拿到潜影盒自己就知道能右键打开。
9. 管理员指令：/rpts list
[*]一条指令列出当前所有正在使用快捷潜影盒的玩家（含 UUID 前 8 位），排障时用来确认「是谁开着盒子」很方便。
10. 完全适配 Folia
[*]已声明 folia-supported: true。
[*]打开界面、ActionBar 刷新等涉及玩家状态的操作，全部通过 player.getScheduler() 调度到玩家自己的区域线程执行，不在错误线程里触碰玩家数据。
[*]ActionBar 用 runAtFixedRate 按玩家区域调度，跨区域不做任何实体操作。
支持版本与环境
项目说明
Minecraft 版本1.21 ~ 26.2（插件 api-version 为 1.21）
实机验证1.21.4 + Folia（本版已在该环境完成启动、加载与部署验证）
服务端核心Paper、Folia（已声明 folia-supported: true）
Java 运行环境Java 21 及以上
不支持1.20.x 及以下（api-version 为 1.21，低版本核心会拒绝加载）
外部依赖无。不依赖经济、数据库或任何其它插件
本版核心逻辑只用到了 1.21 起就存在的稳定 API（Registry.SOUNDS、player.getScheduler()、PersistentDataContainer 等），并对「老核心没有 Registry.SOUNDS」做了兜底降级（自动静音而不是报错）。若你在其它版本上遇到问题，欢迎到交流群反馈。
目标用户
[*]生存服 / 生电服服主 —— 玩家随手掏材料、整理战利品时少掉一整套放置与破坏操作，同时世界里的方块数量不会因为开箱而变化。
[*]在意物品纠纷的服主 —— 盒套盒防护 + 丢出拦截，把最容易扯皮的两种操作直接堵住。
[*]正在使用 Folia 核心的服主 —— 涉及玩家状态的操作全部按区域线程调度，Folia 下不会因跨线程访问报错。
[*]希望行为完全可控的服主 —— 四种打开场景、世界黑名单、冷却时长、音效、全部提示文案都能改，不需要的功能关掉就是原版行为。
是否付费完全免费。 不需要授权、不需要联网校验，下载即用。
获取作者帮助
途径内容
交流群QQ 群 1124248111
作者 QQ2221899680
游戏内输入 /rpts help 查看指令与说明（这条指令不需要权限）
使用教程安装
[*]将 RptShulkerBox-1.0.0.jar 放入服务端 plugins/ 目录。
[*]重启服务端，首次启动会生成 plugins/RptShulkerBox/config.yml。
[*]按需修改 config.yml 后，游戏内执行 /rpts reload 即可生效，不需要重启服务端。
指令列表
指令权限说明
/rpts help无需权限显示指令帮助与联系方式
/rpts reloadrpts.admin重载 config.yml
/rpts listrpts.admin列出当前正在使用快捷潜影盒的玩家
主指令为 /rpts，别名 /rptshulkerbox、/rptshulker、/rptbox。
直接输入 /rpts（不带参数）等同于 /rpts help。
控制台也可以执行 /rpts、/rpts help、/rpts reload、/rpts list。
权限节点
权限默认值说明
rpts.use所有玩家使用快捷潜影盒（右键打开）
rpts.admin仅 OP重载配置 / 查看使用中的玩家
help 不需要任何权限，方便普通玩家看到交流群与作者联系方式。
主要配置项（config.yml）打开场景开关
配置项默认值说明
allow-in-inventorytrue在玩家自己的背包 / 合成界面里右键潜影盒时打开
allow-interact-airtrue手持潜影盒右键空气时打开
allow-interact-blockfalse手持潜影盒右键普通方块时打开（开启后右键方块不再放置潜影盒）
allow-in-other-guifalse在第三方插件 GUI（商店、菜单）里右键潜影盒时打开
cooldown-ms500两次打开之间的冷却时间（毫秒）
disabled-worlds不启用本插件的世界名单，请改成你自己的世界名，用不到就留空 []
安全与外观
配置项默认值说明
prevent-shulker-in-shulkertrue禁止把潜影盒放进正在打开的潜影盒内
gui-title&f潜影盒容器界面标题（潜影盒自带自定义名字时优先用名字）
actionbar-enabledtrue是否显示手持提示
actionbar-duration1提示持续秒数
actionbar-message&e右键空气打开潜影盒提示内容
open-sound / close-soundblock.shulker_box.open / .close开 / 关音效，填 NONE 表示静音
open-volume / open-pitch1.0 / 1.0开箱音量与音高
close-volume / close-pitch1.0 / 1.0关箱音量与音高
提示文案
messages: 段下的所有提示（冷却中、无权限、请先关闭再丢弃、重载成功、不能在容器内使用、不能盒套盒……）都能自定义，支持 & 颜色代码。
常见问题
[*]右键没反应？ 按顺序确认四件事：① 是不是主手拿着潜影盒；② 右键的是空气吗（右键方块默认不触发，除非你把 allow-interact-block 打开了）；③ 有没有开着箱子/末影箱等容器界面（在容器里不触发）；④ 当前世界是不是被写进了 disabled-worlds。
[*]想摆出来用怎么办？ 直接右键方块就是原版放置，插件默认不插手。
[*]会不会把方块放到地上？ 不会。触发快捷打开时原版放置动作会被拦截，世界里不会多出方块。
[*]提示「不能在容器或末影箱内使用快捷潜影盒」？ 你正开着箱子或别的容器界面。请先关掉容器，或把自己的背包（E 键）作为当前界面再右键潜影盒。
[*]为什么不能把潜影盒放进打开的盒子里？ 这是 prevent-shulker-in-shulker 的默认行为，防止盒套盒造成物品纠纷。确实需要就把它设为 false。
[*]关了界面东西还在吗？ 在。关闭界面会把内容写回该潜影盒。唯一要求是打开期间不要把这个潜影盒处理掉 —— 插件已经拦住了「丢出」和「塞进盒子」，正常操作不会丢。
[*]改了 config.yml 为什么不生效？ 执行 /rpts reload（需要 rpts.admin）。
[*]普通玩家能自己关掉这个功能吗？ 本插件不提供玩家自助开关，是否启用由服主通过配置与 rpts.use 权限统一控制。若只想给部分玩家开放，把 rpts.use 交给权限组即可。
[*]disabled-worlds 里那两个世界是什么？ 是默认占位值（disabled_world_1 / disabled_world_2），通常并不存在，所以默认实际不屏蔽任何世界。请改成你的世界名，用不到就填 []。
声明
[*]本插件为原创作品，保留所有权利，默认不允许转载与整合。如需转载或整合进服务端整合包，请先通过上方交流群或作者 QQ 联系获取授权。
[*]本插件未使用任何混淆手段，欢迎安全审查。
[*]本插件不含任何后门、病毒或远程控制代码，不收集任何玩家数据。
页: [1]