简介
QuickShop 是一款简单而强大的商店插件，允许您和其他玩家快速轻松地创建新商店。它功能丰富，支持多种保护插件、多货币、异步操作等，旨在为您的服务器提供一个高效、可定制的商店系统。
版本与支持
- 最新稳定版：适用于 1.15.2 至 1.20.x 版本，请使用页面右侧按钮下载。
- 旧版支持：1.13 和 1.14 版本已结束支持，您可以从 此链接 下载最后一个支持这些版本的构建。
- 迁移指南：从 v4 迁移到 v5 的指南请查看 此处。
重要提示：请勿在插件评论或讨论区报告问题。如需支持，请通过下方徽章访问我们的 Discord 服务器或问题追踪器。
如何创建商店
要创建一个商店，请放置一个箱子，然后手持您想要出售数量的物品左键点击箱子。
创建步骤
- 手持一定数量的物品（例如，想卖16个钻石就手持16个钻石）。
- 左键点击一个已放置的箱子。
- 在聊天框中输入您希望出售该物品的价格。
注意事项
- 需要配置文件中
allow-stacks: true以及相应的权限。 - 如果箱子周围没有空间放置告示牌，则无法创建商店。
- 如果您在使用 BungeeCord 网络并启用了全局聊天插件（如 BungeeChat），聊天系统可能会冲突。此时，您需要使用命令来创建商店。
支持的容器
QuickShop 支持所有类型的箱子，包括
- 双箱
- 末影箱（需要安装插件 OpenInv）
创建成功后，一个展示物品的悬浮文本（可在配置中关闭）和一个包含信息的告示牌会出现在箱子旁。
主要特性
QuickShop 内置了大量功能
核心功能
- 异步操作：大多数操作异步处理，减少潜在卡顿，提升服务器性能。
- 全面物品支持：支持 NBT 数据、附魔、物品耐久、药水、刷怪蛋、潜影盒等。这意味着您可以出售带有自定义模型数据的物品！
- 管理员商店：可以创建无限购买/出售物品的商店。
- 物品黑名单：可设置黑名单，管理员拥有绕过权限。
- 双箱模式：使用双箱时，可以同时设置一个出售商店和一个收购商店。
- 物品预览：支持在聊天框和 GUI 界面中预览物品。
- 多语言支持：物品、药水、附魔等支持 i18n 国际化。
- 查找命令：
/qs find命令支持多语言。 - 聊天控制面板：可直接在聊天中更改商店设置。
- 多种告示牌：支持所有告示牌类型（1.14+）。
- 清理兼容：与 ClearLag 兼容，箱子上的物品不会被误删。
集成与扩展
- 领地保护：支持 WorldGuard、Towny、PlotSquared 和 Factions，防止玩家在他人的领地或保护区创建商店。
- 多货币系统：支持多种经济插件货币。
- 状态标识：不同商店状态的告示牌标题有不同的颜色。
- 高级事件总线：允许将方块保护检查事件传递给特定插件处理。
- 税收系统：支持对交易征税。
- 权限隐藏：没有权限的命令不会在帮助列表中显示。
如何购买/出售物品
要与商店进行交易，请左键点击商店的告示牌。
- 左键点击商店告示牌。
- 在聊天框中输入您想要购买/出售的数量。
- 商店是收购还是出售模式，取决于告示牌上显示的信息。
高级功能：商店员工
您可以为您商店添加员工。员工可以
- 打开您的商店箱子。
- 设置收购/出售价格。
- 切换商店的收购/出售模式。
但员工不能删除您的商店或从销售中获得金钱。
员工管理命令
- 添加员工：看着您的商店并执行
/qs staff add <玩家名> - 移除员工：
/qs staff remove <玩家名> - 清空所有员工：
/qs staff clear
安装指南
在安装前，请确保您的服务器至少运行 1.15 版本，旧版本不再受支持。
安装步骤
- 下载插件：下载最新版 QuickShop。
- 下载可选依赖（如需）：NBTAPI, ProtocolLib。
- 准备经济系统：确保已安装 Vault 及一个兼容的经济插件（如 EssentialsX）。
- 安装：停止服务器，将下载的 jar 文件放入
plugins文件夹。 - 启动：启动服务器，完成安装。
注意：适用于 1.12 及更早版本的旧版可在 此处 找到（感谢 Timtower, Netherfoam 和 KaiNoMood）。
命令与权限
常用命令
/qs unlimited- 将商店设置为无限物品或有限物品。/qs setowner <玩家名>- 更改商店所有者。/qs buy- 将商店切换为收购模式。/qs sell- 将商店切换为出售模式。/qs price <价格>- 更改物品的收购/出售价格。/qs find <物品>- 查找最近出售/收购指定物品的商店（例如/qs find dia找钻石商店）。/qs create <价格> [物品]- 用手中物品或指定物品创建商店。/qs supercreate- 绕过所有保护检查创建商店。/qs staff- 管理商店员工。/qs cleanghost- 移除所有损坏的商店。/qs size- 更改批量交易大小（需配置启用allow-stacks）。/qs item- 更改商店出售的物品（需配置启用allow-stacks）。
命令别名：/shop, /qshop, /qsshop, /quickshop, /chestshop, /cshop
玩家权限
为方便起见，可使用 quickshop.player 权限节点，它包含了玩家所需的所有基本权限。
quickshop.use- 执行任何 QuickShop 操作的基础权限。quickshop.create.sell- 创建出售商店的权限。quickshop.create.buy- 创建收购商店或从出售切换到收购模式的权限。quickshop.create.stacks- 允许按堆叠出售物品的权限。quickshop.find- 使用/qs find的权限。quickshop.staff- 使用/qs staff及其子命令的权限。quickshop.preview- 使用 GUI 物品预览的权限。
管理员权限
quickshop.unlimited- 使用/qs unlimited的权限。quickshop.other.destroy- 移除/摧毁他人商店的权限。quickshop.other.open- 打开他人商店箱子并存取物品的权限。quickshop.alerts- 接收关于作弊、插件警告和更新通知的权限。quickshop.create.admin- 使用/qs supercreate绕过保护检查的权限。quickshop.tax- 绕过交易税的权限。
常见问题 (FAQ)
商店创建与功能
Q: 可以创建一个同时收购和出售物品的商店吗？
A: 不可以。每个商店只能收购或出售，不能同时进行。但您可以使用一个双箱，一边设置收购店，另一边设置出售店。
Q: 创建商店时插件没反应，是坏了吗？
A: 可能是某些插件（通常是领地保护插件）取消了商店创建事件。您可以在配置文件中将 shop.protection-checking 设置为 false 来绕过此检查。
Q: 如何创建按堆叠出售的商店？
A
- 在
config.yml中将allow-stacks设置为true并重载插件。 - 给予玩家
quickshop.create.stacks权限。 - 手持想要交易的物品数量，像平常一样创建商店。
Q: 如何创建超过原版堆叠上限的商店？
A: 在 config.yml 中启用 custom-item-stacksize 选项并重载插件，然后使用 /qs stack <数量> 命令。
错误与故障排除
Q: 插件在控制台报错 NoDefClassFound/NoMethodFound，为什么？
A: 可能是由 QuickShop 支持（或不支持）的某些特殊插件引起，或是 QuickShop 的 jar 文件损坏。请尝试更新插件，并仅在安装 QuickShop 的情况下测试。如果问题依旧，请在 GitHub 上向我们报告。
Q: 文本显示为奇怪的 JSON 代码。
A: 请更新您的跨版本聊天插件。
Q: 插件报错“SHA-256(SHA-1) digest error”或“Security risk detected”。
A: 您的服务器可能感染了恶意软件（如“L10”病毒）。请立即：
- 删除恶意插件。
- 对服务器进行完整备份。
- 使用 此反恶意软件工具 扫描服务器。
- 删除工具报告的所有恶意 jar 文件，重新下载正版文件并再次扫描确认。
如果 QuickShop 仍报相同错误，说明未完全清除病毒，请在 SpigotMC 论坛寻求帮助。
Q: 如何迁移数据库（如 sqlite 到 mysql）？
A
- 务必先使用
/qs export创建备份。 - 正确设置当前数据库的凭据和配置。
- 使用
/qs reload重载插件。 - 使用
/qs convert sqlite或/qs convert mysql进行转换。 - 转换完成后，在配置中更改数据库类型并再次重载。
其他问题
Q: 如何更改或删除某些消息？
A: 编辑您的 messages.json 文件。要删除消息，将其内容改为空字符串 ""。要更改物品、附魔等名称，请编辑相应的 i18n.yml 文件。
Q: 你们能为 XXX 插件添加支持吗？
A: 有可能。请在我们的 GitHub 上提交一个功能请求。
其他任何问题？ 请加入我们的 Discord 服务器提问。
已知不兼容插件
某些插件可能与 QuickShop 不兼容，我们很难单独修复：
- 几乎所有 BungeeCord 聊天插件：它们会覆盖每服务器的默认聊天，导致创建商店时无法输入价格。替代方案：使用
/qs amount <数量>命令来设置价格。 - 会处理 BlockBreakEvent 的插件：您可以禁用
shop.protection-checking，并使用集成选项来检查是否能创建商店。注意：这可能会允许玩家在任何地方创建商店！ - ChatControl Pro/Red：同样，可以使用
/qs amount <数量>命令来设置价格。
帮助翻译
您可以帮助我们将 QuickShop 翻译成更多语言！
当前正在进行的翻译项目可在 Crowdin 查看：
https://crowdin.com/project/quickshop-reremake
如果找不到您的语言，请加入我们的 Discord 服务器告知我们：
https://discord.gg/bfefw2E
附加组件
已知的 QuickShop 附加组件列表可在插件页面查看。如果您有未列出的附加组件，请通过 Discord 联系我们！
赞助与声明
感谢 ApexHosting 对我们的赞助！
重新发布规则：允许免费或非免费重新发布此插件，但必须遵守两条基本规则：
- 保留原始资源（本页）和源代码的链接。
- 不得删除作者姓名或声称自己是原始作者。
错误报告：请通过我们的 GitHub 问题追踪器 报告错误。请勿在插件评论中报告错误，它们将被忽略。
