ChestShop - 箱子商店

ChestShop 是一款简单而强大的商店系统，通过告示牌与箱子即可创建实体商店，最初由 Acrobot 开发。它让创建商店变得前所未有的简单，并自带商店保护和防卡顿保护等功能，让你无需再为服务器的经济系统操心。

💡核心特性

• “开箱即用”：通过 Vault 支持几乎所有经济插件（3.9.2 以上版本也支持使用 Reserve API 的经济插件）。
• 商店保护：防止他人破坏或窃取商店物品。
• 防卡顿保护：优化性能，减少对服务器的影响。
• 匿名统计：默认向 mcstats.org 和 bstats.org 提交匿名服务器数据（如玩家数、插件版本）。你可以在 PluginMetrics/config.yml 和 bstats/config.yml 中关闭此功能。
• 自动更新：支持自动更新，可在配置文件中关闭。

🔧使用商店

购买与出售

• 右键点击告示牌：购买物品。
• 左键点击告示牌：出售物品。

（点击方式可在配置文件中修改。）

如何创建玩家商店

• 在地上放置一个箱子。
• 在箱子旁（例如上方）放置一个告示牌。
• 在告示牌上按行写入以下信息：
• 第一行：留空。插件会自动填入你的名字（若拥有 ChestShop.admin 权限，可输入其他玩家名字创建商店）。
• 第二行：交易物品的数量。
• 第三行：收购价与出售价的组合。价格前需加标识符（如 B 表示玩家购买价，S 表示玩家出售价），价格间用冒号 : 分隔。例如：

- `B 5:5 S`

- `B 5`

- `S free`

• 第四行：物品的 ID/名称。可写入 ?，插件会自动从箱子中读取物品；或手持物品点击告示牌。也可直接输入物品名称（使用 /iteminfo 可查看手持物品的名称）。

创建无限物品的管理员商店

你需要拥有 ChestShop.admin 权限或是 OP。创建时，在告示牌第一行写入“Admin Shop”（可在 config.yml 中配置）。管理员商店无需箱子即可拥有无限物品（若放置箱子，则会使用箱内物品而非无限模式。可通过 FORCE_UNLIMITED_ADMIN_SHOP 配置项强制设为无限）。

🎮命令列表

• /iteminfo – 查看手中物品的信息。
• /iteminfo <id/名称> – 查看指定 ID 或名称的物品信息。
• /shopinfo – 查看所注视商店的信息。
• /csgive <物品代码> [数量] [玩家] – 将具有唯一 ChestShop 代码的物品给予玩家。
• /cstoggle – 切换购买/出售通知消息的显示。
• /chestshop version – 显示 ChestShop 版本。
• /chestshop reload – 重载 ChestShop 配置和翻译消息（部分功能可能不会重载）。
• /csaccess – 切换在拥有管理员/访问权限时是否可在商店买卖（通常这些权限会忽略买卖操作）。

✨权限节点

ChestShop.shop.*

包含商店创建与买卖的所有权限

• ChestShop.shop.create.* – 创建所有类型的商店。
• ChestShop.shop.create.<物品id> – 创建特定物品类型的商店。
• ChestShop.shop.create.buy.<物品id> – 创建特定物品的收购商店。
• ChestShop.shop.create.sell.<物品id> – 创建特定物品的出售商店。
• ChestShop.shop.buy – 从商店购买任何物品。
• ChestShop.shop.buy.<物品id> – 仅从商店购买特定物品。
• ChestShop.shop.sell – 向商店出售任何物品。
• ChestShop.shop.sell.<物品id> – 仅向商店出售特定物品。

其他主要权限

• ChestShop.mod – 打开任何商店的箱子。
• ChestShop.admin – 打开任何商店箱子、销毁商店、创建（管理员）商店。

完整权限列表请查阅相关文档。

⭐配置与翻译

配置文件

• config.yml：包含插件的主要设置，并附有解释性注释。
• priceLimits.yml：用于设置物品的最低/最高价格限制。
• discounts.yml：用于设置管理员商店的折扣。

消息翻译

最新版本内置了多语言翻译。消息文件位于 languages 文件夹中，支持按客户端语言设置。它们使用 MineDown 语法以支持完整的组件功能。

如果你想帮助翻译，请参与 ChestShop Crowdin 项目。

❓兼容性与模块

兼容的插件

ChestShop 直接挂钩以下插件以提供额外功能：

• 登录插件：AuthMe 及其分支（如 AuthMe Reloaded）。
• 领地保护：WorldGuard、Residence。
• 锁箱插件：LWC 及其分支（如 LWCX、Modern-LWC）、Lockette、LockettePro、Deadbolt、SimpleChestLock。
• 物品显示：OddItem、Heroes、ShowItem。
• 经济插件：所有与 Vault 或 Reserve 兼容的经济插件。

附加模块

• ChestShop LegacyIds：允许在告示牌上使用数字及 1.13 之前的旧版字符串 ID。
• Notification module：用于与 Notifications 插件配合。
• Towny module：用于与 Towny 插件配合。
• ChestShop Notifier：记录所有交易，即使玩家离线（由维护者开发）。
• ChestShopTools：附魔信息告示牌与空商店通知器（由维护者开发）。
• Adda：箱子上的物品显示图标、商店交易限制、Discord 警报、每玩家商店限制（用户制作）。
• ChestIcon：为箱子添加图标，类似 Showcase 插件（用户制作，新版可能已失效）。
• Libelula Auto Shop：使用 Essentials 轻松创建管理员商店（用户制作）。
• ChestShopLimiter+：限制每玩家的商店数量（用户制作，已弃用）。
• ChestShopListing：将商店和交易存入 SQL；添加相关功能，包括游戏内搜索（用户制作）。
• ChestShopConfirmation：购买前确认界面（用户制作，已弃用）。
• ChestShopRefund：允许用户退款意外购买（用户制作）。
• SearchChestShop：搜索出售特定物品的商店（用户制作）。
• BoltChestShop：添加对 Bolt 容器保护的支持（由 Bolt 作者制作）。

🔧更多信息

许可证

ChestShop 的源代码及发布的插件文件均遵循 GNU 宽通用公共许可证 2.1 条款授权。

获取帮助与反馈

• 常见问题：请查阅常见问题部分。
• 用户教程：有用户制作的教程可供参考。
• 报告问题或提出建议：
• 在此提交工单。
• 若有 GitHub 账户及编程知识，可直接在 GitHub 上提交问题（也可通过 Issuehunt 资助）。
• 需要一般帮助？请在评论区留言或加入 Spigot IRC 网络的 #chestshop 频道（irc.spi.gt，网页聊天）。
• 社区交流：
• IRC 聊天：#chestshop on irc.esper.net
• Discord 频道：邀请链接（加入此链接会自动订阅重要更新通知，若不需要请使用此邀请）。

支持开发

如果 ChestShop 帮助了你或你的服务器，并想以更实际的方式感谢开发团队：

• 可以考虑捐赠或请 Phoenix616 喝杯啤酒。
• Acrobot 发布了他的首款 Android 游戏，欢迎试玩。
• 也欢迎关注 Acrobot 朋友的音乐作品。

ChestShop 3 插件文档

ChestShop 3 是一个功能强大的商店插件，允许玩家通过箱子创建和管理商店。它支持多种经济插件，提供丰富的权限控制和自定义选项，是服务器经济系统的理想选择。

💡重要链接

• 官方 Wiki: 获取最全面的安装、配置和使用指南。
• 常见问题解答 (FAQ): 快速查找常见问题的解决方案。
• 权限列表: 查看所有可用的权限节点及其说明。
• 玩家自制教程: 社区玩家分享的使用心得和技巧。
• 开发者 API: 为插件开发者提供的集成接口文档。
• GitHub 源代码: 插件开源代码 (采用 LGPL-2.1 许可证)。
• 语言文件语法: 了解如何自定义插件的显示文本。

🎮核心功能

• 箱子商店: 玩家可以通过在箱子上放置告示牌来创建商店。
• 多经济支持: 原生支持 EssentialsEco、Vault 等多种经济系统。
• 高度可配置: 可调整税率、费用、商店保护范围等多项参数。
• 商店保护: 自动保护商店物品，防止被偷窃或破坏。
• 管理工具: 提供强大的管理员命令，用于管理、审核和修复商店。
• 多语言支持: 通过编辑语言文件，轻松实现界面本地化。
• 商店日志: 记录所有交易，便于查询和审计。
• 租赁商店: 支持设置商店租赁期限，到期后自动移除。

🔧基础使用指南

创建商店

• 放置一个箱子。
• 在箱子相邻的方块上放置一个告示牌。
• 在告示牌上按以下格式输入信息：

第一行: [商店类型]
第二行: 商品数量
第三行: 单价
第四行: 货币/物品名 (可选)

• 商店类型可以是 [Buy] (收购)、[Sell] (出售) 或 [Trade] (交易)。
• 例如，一个出售 64 个石头，每个单价 10 元的商店：[Sell]、64、10。

使用商店

• 购买: 对出售 ([Sell]) 商店右键点击告示牌即可按单价购买指定数量的物品。
• 出售: 对收购 ([Buy]) 商店右键点击告示牌即可按单价出售你手中的物品。
• 交易: 对交易 ([Trade]) 商店右键点击，用手中的物品换取商店箱子内的物品。

❓常见问题 (FAQ)

• 如何防止商店被破坏？
• 插件默认会保护商店。确保安装了 WorldGuard 等领地保护插件以实现区域保护，并正确配置 allowed-region-flag。
• 支持哪些经济插件？
• 支持 Vault 及通过 Vault 兼容的经济插件 (如 EssentialsEco、CMI、PlayerPoints 等)。也支持内置的 EssentialsEco 直接连接。
• 商店不工作怎么办？
• 检查经济插件是否正常运行，玩家是否有足够的金钱。
• 检查箱子是否被其他插件保护或锁住。
• 使用 /csadmin reload 重载配置，并检查后台错误信息。
• 如何翻译插件信息？
• 编辑 plugins/ChestShop/lang.yml 文件。请参考“语言文件语法”了解编写规则。

⭐注意事项

• 请确保在安装 ChestShop 前已安装并正确配置好经济插件。
• 定期备份你的 shops.yml 和 config.yml 文件。
• 使用 WorldGuard 等保护插件可以更好地保护商店区域。
• 管理员可以使用 /csadmin 命令来清理无效商店、修复错误等。