eShulkerBox - 便捷潜影盒交互插件

eShulkerBox 是一款免费、现代且高度优化的插件，来自 ePlugins 系列。它允许玩家无需放置潜影盒即可直接打开，支持创建各种自定义潜影盒或使用原版潜影盒，所有内容均可完全自定义。

💡核心特性

• 允许玩家无需放置即可打开潜影盒。
• 所有提示信息均可完全自定义。
• 每个潜影盒的名称都支持自定义（支持 PAPI 变量）。
• 可以创建具有独立设置的各种类型潜影盒。
• 可编辑潜影盒打开的冷却时间（包含绕过权限）。
• 可自定义打开和关闭音效。
• 先进且最新的防复制与漏洞利用保护。
• 每个音效的音高和音量也可编辑。
• 打开功能同样适用于玩家背包中的末影箱（可禁用）。
• 支持为潜影盒设置自定义合成配方（可在配置中禁用此功能）。
• 可以与好友分享你的潜影盒视图（通过右键点击他们）。
• 移除插件后，所有潜影盒及其内容物都将被保留。
• 可以禁用特定世界，使潜影盒功能在该世界失效。
• 支持自定义模型数据（Custom Model Data）。
• 支持 RGB 颜色及渐变系统。

🎮命令列表

• /shulkerbox - 显示一条包含命令使用说明的信息。
• /shulkerbox help - 发送所有可用命令的列表。
• /shulkerbox give <box_id> - 将一个自定义潜影盒给予自己。
• /shulkerbox give <box_id> <player> - 将一个自定义潜影盒给予指定玩家。
• /shulkerbox list - 在聊天栏显示所有自定义潜影盒的 ID 列表。
• /shulkerbox edit <box_id> - 为指定潜影盒打开编辑器。
• /shulkerbox create <box_id> - 为新的自定义潜影盒打开编辑器。
• /shulkerbox menu - 打开潜影盒编辑器菜单，可在此创建自定义潜影盒。
• /shulkerbox about - 显示插件的基本信息。
• /shulkerbox reload - 重载插件。

✨权限节点

• eshulkerbox.open - 允许玩家无需放置即可打开潜影盒视图（默认开启）。
• eshulkerbox.open.<box_id> - 允许玩家打开指定 ID 的潜影盒视图。
• eshulkerbox.enderopen - 允许玩家在手持末影箱时打开其视图。
• eshulkerbox.give - 允许玩家向其他玩家给予自定义潜影盒。
• eshulkerbox.about - 允许查看插件信息。
• eshulkerbox.bypass.othersplugins - 允许玩家在背包中与潜影盒交互，即使其他插件阻止了物品交互。

🔧配置摘要

以下为配置文件 config.yml 中的部分关键设置：

常规设置

• enabled: true - 插件是否启用。
• inventory-title-as-item-name: true - 是否使用物品自定义名称作为打开的潜影盒界面标题。
• clickable-read-only-shulker-cross-others-plugin-inventories: false - 是否允许在其他插件的 GUI 中打开只读潜影盒（可能引起兼容性问题）。
• disable-chat-and-commands-in-shulkerbox: true - 玩家在潜影盒界面内时，是否屏蔽其聊天和命令。
• allow-custom-shulker-boxes: true - 是否启用自定义潜影盒功能。
• default-require-permission-to-open: false - 打开潜影盒是否默认需要权限。
• default-cooldown: 1000 - 默认冷却时间（毫秒）。
• openable-enderchest-by-interact: false - 是否允许通过交互打开末影箱。
• disabled-worlds: - 在此列表中的世界，插件功能将被禁用。
• disabled-regions: - 在此列表中的区域（需配合区域插件），插件功能将被禁用。

音效设置

• default-open-sound: "BLOCK_SHULKER_BOX_OPEN" - 默认打开音效，设为 "NONE" 可禁用。
• default-close-sound: "BLOCK_SHULKER_BOX_CLOSE" - 默认关闭音效，设为 "NONE" 可禁用。
• default-open-pitch: 1.0 - 默认打开音效音高。
• default-close-pitch: 1.0 - 默认关闭音效音高。
• default-open-volume: 1.0 - 默认打开音效音量。
• default-close-volume: 1.0 - 默认关闭音效音量。

⭐安装与使用

• 将 eShulkerBox 插件拖入服务器的 plugins 文件夹。
• 重启服务器或使用 /reload 命令重载。
• 根据需求编辑 config.yml 和 messages.yml 配置文件。
• 使用 /shulkerbox reload 重载插件。
• 开始使用！

❓兼容性与支持

• 兼容平台：支持 Spigot、Paper、Folia 及其他主流服务端核心。
• 支持与反馈：如需帮助或有建议，请加入我们的 Discord 社区。我们感谢每一次下载、反馈和评分！

简介

EnderShulkerBox 是一个功能强大的 Minecraft 插件，它允许玩家像使用末影箱一样，随时随地打开潜影盒。无论潜影盒在你的物品栏、末影箱还是副手，只需一个简单的命令，即可直接访问其内容，极大地提升了游戏便利性。

💡功能特性

• 随时随地访问：无需放置潜影盒，即可直接打开。
• 多种存储位置：支持打开位于玩家物品栏、末影箱或副手中的潜影盒。
• 智能匹配：当玩家手持潜影盒时，插件会自动打开它；若未手持，则会打开物品栏中的第一个潜影盒。
• 权限控制：提供详细的权限节点，方便管理员进行管理。
• 多版本支持：支持 1.13 至 1.20 的 Minecraft 版本。
• 多语言支持：内置中文与英文语言文件。
• 配置灵活：可通过配置文件自定义消息和插件行为。

🎮命令与权限

主命令

• /eshulkerbox 或 /esb

- 描述：打开你物品栏或副手中的潜影盒。

- 权限：`eshulkerbox.use`

- 别名：`/enderShulkerBox`, `/endershulkerbox`, `/eshulk`, `/eshulker`

管理员命令

• /eshulkerbox reload 或 /esb reload

- 描述：重载插件的配置和语言文件。

- 权限：`eshulkerbox.reload`

权限节点列表

• eshulkerbox.use - 允许使用 /eshulkerbox 命令。
• eshulkerbox.reload - 允许使用重载命令。
• eshulkerbox.bypasscooldown - 允许绕过命令冷却时间。
• eshulkerbox.bypassdisabledworld - 允许在禁用世界中打开潜影盒。

🔧安装与使用

安装步骤

• 确保服务器已安装 Java 17 或更高版本。
• 将下载的 EnderShulkerBox-x.x.jar 文件放入服务器的 plugins 文件夹。
• 重启或重载服务器。
• 插件首次运行后，会在 plugins/EnderShulkerBox 目录下生成配置文件。

基本使用

• 将一个潜影盒放入你的物品栏或副手。
• 输入命令 /esb。
• 潜影盒的图形用户界面将会打开，你可以像平常一样存取物品。

使用示例

• 如果你手持一个潜影盒，输入 /esb 将直接打开它。
• 如果你没有手持潜影盒，输入 /esb 将打开你物品栏中的第一个潜影盒。

✨配置与自定义

配置文件 (config.yml) 和语言文件 (zh_CN.yml, en_US.yml) 位于 plugins/EnderShulkerBox/ 目录下。

主要配置项

• cooldown: 设置命令使用冷却时间（秒）。设置为 0 则无冷却。
• disabled-worlds: 在此列表中的世界将无法使用该插件功能。
• open-enderchest-first: 当设置为 true 且物品栏无潜影盒时，会尝试优先打开末影箱中的第一个潜影盒。
• messages: 可以在此开关各类提示消息。

自定义消息

你可以编辑对应的语言文件来修改插件发送的所有提示信息，使其更符合服务器风格。

❓常见问题

插件支持哪些 Minecraft 版本？

• 插件支持 Minecraft 1.13, 1.14, 1.15, 1.16, 1.17, 1.18, 1.19 以及 1.20。

插件需要其他依赖吗？

• 不需要。这是一个独立插件。

为什么我无法打开潜影盒？

• 请检查你是否拥有 eshulkerbox.use 权限。
• 检查你是否处于 config.yml 中定义的禁用世界。
• 确保你的物品栏或副手中存在潜影盒。

如何更改提示语言？

• 插件会根据客户端语言自动选择。你可以在配置文件夹中编辑 zh_CN.yml（中文）或 en_US.yml（英文）来手动调整。

如何报告漏洞或提出建议？

• 请前往插件的官方页面或支持频道进行反馈。

⭐注意事项

• 请确保使用与服务器 Minecraft 版本兼容的插件版本。
• 重载配置 (/esb reload) 在大量玩家在线时进行可能会导致短暂卡顿，建议在维护时进行。
• 定期备份你的插件数据文件夹是一个好习惯。