[SKRIPT BSB] Better Shulker Boxes (NBT) - [SKRIPT BSB] 更好的潜影盒（NBT版）

厌倦了每次使用潜影盒都要先放置它吗？如果是，那就试试 Better Shulker Boxes 吧！这是一个 Skript 脚本，让你无需手动放置潜影盒，就能轻松存取其中的物品，从而节省时间和精力。此外，你还可以直接在背包中右键点击潜影盒来打开它，无需关闭物品栏界面，从而更便捷地在不同潜影盒之间移动物品。它配备了用户友好的界面。

💡前置需求

• Skript 2.10.0 或更高版本
• SkBee 3.10.0 或更高版本
• 重要提示：如果你仍在使用 1.20.4 或更早的 Minecraft 版本，请继续使用本插件的 7.3 版本。

🎮核心功能

• 轻松访问：只需右键点击即可打开任何潜影盒，让物品管理变得轻而易举。
• 背包内操作：直接在背包中右键点击潜影盒即可打开。
• 用户友好：脚本注释详尽，易于根据需求修改。
• 沉浸音效：享受打开和关闭潜影盒时的沉浸式音效。
• 代码可读性高：代码附带注释，增强了可读性和理解性。
• 快速更新：一旦发现任何复制漏洞，会迅速发布更新以确保安全。
• 锁定可疑潜影盒：可以锁定疑似有问题的潜影盒以防止复制，并使用 /bsbunlock 命令解锁（出于安全考虑，此命令需要管理员权限）。
• 可自定义冷却时间：可根据服务器需求调整冷却系统，提供个性化体验。

🔧扩展功能

Better Shulkers Extension

如果你希望获得以下能力，可以使用此扩展

• 拾取物品时自动存入潜影盒，无需放置潜影盒。
• 在玩家消耗物品或进行放置操作时，自动填充玩家手中的物品。

⭐配置选项

以下是脚本的主要配置选项，你可以在脚本文件中修改它们：

权限设置

• permission-required: 是否要求权限才能使用（true/false）
• permission: 打开潜影盒所需的权限节点（默认：bsb.use）
• permission-admin: 管理员使用命令解锁潜影盒所需的权限节点（默认：bsb.admin）
• permission-message: 用户缺少使用权限时的提示信息
• permission-message-admin: 用户缺少管理员权限时的提示信息
• permission-message-format: 权限提示信息的显示方式（可选：actionbar、title、message）

杂项设置

• place-shulkers: 是否允许玩家放置潜影盒（true/false）
• open-with-sneaking: 是否允许玩家通过潜行点击在背包中打开潜影盒（true/false）

冷却设置

• cooldown-enabled: 是否对打开潜影盒启用冷却（true/false）
• cooldown-duration: 冷却持续时间（例如：5 seconds）
• cooldown-bypass-permission: 绕过冷却的管理员权限节点（默认：bsb.admin）
• cooldown-message: 冷却期间尝试打开时的提示信息（可使用 %{_remaining}% 占位符显示剩余时间）
• cooldown-message-enabled: 是否启用冷却提示信息（true/false）
• cooldown-message-format: 冷却提示信息的显示方式（可选：actionbar、title、message）

音效设置

（将任何音效设置为 none 即可禁用该音效）

• sounds-open: 打开潜影盒时的音效（默认：block.shulker_box.open）
• sounds-close: 关闭潜影盒时的音效（默认：block.shulker_box.close）
• sounds-locked: 尝试打开被锁定的潜影盒时的音效（默认：block.chest.locked）
• sounds-cooldown: 冷却期间尝试打开时的音效（默认：block.chest.locked）
• sounds-permission: 缺少权限时的音效（默认：block.chest.locked）

锁定状态设置

• locked-message: 尝试打开被锁定的潜影盒时的提示信息
• locked-enabled: 是否自动锁定可疑的潜影盒（true/false）
• locked-message-enabled: 是否启用锁定提示信息（true/false）
• locked-message-format: 锁定提示信息的显示方式（可选：actionbar、title、message）
• locked-dispenser: 发射器中含有被锁定潜影盒时的提示信息（可使用 %{_amount}% 占位符显示数量）
• Locked-dropped: 尝试丢弃被锁定的潜影盒时的提示信息

锁定原因说明

以下是潜影盒被锁定的可能原因，用于内部记录

• locked-reason-1: 包含非法物品。
• locked-reason-2: 疑似复制品。
• locked-reason-3: 其他原因。

关于锁定的澄清说明：锁定机制旨在防止复制。潜影盒在打开时被锁定，在正常关闭时解锁。如果潜影盒在没有正常数据包交互的情况下被关闭，锁定状态将会保留。

❓注意事项与支持

• 许可证：你可以自由分享和修改此资源，但必须：

- 注明原始创作者

- 不得用于商业用途

• 问题反馈：如果遇到任何问题，请通过 Discord 联系 eult 或加入相关 Discord 服务器。
• 版本兼容：如果你不介意使用 skript-reflect，也可以考虑使用 lotzy skript（支持 1.12.2 版本）。
• 支持开发者：欢迎通过“Buy me a coffee”链接支持原作者。

💡简介

Better Shulker Boxes (BSB) 是一款优化潜影盒管理的插件。它允许你直接在背包中打开潜影盒，无需放置在地面上，并提供了安全的物品存取机制以防止复制漏洞。

🎮如何使用

基础操作

• 打开潜影盒：在背包界面中，直接右键点击任意潜影盒即可打开它。
• 移动物品：在打开背包时，右键点击潜影盒，你可以在不关闭背包界面的情况下，直接在潜影盒和背包之间移动物品。

锁定与解锁机制

解锁的潜影盒

• 这是普通的潜影盒，可以正常打开和存取物品。

锁定的潜影盒

• 当潜影盒被打开时，BSB 会自动将其锁定，这是一种防止物品复制的安全措施。
• 潜影盒会在正常关闭后自动解锁。
• 如果服务器在潜影盒打开时崩溃，或关闭方式异常，潜影盒可能会保持锁定状态。
• 管理员可以使用命令 /bsbunlock 来手动解锁一个被锁定的潜影盒。

🔧工作原理

BSB 通过修改潜影盒的 NBT 数据来实现其功能，这依赖于 SkBee 插件。

NBT 数据管理

• 由于 Minecraft 本身不支持为方块添加自定义 NBT 标签，BSB 借助 SkBee 实现此功能。
• SkBee 将自定义数据存储在方块 NBT 复合标签的 custom 路径下。
• 具体到 BSB，锁定状态是通过设置 BlockEntityTag;PublicBukkitValues;skbee-custom;locked 这个标签来实现的。

物品处理流程

• 创建虚拟库存：当你与背包中的潜影盒交互时，BSB 会为其创建一个虚拟的库存界面。
• 实时管理物品：你在虚拟界面中进行的任何物品存取操作，都会被 BSB 实时跟踪和管理。
• 保存物品数据：当你关闭潜影盒界面时，BSB 会将虚拟库存中的所有物品信息保存下来。
• 写入 NBT 数据：保存的物品数据会被写入到该潜影盒实体的 NBT 数据中，确保物品不丢失。
• 解锁潜影盒：数据保存完毕后，BSB 会移除锁定标签，使潜影盒恢复正常可用状态。

❓注意事项与反馈

• 本插件必须与 SkBee 插件搭配使用，否则无法运行。
• 潜影盒的锁定机制是核心安全功能，用于防止因服务器崩溃或异常操作导致的物品复制漏洞。
• 如果你喜欢这个插件，请考虑在发布页面给予评分。你的反馈对我持续开发和改进本项目有巨大的帮助。