Ez Chest Shop - 史上最简易玩家商店插件

EzChestShop (ECS) 是一款为玩家和服务器管理员设计的箱子商店插件，它易于使用和构建，并拥有直观的图形界面。本插件旨在为多人游戏提供比传统牌子商店更友好、更强大的交易体验。

💡重要须知

• 插件状态: 项目已转为非活跃状态，更多信息请加入 Discord 服务器。
• 支持版本: 仅支持 1.16.5, 1.17.2, 1.18.2, 1.19.4, 1.20.4。不支持 1.16 以下版本。
• 警告: 请勿使用 Plugman、Plugwoman 等插件管理工具加载或重载本插件。

🎮核心特性

• 高性能: 专为超过150名玩家的大型服务器优化。
• 全异步: 异步生成悬浮字和物品，不占用服务器主线程。
• 高度兼容: 兼容 WorldGuard、Vault 及任何使用 Vault API 的经济插件。
• 数据安全: 支持 SQLite 和 MySQL，服务器崩溃也不会丢失数据。
• 全面自定义: 几乎所有内容都可配置。
• 物品无限制: 可以出售或购买任何物品，包括来自其他插件（如 Slimefun）的物品。
• 容器支持: 支持箱子、陷阱箱、木桶和潜影盒作为商店容器。
• 红石集成: 支持漏斗和发射器。
• 管理员商店: 可创建由服务器控制的商店。
• 权限系统: 可限制玩家创建商店的数量。
• 世界保护兼容: 兼容几乎所有领地或区域保护插件。
• 开发者API: 提供部分事件API供开发者使用。

特色功能

• 图形界面编辑器: 所有操作都可通过游戏内GUI完成。
• 三种视图模式: 管理员视图、店主视图、买家/卖家视图。
• 悬浮字距离系统: 可开关，只在玩家靠近时显示悬浮字。
• 可旋转悬浮字: 悬浮字可显示在容器的不同方向（北、南、东、西）。
• 商店设置复制粘贴: 使用 /ecs settings copy|paste 快速复制商店配置。
• 自定义交易数量: 支持自定义数量的购买和出售。
• 潜影盒商店可移动: 放置的潜影盒商店可以被拾起并重新放置。
• 收益查看命令: 玩家可轻松查看自己所有商店的收益信息。
• 类HTML悬浮字配置: 提供类似HTML标签的灵活配置方式，用于控制悬浮字显示逻辑。

🔧安装与依赖

安装步骤

• 下载插件 jar 文件。
• 将其放入服务器的 plugins 文件夹。
• 下载 Vault 和一个经济插件（如 EssentialsX）并放入 plugins 文件夹。
• 启动服务器。

依赖项

• Vault: 如果希望使用基于经验的经济系统，则非必需。
• 经济插件: 需要一个使用 Vault API 处理经济系统的插件（如 EssentialsX）。

❓如何使用

创建商店（玩家）

• 手持你想要出售/收购的物品。
• 看着一个箱子（或支持的容器）。
• 执行命令 /ecs create <收购价> <出售价>。

- 例如：`/ecs create 1000 0` 创建一个只收购不出售的商店。

- 例如：`/ecs create 0 500` 创建一个只出售不收购的商店。

常用玩家命令

• /ecs 或 /cs 或 /ezchestshop: 查看帮助（无需权限）。
• /ecs create <buy> <sell>: 创建商店。
• /ecs remove: 移除你正在查看的商店。
• /ecs settings [copy|paste|admins|toggle-buying|toggle-selling|toggle-message|toggle-shared-income]: 管理商店设置。
• /cp 或 /checkprofits: 检查你所有商店的收支情况（需要权限 ecs.checkprofits）。

管理员命令与权限

• /ecsadmin: 查看管理员帮助。
• /ecsadmin remove: 移除商店（权限：ecs.admin.remove）。
• /ecsadmin reload: 重载插件配置（权限：ecs.admin.reload）。
• /ecsadmin create <buy> <sell>: 创建管理员商店（权限：ecs.admin.create）。
• ecs.admin.view: 允许以管理员视图查看任何商店，并拥有完全访问权限。
• ecs.admin: 拥有插件所有管理权限。

✨配置与权限

权限节点

• 限制商店数量:

1.  在 `config.yml` 中设置 `permissions: create-shops: true`。

2.  玩家需要权限 `ecs.shops.limit.X`，其中 `X` 是允许创建的最大商店数量。

• 自定义悬浮字行数: ecs.shops.hologram.messages.lines.X，其中 X 是允许的行数。

WorldGuard 标志

• ecs-create-shop: 允许创建玩家商店。
• ecs-create-admin-shop: 允许创建管理员商店。
• ecs-remove-shop: 允许移除玩家商店。
• ecs-remove-admin-shop: 允许移除管理员商店。
• ecs-use-shop: 允许使用玩家商店。
• ecs-use-admin-shop: 允许使用管理员商店。

⭐配置文件概览

主要配置文件为 config.yml 和语言文件（如 Locale_EN.yml）。

• 重要提示: 配置文件中请使用空格缩进，切勿使用 TAB 键，否则可能导致插件出错。
• 语言: 首次加载后，配置文件夹中会提供德语、西班牙语、波斯语和中文等其他语言文件。
• 核心配置项:

- `shops.hologram`: 控制悬浮字的显示、结构、消失延迟和旋转。

- `shops.distance`: 控制基于距离的悬浮字渲染系统。

- `shops.container`: 定义哪些容器类型可用作商店。

- `settings.defaults`: 定义创建商店时的默认设置。

- `economy.server-currency`: 定义货币符号，用于消息和悬浮字。

🔧链接与支持

• Discord 服务器: 获取最新信息、帮助和支持。
• Wiki: 查看详细文档。
• Bug 反馈/建议: 请通过 Discord 或 Telegram 联系作者，请勿直接在本页面评论区发布。
• 捐赠: 如果你喜欢这个插件，可以通过提供的 PayPal 链接支持开发者。

---

免责声明: 本插件已在一个拥有大量生存玩家的网络中进行过使用和测试，稳定可靠。如果在使用中发现任何问题，请先联系开发者获取帮助。

EzChestShop 是一个功能强大的 Minecraft 插件，它允许玩家通过箱子轻松创建和管理商店。它提供了直观的界面、丰富的功能和高度的可定制性，非常适合服务器经济系统。

💡核心功能

• 简单易用的商店创建：手持物品对箱子点击即可创建商店。
• 多种商店类型：支持购买、出售以及买卖一体的商店。
• 经济系统支持：原生支持 Vault 经济插件，兼容 EssentialsX、CMI 等。
• 管理员商店：可以创建无限库存的服务器商店。
• 高度可配置：价格、消息、外观等几乎所有内容均可自定义。
• 多语言支持：内置多种语言，包括简体中文。
• 丰富的视觉效果：支持粒子效果、全息文字和声音提示。
• 安全可靠：提供商店保护、交易日志和防爆功能。
• 扩展 API：为开发者提供完整的 API 以创建扩展。

🎮命令与权限

主要命令

• /ecs - 显示插件帮助信息。
• /ecs help - 显示详细的命令帮助。
• /ecs reload - 重载插件配置和语言文件。
• /ecs debug - 切换调试模式。
• /ecs migrate - 从旧版 ChestShop 迁移数据。
• /ecs give <物品名> [数量] [玩家] - 给予特殊物品（如移除工具）。
• /ecs log <玩家名> - 查看指定玩家的交易记录。
• /chestshop - 玩家创建和管理商店的主要命令别名。

常用权限节点

• ezchestshop.create - 允许创建商店。
• ezchestshop.create.admin - 允许创建管理员商店。
• ezchestshop.destroy.others - 允许移除他人的商店。
• ezchestshop.bypass - 绕过商店保护（如打开他人商店的箱子）。
• ezchestshop.removetool - 允许使用移除工具。
• ezchestshop.log - 允许使用交易日志命令。
• ezchestshop.reload - 允许重载插件。
• ezchestshop.debug - 允许使用调试命令。

🔧快速开始

创建商店

• 手持你想要出售或收购的物品。
• 对准一个空箱子（或已有商店的箱子）点击。
• 在聊天栏中输入物品的单价。
• 若要创建出售商店，输入正数价格（如 10）。
• 若要创建收购商店，输入负数价格（如 -5）。
• 若要创建买卖商店，输入两个用空格隔开的价格（如 10 -5）。
• 商店创建成功！箱子内放置的物品即为库存。

使用商店

• 作为顾客购买：左键点击商店牌子以购买一个物品。按住 Shift 左键点击购买一组物品。
• 作为顾客出售：右键点击商店牌子以出售一个手持物品。按住 Shift 右键点击出售一组手持物品。
• 作为店主补充库存：将物品放入商店箱子即可。
• 作为店主取出收益：打开商店箱子，从右侧栏取出金钱物品（如金锭，代表服务器货币）。

移除商店

• 破坏商店的箱子或牌子。
• 使用移除工具（通过 /ecs give removetool 获取）左键点击商店牌子。
• 拥有权限的玩家可直接破坏。

✨配置与自定义

插件配置非常灵活，主要配置文件如下

• config.yml - 主配置文件，控制核心功能、经济、视觉效果等。
• messages.yml - 所有插件发送的消息文本，支持多语言。
• gui.yml - 自定义商店管理界面的外观。
• holograms.yml - 配置全息显示文本的内容和样式。
• particles.yml - 配置创建商店时的粒子效果。
• signs.yml - 自定义商店牌子的样式和颜色。

常见配置调整

• 在 config.yml 中启用 use-decimals 以支持小数价格。
• 在 config.yml 中修改 currency-symbol 以更改货币符号。
• 在 messages.yml 中切换 locale 为 zh_CN 使用简体中文。
• 在 signs.yml 中自定义各类型商店牌子的颜色和格式。

❓常见问题

商店创建失败？

• 确保箱子未被其他插件保护。
• 确保你手持了有效的物品。
• 检查你是否拥有 ezchestshop.create 权限。
• 确认输入的价格格式正确。

交易时没有金钱变化？

• 确保服务器安装了 Vault 和一个兼容的经济插件（如 EssentialsX）。
• 确保经济插件运行正常，玩家有足够的金钱。

如何备份商店数据？

• 商店数据保存在 /plugins/EzChestShop/database.db（如果使用 SQLite）。
• 定期备份此文件即可。

如何更新插件？

• 从官方页面下载最新版本的 EzChestShop.jar。
• 停止服务器。
• 替换旧版本的插件文件。
• 启动服务器，插件通常会自动迁移数据。

⭐依赖与兼容性

必需依赖

• Vault - 用于连接经济、权限和聊天插件。

推荐经济插件

• EssentialsX
• CMI
• 或其他任何通过 Vault 提供经济系统的插件。

可选依赖（用于增强功能）

• ProtocolLib - 启用更高级的视觉效果（如自定义牌子）所必需。
• HolographicDisplays 或 DecentHolograms - 用于显示全息文本。
• PlaceholderAPI - 在牌子或消息中使用变量。

支持的 Minecraft 版本

• 插件支持 Spigot、Paper 及其衍生服务端。
• 兼容 Minecraft 1.16.x 至 1.20.x 版本（请查看具体发布版本说明）。

---

**资源链接**

• SpigotMC 发布页面
• GitHub 源代码与 Wiki
• Discord 支持频道 (链接请以实际 Wiki 为准)