授权转载 开源 经济 QuickShop-Hikari 6.3.0.3

[MD] 对于不方便使用 Discord 或 Github Issue Tracker 的用户，也可在 QQ 社区群 966701484 内寻求热心社区人员的帮助 [我们现在有文档了！终于！](https://quickshop-community.github.io/QuickShop-Hikari-Documents/) --- ## 功能 * 简单易用，只需点击并输入价格即可创建商店 * 支持 NBT 数据、附魔、工具耐久、药水和生物蛋 * 根据客户端语言动态切换显示语言，国际化友好 * 支持系统商店 * 支持物品黑名单和绕过权限 * 支持大箱子买卖商店 * 支持 UUID（当然） * 聊天和 GUI 中炫酷的物品预览 * 聊天控制面板，可点击修改商店设置 * 支持世界/区域保护插件，并可下载大量兼容模块 * 基于 ProtocolLib / PacketEvents 的虚拟悬浮物支持（性能更好） * 多货币支持：可使用任何支持 VaultUnlocked 的经济插件中的不同货币。默认也支持 Vault！ * 支持税收和持续费用！ * 若玩家无权限，可在帮助中隐藏命令 * 不同商店状态拥有彩色告示牌标题和清晰描述 * 支持 MiniMessage，可创建自定义炫酷消息 * 支持 H2（本地）或 MySQL（远程） * 高级事务机制，在库存/经济操作失败时自动回滚，防止玩家复制漏洞 * InventoryWrapper API 为开发者提供自定义库存能力 * 快速缓存层，在安装 ProtocolLib 的情况下可处理 1000+ 商店且无卡顿！ * 单商店权限管理。 * 商店收益分配（店主与其他玩家之间）！ * 以及更多功能！无法全部列出！ ## 安装方法 **QuickShop 需要 Minecraft 1.20+ 运行。低于 1.20 的版本不受支持** * 安装 Vault 和一个支持 Vault 的经济插件。 * 如果使用多货币，需要一个支持 VaultUnlocked 的经济插件。 * 可选安装 ProtocolLib 或 PacketEvents，可大幅提升 QuickShop 性能。 * 最近更新已不再支持 Spigot。建议切换至 Paper 或其分支以确保最佳性能。 * 下载 QuickShop jar 并放入 plugins 文件夹。 * 如有需要，下载其他兼容模块或附加组件。 * 仅安装需要的兼容模块，它们不是开箱即用，需要进行配置。 * 大多数情况下，Hikari 可自行处理区域保护，无需额外模块。 * 启动服务器即可！ --- ## 命令 注意：大多数功能可通过控制面板或交互访问，通常无需使用命令。 * **/quickshop unlimited** 将商店设置为无限或有限库存。 * **/quickshop setowner** 更改商店所有者 * **/quickshop buy** 将商店设置为收购模式 * **/quickshop sell** 将商店设置为出售模式 * **/quickshop price** 更改物品买/卖价格 * **/quickshop clean** 移除没有库存的已加载商店 * **/quickshop find** 查找最近出售以指定文本开头的物品的商店。例如：/quickshop find dia 将查找最近买/卖钻石的商店 * **/quickshop fetchmessage** 手动从数据库获取商店消息 * **/quickshop info** 显示 QuickShop 信息 * **/quickshop debug** 启用/禁用调试模式 * **/quickshop create** 使用手中物品或指定物品创建商店 * **/quickshop currency** 指定商店使用的货币 经济插件必须支持多货币功能并被 QuickShop 支持 * **/quickshop supercreate** 绕过保护检查创建商店。 * **/quickshop paste** 收集服务器的调试信息并上传到 Pastebin 不要将该链接的结果发送给你不信任的人 * **/quickshop staff** 管理商店助手。 * **/quickshop staff add** 添加助手 * **/quickshop staff del** 移除助手 * **/quickshop staff clear** 移除所有助手 * **/quickshop staff list** 列出所有助手 * **/quickshop cleanghost** 移除所有损坏商店 * **/quickshop export** 导出所有商店数据为 zip 此命令仅限控制台使用！ * **/quickshop recovery** 从 zip 文件或粘贴内容恢复商店 此命令仅限控制台使用，可能会移除/覆盖服务器上的现有商店！请先备份并测试！ * **/quickshop size** 修改批量大小 需要在配置中启用 `allow-stacks` 选项。 * **/quickshop purge** 清理商店，更多信息请查看 config.yml 中的 purge 选项 需要在配置中启用 `purge` 选项 * **/quickshop transfer** 将某玩家的所有商店转移给另一名玩家 * **/quickshop item** 修改商店物品 需要在配置中启用 `allow-stacks` 选项 * **/quickshop removeworld** 删除指定世界中的所有商店 * **/quickshop name** 为商店命名或取消命名 * **/quickshop permission** 修改单个商店权限，或将玩家添加/移除至特定权限组 * **/quickshop database** 查看并管理 QuickShop-Hikari 数据库状态 * **/quickshop benefit** 查看并管理商店收益 ### 别名 * /shop * /qs * /chestshop * /cshop （可在 config.yml 中自定义别名） --- ## 权限 如果你是一个“懒人”服主，只需给予玩家 `quickshop.player` 权限节点，即可满足创建和使用商店的所有需求 但如果你是一个比较勤奋的服主，也可以使用以下详细权限列表来精细化控制： [在 plugin.yml 查看 QuickShop 的所有权限](https://github.com/QuickShop-Community/QuickShop-Hikari/blob/hikari/quickshop-bukkit/src/main/resources/plugin.yml) --- ## 如何创建商店 放置一个箱子，然后手持你想出售数量的物品左键点击箱子 例如：如果你想出售 16 个钻石，你需要手持 16 个钻石并左键点击箱子。（需要 `allow-stacks: true` 以及对应权限） 随后系统会提示你在聊天中输入价格 注意：如果你在使用带有全局聊天插件（如 BungeeChat）的 BungeeCord/Velocity 群组，可能会出现聊天创建异常，此时需要使用命令创建商店 完成后，箱子上方会显示物品（可在配置中关闭），箱子侧面会生成商店信息牌 若箱子周围没有空间放置商店信息牌，则无法创建商店 --- ## 如何买卖物品 左键点击商店牌子，然后在聊天中输入购买/收购数量 商店是购买还是收购取决于告示牌上的显示信息 --- ## 高级功能 ### 物品预览 GUI 在实际购买前预览物品，避免被骗 ### 商店控制面板 通过点击即可修改商店设置，无需命令 ### 商店助手系统 使用 `/quickshop staff <add/del/list> <player>` 管理助手，允许助手管理库存 ### 基于规则的价格限制器 可为特定材料设置价格限制规则 ### 翻译 OTA 与覆盖系统 使用 `CrowdinOTA` 技术实现在线翻译更新 如需自定义翻译，可自定义修改语言文件 ### 商店清理系统 清理长期未活跃或被封禁玩家的商店 部分兼容模块支持在玩家离开团队/岛屿/领地时自动清理 ### 交互控制与直接交易 可通过 `interaction.yml` 自定义点击行为，例如潜行点击直接购买 1 个或全部 ### 物品堆叠商店 启用 `allow-stacks` 后，可创建必须按倍数购买的商店 ### 单商店权限管理 可将其他玩家设置为商店管理员，或禁止某玩家购买 --- ## 已知不兼容插件 * 大多数 BungeeCord 聊天插件 可安装 Compat-BungeeCord 兼容模块解决 * 拦截 BlockBreakEvent 的插件 可配置 protection-checking 过滤器或禁用保护检查 --- ## 帮助我们翻译 QuickShop 你可以在 [Crowdin](https://crowdin.com/project/qs-hikari) 上帮助翻译 QuickShop --- ## 常见问题（FAQ） **Q: 可以创建同时买卖的商店吗？** A: 不可以。单个商店只能买或卖。可使用大箱子来实现 **Q: 可以使用物品作为货币吗？** A: QuickShop 并不支持以物换物，或者用物品来作为货币，您可能需要使用支持物品交易的经济插件 **Q: 插件创建商店无响应？** A: 某些插件可能会取消商店创建。这种情况最常发生在安全保护插件上。您可以在配置中禁用`protection-checking`来绕过此限制 **Q: 如何创建堆叠商店？** A: 在 config.yml 中启用 `allow-stacks`，并确保玩家拥有 `quickshop.create.stacks` 权限，然后手持对应数量的物品创建商店即可 **Q: 插件支持 1.7–1.19 吗？** A: 不支持，最新正式版仅支持 1.20+ --- ## 支持 [Github 讨论](https://github.com/Quickshop-Community/QuickShop-Hikari/discussions) [Github Issue Tracker](https://github.com/Quickshop-Community/QuickShop-Hikari/issues) [Discord](https://discord.gg/Bu3dVtmsD3) 反馈 BUG 请通过以上渠道进行反馈，如果你在帖子下面留言反馈的话，BUG 可能不会及时受理 --- ## 用户文档 [文档](https://quickshop-community.github.io/QuickShop-Hikari-Documents) --- ## 我可以转载 QuickShop 到 xxx 平台吗 只要您遵守以下两条基本规则，我们允许您在其他地方免费转载此插件： 保留指向原始资源 （即 Modrinth 页面）的链接和 Github 源代码链接 不要删除作者姓名或声称自己是原作者 （MineBBS 帖子发布者为 QuickShop-Hikari 的 Community Manager，且 Modrinth 跟 Crowdin 平台都有我的相关信息） ## Metrics 统计  [/MD]