QuickShop Reremake - 1.20(.2) Ready - Multi Currency - QuickShop Reremake - 多货币商店插件

💡简介

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 问题追踪器 报告错误。请勿在插件评论中报告错误，它们将被忽略。