对于不方便使用 Discord 或 Github Issue Tracker 的用户，也可在 QQ 社区群内 966701484 内寻求热心社区人员的帮助

我们现在有文档了！终于有了！

功能特性

• 易于使用，只需点击并输入价格即可创建商店。
• 支持 NBT 数据、附魔、工具耐久、药水和生物蛋。
• 根据客户端语言动态切换显示语言，对国际化友好。
• 支持无限库存商店。
• 支持黑名单和绕过权限检查。
• 支持在双箱子中同时进行买入和卖出的商店。
• 支持 UUID（当然）
• 在聊天栏和 GUI 中都有酷炫的物品预览功能。
• 聊天控制面板可更改商店设置。只需点击即可修改所有内容。
• 支持世界/区域保护插件，并可下载大量兼容性模块。
• 基于 ProtocolLib/PacketEvents 的虚拟展示物品支持（性能更佳）。
• 多货币支持：在任何支持 VaultUnlocked 的经济插件中，商店可使用不同的货币。我们也默认支持 Vault！
• 支持税收和持续费用！
• 如果玩家没有相应权限，则在帮助中隐藏相关命令。
• 信息告示牌上针对不同商店状态显示不同颜色的标题和清晰的描述。
• 支持 MiniMessage，可按需创建花哨的消息。
• 支持 H2（本地）或 MySQL（远程）数据库。
• 高级事务机制，当库存/经济操作执行失败时进行回滚，防止玩家复制物品。
• InventoryWrapper API 为开发者提供自定义库存能力。
• 高级事件总线允许用户将保护检查事件转移至特定插件。
• 快速缓存层，可处理 1000+ 商店而毫无卡顿！（需要安装 ProtocolLib）
• 每个商店独立的权限管理。
• 商店所有者与其他玩家之间的收益分享！
• 更多更多！无法在此全部列出！

或通过附加组件添加更多功能

• 折扣码
• 计划指标统计
• DiscordSRV 通知

如何安装

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 [item]
  使用手中物品或指定物品创建商店的命令。
• /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
  从 TXT 文件或 Paste 恢复所有商店。
  此命令仅限控制台使用，可能会移除/覆盖您服务器上的任何现有商店！请先备份并使用干净数据库尝试！
• /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 权限节点，它包含让玩家创建和使用快速商店所需的所有权限。

但如果您是一位专业的服主，这里也有一份详细的列表供您控制一切：

详细权限

玩家权限：

• quickshop.use
  执行任何 QuickShop 操作所必需。
• quickshop.create.sell
  创建商店（卖出模式）所必需。
• quickshop.create.buy
  创建商店（买入模式）或从卖出模式切换到买入模式所必需。
• quickshop.create.stacks
  允许以堆叠形式卖出物品所必需。
• quickshop.create.changeitem
  允许玩家更改商店的物品。
• quickshop.create.changeamount
  允许玩家更改每次买入/卖出的物品数量。
• quickshop.create.changeprice
  允许玩家更改其商店的买入/卖出价格。
• quickshop.create.double
  允许玩家创建双箱子商店。
• quickshop.create.cmd
  访问 /quickshop create 命令所必需。
  此命令可能绕过某些不支持的保护插件的保护措施！
• quickshop.transfer
  将所有拥有的商店转移给另一名玩家所必需。
• quickshop.find
  使用 /quickshop find <item> 所必需。
• quickshop.fetchmessage
  使用 /quickshop fetchmessage 所必需。
• quickshop.staff
  使用 /quickshop staff 及其所有子命令所必需。
• quickshop.preview
  使用 GUI 物品预览所必需。
• quickshop.currency
  使用 /quickshop currency <currency> 所必需。
• quickshop.shopnaming
  使用 /quickshop name <name> 所必需。
• quickshop.permission
  使用 /quickshop permission 所必需。
• quickshop.benefit
  使用 /quickshop benefit 所必需。

管理员权限：

• quickshop.unlimited
  使用 /quickshop unlimited 所必需。
• quickshop.alwayscounting
  使用 /quickshop alwayscounting 所必需。
• quickshop.setowner
  使用 /quickshop setowner 所必需。
• quickshop.other.destroy
  允许玩家移除/摧毁他人的商店。
• quickshop.other.open
  允许玩家打开他人商店的箱子并从中取出或放入物品。
• quickshop.other.price
  允许玩家更改他人商店的价格。
• quickshop.transfer.other
  将某人的所有商店转移给另一名玩家所必需。
• quickshop.refill
  允许玩家使用命令补充其商店，实质上使商店拥有无限物品。
• quickshop.empty
  允许玩家清空商店的库存。
• quickshop.clean
  允许清理/移除任何库存中没有物品的商店。
• quickshop.bypass.
  卖出黑名单物品（例如基岩）所必需。
• quickshop.price.restriction.bypass.
  绕过特定价格限制规则所必需。
• quickshop.alerts
  接收关于可能作弊、插件警告和更新的通知所必需。
• quickshop.info
  使用 /quickshop info 所必需。
• quickshop.debug
  使用 /quickshop debug 所必需。
• quickshop.paste
  使用 /quickshop paste 所必需。
• quickshop.purge
  使用 /quickshop purge 所必需。
• quickshop.create.admin
  使用 /quickshop supercreate 创建商店时绕过任何保护检查所必需。
• quickshop.tax
  绕过税费的权限。
• quickshop.tax.bypassunlimited
  仅在无限商店中绕过税费的权限。
• quickshop.cleanghost
  使用 /quickshop cleanghost 移除任何损坏商店的权限。
• quickshop.export
  使用 /quickshop export 的权限
  此权限毫无意义，因为该命令仅限控制台使用。
• quickshop.recovery
  使用 /quickshop recovery 的权限 此权限毫无意义，因为该命令仅限控制台使用。
• quickshop.removeworld
  使用 /quickshop removeworld 移除世界中所有商店的权限。
• quickshop.other.changeitem
  允许玩家更改他人商店的物品。
• quickshop.other.changeamount
  允许玩家更改他人商店的批量数量。
• quickshop.other.shopnaming
  允许玩家更改他人商店的名称。
• quickshop.bypass.namefee
  允许玩家绕过商店命名费用。
• quickshop.database
  使用 /quickshop database 的权限。

如何创建商店

要创建商店，放置一个箱子并用您想要卖出的物品数量左键点击它。 例如：如果我想卖出 16 个钻石，我需要手持 16 个钻石并左键点击箱子。(需要 allow-stacks: true 和相应权限)。

然后系统会提示您在聊天栏中输入您希望以此价格卖出该物品的金额。

注意： 如果您在使用全局聊天插件（如 BungeeChat）的 BungeeCord 网络上，可能会遇到聊天系统问题。在这种情况下，您需要使用命令来创建商店！

完成这些步骤后，顶部应显示一个物品（可在配置中关闭），并在箱子侧面放置一个带有信息的告示牌。 如果箱子周围没有空间放置告示牌，则可能无法创建商店。

如何买入/卖出物品

要从商店买入或向商店卖出物品，您需要左键点击告示牌。 然后系统会提示您在聊天栏中输入您想要买入/卖出的数量。

商店是卖出还是买入物品取决于告示牌上显示的信息。

高级功能

物品预览 GUI

在实际购买前预览您将购买的物品，以避免诈骗！

商店控制面板

商店控制面板允许您一键调整商店设置，无需命令！

商店员工

商店所有者可以使用命令 /quickshop staff <add/del/list> <player> 管理商店员工，这允许商店员工访问您的商店以管理库存。

末影箱库存链接

安装 OpenInv 和 openinv 兼容性模块，您将能够使用 /quickshop echest 将您的快速商店链接到您的末影箱库存！这样您所有的末影箱商店都可以共享您的末影箱库存！

基于规则的价格限制器

创建规则以限制特定材料的商店价格！

翻译 OTA 和覆盖系统

与其他插件不同，QuickShop 使用 CrowdinOTA 技术通过空中更新我们的翻译。您可以始终享受最新的翻译。所有翻译将与云端保持同步更新。 如果您需要自定义翻译，可以按照我们的指南使用 覆盖自定义系统!

商店清理器

清理所有者不再活跃或被封禁的商店！ 我们的兼容性模块还提供在玩家离开团队/岛屿/领地时清理其商店的功能。

交互控制器和直接交易

通过 interaction.yml 自定义点击行为！ 您可以通过潜行点击（或您配置的任何行为）直接卖出或买入 1 个或所有物品。

物品堆叠

在 config.yml 中启用 allow-stack 选项，然后您可以通过手持多个物品来创建堆叠商店。因此玩家必须购买其手持物品数量的倍数。

每个商店的权限管理

您是否曾考虑让另一名玩家全权负责您的商店？ 或者只是禁止某个玩家购买您的商店？ 现在您可以通过每个商店的权限管理来实现这一点。

兼容性模块

QuickShop-Hikari 官方提供一些插件兼容性模块，使其与 QuickShop 更紧密地协作，以下是我们目前支持的列表：

• AdvancedRegionMarket (区域重置时移除商店)
• BentoBox (成员被踢出团队时移除商店)
• Clearlag (如果您未安装 ProtocolLib，则防止清除 QuickShop 展示物品)
• GriefPrevention (在未信任、未认领、过期、调整大小等情况下移除商店)
• Lands (成员离开时移除商店)
• NoCheatPlus (反作弊兼容性)
• OpenInv (提供命令 /quickshop echest 以链接到您的末影箱)
• PlotSquared (玩家未被信任时移除商店)
• Towny (居民离开或地块被清除/摧毁时移除商店；税收进入城镇银行账户等)
• Residence (区域创建/购买控制)
• WorldEdit (WorldEdit 移除方块时移除商店)
• WorldGuard (注册旗帜以控制在允许区域内的创建和交易，通常您不需要这个)
• SuperiorSkyblock (玩家被踢出、取消合作、岛屿重置等情况下移除商店)
• EcoEnchants (显示 EcoEnchants 的附魔)
• Reforges (在预览物品 GUI 中显示 Reforges 内容)

增强型附加组件

ShopSearch by Ronsane

在游戏中添加 /finditem 命令，用于搜索服务器上的所有商店。 [下载]

DiscordSRV

将游戏内通知转发到 Discord EmbedMessage 并向玩家发送私信。

Plan

展示您服务器最近的 QuickShop-Hikari 活动，如购买记录和商店列表。

Discount

为您的 QuickShop-Hikari 服务器添加折扣码，支持自定义名称、比率、范围、过期时间和价格阈值。

已知不兼容的插件

某些插件可能与 QuickShop 无法协同工作，我们在这方面能做的很少。

• 几乎任何 BungeeCord 聊天插件。
  为解决 BungeeCord 聊天冲突，请在版本下下载并安装 Compat-BungeeCord 兼容性模块。
• 处理 BlockBreakEvents 的插件
  如果您是服务器管理员（拥有 quickshop.alert privileges），您将收到一条仅限管理员的消息，指导您如何配置过滤器。
  或者您可以直接禁用保护检查，但这将允许玩家在任何地方创建商店！
• ChatControl Pro/Red 您可以改用 /quickshop amount <amount> 来设置价格。

帮助我们翻译 QuickShop！

您可以帮助我们将 QuickShop 翻译成尽可能多的语言！
您可以在 Crowdin 上找到当前正在进行的翻译： https://crowdin.com/project/qs-hikari

找不到您的语言？ 在 Issue Tracker 上提交一个问题！

常见问题解答

Q: 我可以创建一个同时卖出和买入物品的商店吗？
A: 不可以。每个商店只能卖出或买入，不能同时进行。但您可以使用双箱子来拥有两个商店，一个买入，一个卖出该物品。

Q: 我可以使用像钻石这样的物品货币吗？
A: 不可以。我们不会添加此功能。但您可以选择一些允许您使用物品货币的经济插件。

Q: 创建商店时插件没有响应。是不是坏了？
A: 某些插件可能会取消商店创建。最常见的是保护插件。您可以在配置中禁用 shop.protection-checking 来绕过此问题。

Q: 如何创建一个卖出堆叠物品的商店？
A: 要创建这样的商店，请遵循以下步骤：

1. 在 config.yml 中将 "allow-stacks" 设置为 true 并重新加载插件。
2. 给予玩家（您自己）权限 quickshop.create.stacks
3. 手持要买入/卖出的物品数量，然后正常创建商店。

Q: 我可以创建一个绕过默认原版堆叠大小的商店吗？
A: 可以。在 config.yml 中启用 custom-item-stacksize 选项并重新加载插件。之后，您可以使用 /quickshop stack

Q: 我的商店被 XXX 非保护插件破坏/拒绝了。为什么？
A: QuickShop 创建一个假的 BlockBreakEvent 来检查您是否可以在该区域建造。某些插件可能会通过取消此事件进行干扰。尝试使用 保护监听器过滤器 来修复它。

Q: 如何从 H2 迁移到 MySQL、MariaDB（或反之）？
A: 查看文档

Q: 插件在控制台中给出 NoDefClassFound/NoMethodFound 错误，为什么？
A: 这可能是由 QuickShop 不支持的奇怪插件引起的，或者是由于 QuickShop 的 jar 文件损坏/损坏。尝试更新插件，并仅在安装 QuickShop 的情况下进行测试。如果问题仍然存在，请在 GitHub 上向我们报告！

Q: 如何更改或删除某些消息？
A: 在您的 message.json 文件中编辑消息。要删除消息，只需将其内容更改为空字符串 ("")。

Q: 您可以添加对插件 X 的支持吗？
A: 也许可以。请为此在我们的 GitHub 上提交一个问题。

Q: 它无法在 1.7/1.8/1.9/1.10/1.11/1.12/1.13/1.14/1.15/1.16/1.17/1.18/1.19 上加载。
A: 参见 "Tested Minecraft Versions"，最新版本仅支持 1.20 及以上。

从 QuickShop-Reremake 迁移

QuickShop-Hikari 与 Reremake 不同，数据彼此不兼容。 Hikari 提供一个转换器，允许您将数据从 Reremake 转换为 Hikari。

https://quickshop-community.github.io/QuickShop-Hikari-Documents/docs/addon/reremake-migrator

错误报告

Github Issue Tracker

支持

Discord Server

用户文档

文档链接

开发者 API

• Maven 仓库 & QuickShopAPI
• 代码片段 -> 商店查找
• 代码片段 -> 注册 QuickShop 命令
• 代码片段 -> InventoryWrapper API（将商店库存挂钩到另一个方块、实体和插件虚拟库存）
• 概览 -> API 包
• 代码片段 -> 使用 ServiceInjector 自定义展示物品实现（待办）

Javadoc 可以使用 Maven 下载或在 此处 查看。

我可以在 mcbbs 等地 repost/reprint 这个插件吗？

只要您遵守以下两条基本规则，我们允许您在其他地方免费 repost 此插件：

• 事先获得开发者的批准。
• 保留指向 原始资源（本页面）和 源代码 的链接。
• 不要移除作者姓名或声称自己是原作者。
• 对于 MineBBS 的转载者：此资源目前暂停等待决定，请勿在 MineBBS 上未经授权转载。

统计指标

统计指标/遥测披露

QuickShop-Hikari 收集有关运行该插件的 Minecraft 服务器环境的 匿名或假名使用统计和研究指标。

这些指标用于了解 QuickShop-Hikari 的部署方式，优先考虑兼容性工作和功能，提高性能，移除过时的兼容性代码，并指导未来开发。

默认情况下启用指标收集，但服务器所有者可以选择退出。

可能收集的内容

根据 QuickShop-Hikari 版本、启用的功能、安装的集成和指标提供商，收集的指标可能包括：

• Minecraft 服务器软件和构建/版本信息
• QuickShop-Hikari 构建/发布者信息
• 数据库实现/类型
• 经济实现/类型
• 物品匹配器实现
• 物品展示实现
• 后台调试记录器状态
• 服务器托管的 QuickShop 商店数量
• 服务器托管的 QuickShop 标签数量
• 是否正在使用某些 QuickShop 功能，例如物品堆叠商店
• 已安装的 QuickShop 附加组件和兼容性/集成模块，包括 QuickShop 检测到的第三方集成
• 安装 ProtocolLib 时的 ProtocolLib 版本
• 安装 PacketEvents 时的 PacketEvents 版本
• 是否检测到 Geyser/Floodgate 相关功能
• 配置的保护监听器黑名单条目
• 配置的 QuickShop 命令别名
• QuickShop-Hikari 记录的其他可比的技术、兼容性、功能使用和聚合统计数据

确切的指标集可能会随着 QuickShop-Hikari 发布版本的变化而变化，因为功能和兼容性要求会发生变化。

为何收集这些指标

统计和研究指标用于以下目的：

• 确定最常用的数据库、经济、物品匹配、展示和服务器实现
• 了解 QuickShop 安装的规模，包括商店和标签数量，以指导性能和缓存改进
• 确定实验性或可选功能是否应成为默认值
• 了解哪些第三方集成和 QuickShop 附加组件常用
• 识别仍需要用于 ProtocolLib 和 PacketEvents 等库的兼容性代码
• 优先支持 Geyser 等集成
• 改进默认配置值和命令别名
• 通过其声明的发布者信息识别 QuickShop 构建/分支
• 提高可维护性、兼容性、稳定性和性能

指标服务

QuickShop-Hikari 可能使用外部指标服务（包括 bStats）来处理统计数据。

使用外部指标提供商意味着运行 QuickShop-Hikari 的服务器会向该提供商运营的基础设施发出网络请求。因此，提供商接收到的信息也可能受提供商自身隐私实践的约束。

QuickShop-Hikari 尊重全局 bStats 配置。如果已在 Minecraft 服务器上全局禁用 bStats，则 QuickShop-Hikari 不会通过 bStats 提交指标。

选择退出

服务器所有者可以通过插件的隐私配置禁用 QuickShop-Hikari 的指标/研究类别。

例如：

privacy:
  type:
    STATISTIC: false
    RESEARCH: false

服务器所有者也可以通过 bStats 自身的配置全局禁用 bStats。

禁用指标可防止通过禁用机制进行未来的收集/提交。它不会自动删除之前提交给外部指标提供商的信息。

有关当前的隐私控制和其他信息，请参阅 QuickShop-Hikari 隐私文档。

外部服务披露 — Crowdin OTA

QuickShop-Hikari 可以与 外部翻译服务 通信，以自动检索更新的本地化文件。

此功能称为 Crowdin OTA（空中本地化），默认启用。服务器所有者可以选择退出。

Crowdin OTA 的作用

QuickShop-Hikari 支持多种语言，翻译由贡献者通过 Crowdin 维护。

当启用 Crowdin OTA 时，QuickShop-Hikari 可能会向配置的 QuickShop-Hikari/Crowdin OTA 翻译服务发出出站网络请求，以检索当前的翻译资源。

这使得翻译和本地化修复无需新的 QuickShop-Hikari 发布或手动安装更新的语言文件即可交付。

由于此功能与外部服务器通信，该服务的运营商可能会收到通常与 HTTP/网络请求相关联的信息，例如请求服务器的 IP 地址和其他网络/协议元数据。

Crowdin OTA 用于检索本地化资源；它与 QuickShop-Hikari 的指标/遥测功能是分开的。

选择退出

服务器所有者可以禁用 Crowdin OTA。

在当前 QuickShop-Hikari 版本中，请在 config.yml 中设置以下内容：

use-crowdin-ota: false

当禁用 Crowdin OTA 时，QuickShop-Hikari 将继续使用缓存的翻译或插件捆绑的翻译运行。不再从 OTA 服务自动检索更新的翻译。

较旧的 QuickShop-Hikari 版本使用以下 JVM 启动属性代替：

-Dcom.ghostchu.quickshop.localization.text.SimpleTextManager.enableCrowdinOTA=false

自托管

不想使用默认 OTA 服务的服务器所有者也可以配置 QuickShop-Hikari 以使用自托管翻译服务器。

在当前版本中，这可以通过以下方式配置：

crowdin-host: <YOUR_SERVER_ADDRESS>

使用自托管端点会将该端点的操作、日志记录和隐私实践的责任转移给其运营商。

总结

默认情况下，QuickShop-Hikari 可能会连接到外部 OTA 服务以保持本地化资源最新。

不希望 QuickShop-Hikari 发出这些请求的服务器所有者可以禁用 Crowdin OTA 而不禁用核心插件。取而代之的是使用缓存或捆绑的翻译。