QuickShop-Hikari - A powerful, user-friendly and reliable ChestShop plugin - QuickShop-Hikari - 便捷箱式商店插件

💡QuickShop-Hikari

QuickShop-Hikari 是一款高性能、功能丰富的 Minecraft 商店插件，适用于大型网络服务器和家庭小服。它易于上手，同时提供了精细的控制选项、强大的兼容性以及面向全球玩家的多语言支持。

🎮核心特性

为大型网络服务器优化

我们编写了高性能代码，充分利用您的多核处理器，并将耗时任务移至异步线程执行。

• 异步执行磁盘或网络 I/O 任务。
• 利用多核处理器批量执行任务。
• 精密的商店查找缓存系统，轻松应对繁忙的红石服务器活动。
• 兼容 BungeeCord 和 Velocity 上的聊天插件。
• 基于权限节点驱动，每个功能都可以通过权限节点精确控制。
• 基于数据包的展示物品，无延迟。
• 提供大量可选附加组件和兼容性模块，以增强和丰富玩家体验。

为小型家庭服务器优化

我们编写了优化代码，在提供广泛功能的同时节省您的服务器资源。同时，QuickShop-Hikari 对新手也非常友好。

• 遵循简单的安装指南，10 分钟内即可让 QuickShop-Hikari 准备就绪。
• 内置 H2 数据库，无需安装 MySQL，默认配置已调优，开箱即用！

为全球玩家优化

• 易于使用：手持物品，点击箱子，输入价格，即可开始您的生意！
• 右键点击商店招牌即可打开控制面板，轻松管理常见操作。
• 告别诈骗，在购买前预览商店中出售的物品。
• 添加助手帮助您管理商店，或与他人分摊收益。
• 利用 QuickShop-Hikari 的语言系统和 TranslatableComponent，为来自世界各地的玩家自动切换到其客户端显示语言。
• 还有更多功能！

掌控一切，插件属于您

您能想到的，或许都在这里！

• 控制不同群组的最大商店数量。
• 太贵？太便宜？说不！
• 向创建商店的玩家定期收取费用。
• 将物品列入黑名单禁止出售？没问题！
• 使用其他方块作为商店？可以！
• 无漏洞，保持安全！
• 我们可能是少数几个具有交易一致性的商店插件之一？
• 基于数据包的展示物品，漏斗无能为力！
• 交易系统，确保在发生错误时回滚所有经济和库存操作。
• 良好的编码，适用于大多数边界情况。

更技术性？更进一步！

如果您已经可以上手 QuickShop-Hikari，那么看看我们能提供的更高级功能。

• 保护检查器，无论已知或未知，保护插件都能自动适配我们。
• 每个商店的权限管理，允许玩家自己控制对其商店的所有类型的访问。从搜索结果中隐藏？禁止玩家购买？您都可以做到！
• 随心所欲地自定义您的控制，做您想做的事。

✨增强您的体验

我们大量的可选附加组件允许基于 Hikari 改进和丰富玩家体验。

• DiscordSRV
• Discount
• DisplayControl
• Dynmap
• EcoEnchants
• Limited
• List
• Plan
• Reforges
• 更多即将推出！

🔧兼容与合作

我们创建了大量兼容性组件，使其他插件能与 QuickShop-Hikari 良好协作！

• AdvancedRegionMarket
• AngelChest
• BentoBox
• ChestProtect
• Clearlag
• EliteMobs
• GriefPrevention
• Lands
• PlotSquared
• Residence
• SuperiorSkyBlock
• Towny
• WorldEdit
• WorldGuard
• 更多即将推出！

⭐安装指南

QuickShop-Hikari 需要 Minecraft 1.20+ 才能运行。自 6.2.0.7 版本起，任何低于 1.20 的版本均不受支持。

• 安装 Vault 和一个受 Vault 支持的经济插件。如果您使用多货币功能，config.yml 中有一个选项允许您切换到 GemsEconomy/TNE 或 Reserve！
• 安装可选的 ProtocolLib，它可以极大地提高 QuickShop 性能。
• 如果您是 Spigot 用户，Hikari 将使用 NMS 来设置重要内容，请确保您的 Hikari 版本支持您的 Spigot 版本。或者使用 Paper 或其分支，以便我们能够平滑地跨版本。
• 下载 QuickShop jar 文件并将其放入您的 plugins 文件夹。
• 如果需要，下载其他兼容性模块或附加组件。

- 仅安装您需要的兼容性模块，它们不是开箱即用的，您需要进行配置。

- 在大多数情况下，Hikari 可以自行处理区域保护，您不需要它们。

• 启动服务器，一切就绪！

🎮命令列表

注意：大多数功能可以通过控制面板或与商店交互来访问，在大多数情况下，您不需要这些命令。

• /qs unlimited - 使您的商店以无限数量或有限数量购买/出售物品。
• /qs setowner <player> - 更改商店所有者。
• /qs buy - 将商店更改为购买物品。
• /qs sell - 将商店更改为出售物品。
• /qs price <price> - 更改物品的购买/出售价格。
• /qs clean - 移除任何已加载但没有库存物品的商店。
• /qs find <item> - 查找出售以提供文本开头的物品的最近商店。例如：/qs find dia 将查找购买/出售钻石的最近商店。
• /qs fetchmessage - 手动从数据库获取商店消息。
• /qs info - 显示 QuickShop 信息。
• /qs debug - 启用/禁用调试模式。
• /qs create <price> [item] - 使用手中或指定的物品创建商店的命令。
• /qs currency <currency name> - 指定商店使用的货币的命令。经济插件必须支持多货币功能并且被 QuickShop 支持。我们现在支持 GemsEconomy 和 TNE。
• /qs supercreate - 创建商店时绕过任何保护检查。
• /qs paste - 收集有用信息并将其粘贴到 Pastebin 上。
• /qs staff - 管理您商店中的员工。

- `/qs staff add <player>` - 将玩家添加为您商店的员工。

- `/qs staff del <player>` - 将玩家从您商店的员工中移除。

- `/qs staff clear` - 从您的商店中移除所有员工。

- `/qs staff list` - 显示您商店的所有当前员工。

• /qs cleanghost - 移除所有损坏的商店。
• /qs export - 将所有商店数据导出到 TXT 文件。此命令仅限控制台使用！
• /qs recovery - 从 TXT 文件或 Paste 恢复所有商店。此命令仅限控制台使用，并且可能会移除/覆盖您服务器上任何现有的商店！请先备份，并在干净的数据库上尝试！
• /qs size - 更改批量大小。需要配置中的 allow-stacks 选项启用，此命令才能工作。
• /qs purge - 清理旧商店，更多信息请查看 config.yml 中的清理选项。需要配置中的 purge 选项启用，此命令才能工作。
• /qs transfer - 将所有商店从一个玩家转移到另一个玩家。
• /qs item - 更改商店的物品。需要配置中的 allow-stacks 选项启用，此命令才能工作。
• /qs removeworld - 移除特定世界中的所有商店。
• /qs name - 为商店命名或取消命名。
• /qs permission - 调整每个商店的权限，或将玩家添加/移除到特定组。
• /qs database - 查看和管理 QuickShop-Hikari 状态。
• /qs benefit - 查看和管理您的商店收益。

命令别名：

• /shop
• /qshop
• /qsshop
• /quickshop
• /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 - 拥有访问 /qs create 命令的权限。此命令可能会绕过某些不受支持的保护插件的保护！
• quickshop.transfer - 将所有拥有的商店转移给另一个玩家。
• quickshop.find - 使用 /qs find <item> 所必需。
• quickshop.fetchmessage - 使用 /qs fetchmessage 所必需。
• quickshop.staff - 使用 /qs staff 及其所有子命令所必需。
• quickshop.preview - 使用 GUI 物品预览所必需。
• quickshop.currency - 使用 /qs currency <currency> 所必需。
• quickshop.shopnaming - 使用 /qs name <name> 所必需。
• quickshop.permission - 使用 /qs permission 所必需。
• quickshop.benefit - 使用 /qs benefit 所必需。

管理员权限

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

🔧如何创建商店

要创建商店，请放置一个箱子，并用您想要出售的物品数量左键点击它。

例如：如果我想出售 16 颗钻石，我需要手持 16 颗钻石并左键点击箱子。

（需要 allow-stacks: true 和相应权限）。

然后，您将在聊天中被提示输入您想以多少价格出售此物品。

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

完成这些步骤后，一个物品将显示在顶部（可以在配置中关闭），并且一个带有信息的招牌将放置在箱子侧面。

如果箱子周围没有空间放置招牌，则可能无法创建商店。

🔧如何购买/出售物品

要从/向商店购买或出售物品，您需要左键点击招牌。

然后，您将在聊天中被提示输入您想要购买/出售的数量。

商店是出售还是购买物品取决于招牌上显示的信息。

✨高级功能

物品预览 GUI

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

商店控制面板

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

商店员工

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

末影箱库存链接

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

基于规则的价格限制器

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

翻译 OTA 和覆盖系统

与其他插件不同，QuickShop 使用 CrowdinOTA 技术通过空中更新我们的翻译。您可以随时享受最新的翻译。所有翻译都将与云端保持同步。

如果您需要自定义翻译，可以按照我们的指南使用覆盖自定义系统！

商店清理器

清理所有者不再活跃或被封禁的商店！

我们的兼容性模块还提供了在玩家离开团队/岛屿/领地时清理其商店的功能。

交互控制器和直接交易

通过 interaction.yml 自定义点击行为！

您可以通过潜行点击（或您配置的任何行为）直接出售或购买 1 个或所有物品。

物品堆叠

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

每个商店的权限管理

您是否曾考虑让另一个玩家全权负责您的商店？

或者只是禁止一个玩家以避免他购买您的商店？

您现在可以通过每个商店的权限管理来实现这一点。

🔧兼容性模块

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

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

✨增强的附加组件

• ShopSearch by Ronsane

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

[下载链接]

💡已知不兼容的插件

有些插件可能无法与 QuickShop 一起工作，我们在我们这边几乎无法修复这个问题。

• 几乎任何 BungeeCord 聊天插件。您需要安装 Compat-BungeeCord 来修复此问题。
• 取消 BlockBreakEvent 的插件。如果您是服务器管理员（拥有 quickshop.alert 权限），您将收到一条仅管理员可见的消息，指导您如何配置过滤器。或者您可以直接禁用保护检查，但这将允许玩家在任何地方创建商店！
• ChatControl Pro/Red 您可以使用 /qs amount <amount> 来设置价格。

❓帮助翻译 QuickShop！

您可以帮助我们将 QuickShop 翻译成尽可能多的语言！

您可以在 Crowdin 上找到当前正在进行的翻译：

https://crowdin.com/project/qs-hikari

找不到您的语言？请在 Issue Tracker 上提出问题！

❓常见问题解答

Q: 我可以创建一个既出售又购买物品的商店吗？

A: 不可以。每个商店只能出售或购买，不能同时进行。但是，您可以使用一个双箱来拥有两个商店：一个购买，一个出售该物品。

Q: 我可以使用像钻石这样的物品货币吗？

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

Q: 创建商店时插件没有反应。它坏了吗？

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

Q: 如何创建一个出售堆叠物品的商店？

A: 要创建这样的商店，请按照以下

QuickShop-Hikari 文档

QuickShop-Hikari 是一个功能强大、高度可配置的 Minecraft 商店插件，允许玩家通过放置箱子或木桶来创建和管理商店。它支持多种经济插件，提供丰富的权限控制和商店类型，是服务器经济的核心组件之一。

💡主要特性

• 多种商店类型：支持收购商店和出售商店。
• 经济系统兼容：支持 Vault 及多种经济插件。
• 容器支持：支持箱子、木桶、潜影盒等多种容器作为商店。
• 高度可配置：可通过配置文件调整几乎所有功能。
• 多语言支持：内置多种语言，支持自定义。
• 商店保护：防止他人破坏或窃取商店物品。
• 丰富的命令和权限：为玩家和管理员提供全面的控制选项。
• API 支持：为开发者提供 API 以进行扩展集成。

🎮快速开始

安装步骤

• 安装前置插件

- 确保服务器已安装 [Vault](https://www.spigotmc.org/resources/vault.34315/) 和一个受支持的经济插件（如 EssentialsX）。

• 安装 QuickShop

- 将 `QuickShop-Hikari.jar` 放入服务器的 `plugins` 文件夹。

• 重启服务器

- 启动或重启服务器以生成配置文件和文件夹。

• 配置经济插件

- 确保 Vault 能正确检测到你的经济插件。

• 完成

- 插件现已安装完毕，玩家可以使用 `/qs help` 查看命令。

创建商店

• 手持你想要出售或收购的物品。
• 对着一个箱子（或木桶等容器）点击。
• 输入物品单价，例如 /qs price 10。
• 商店即创建成功。其他玩家可以右键点击商店牌进行交易。

🔧命令与权限

玩家常用命令

• /qs buy - 将现有商店切换为收购模式。
• /qs sell - 将现有商店切换为出售模式。
• /qs price <价格> - 设置或更改商店物品单价。
• /qs unlimited - 切换商店的无限库存模式（需要权限）。
• /qs silent - 切换商店的静音模式（不显示消息）。
• /qs remove - 移除你正在查看的商店。
• /qs refill <数量> - 为商店补充物品。
• /qs empty - 清空商店容器内的所有物品。
• /qs find <物品> - 查找附近出售特定物品的商店。
• /qs help - 显示帮助信息。

管理员命令

• /qs clean - 移除所有无效商店。
• /qs reload - 重载插件配置和语言文件。
• /qs paste - 上传调试信息并获取链接。
• /qs debug - 切换调试模式。
• /qs resetlang - 重置语言文件为默认版本。
• /qs size - 显示所有商店数据的大小。
• /qs fetchmessage - 获取所有未读的商店消息。
• /qs supercreate - 直接创建一个商店（需要权限）。

关键权限节点

• quickshop.use - 使用商店的基本权限。
• quickshop.create.sell - 创建出售商店。
• quickshop.create.buy - 创建收购商店。
• quickshop.unlimited - 使用无限库存模式。
• quickshop.bypass - 绕过商店保护。
• quickshop.other.destroy - 破坏他人的商店。
• quickshop.other.open - 打开他人的商店容器。
• quickshop.remove.other - 移除他人的商店。
• quickshop.setprice.other - 修改他人商店的价格。
• quickshop.alert - 接收商店错误或警告提示。
• quickshop.* - 所有权限（谨慎授予）。

✨配置与自定义

配置文件 (config.yml) 位于 plugins/QuickShop/config.yml。你可以在此调整：

• 商店的默认类型（收购/出售）。
• 价格限制和检查设置。
• 日志和审计设置。
• 商店显示效果和粒子。
• 兼容性设置。

语言文件位于 plugins/QuickShop/lang/ 目录。你可以编辑或创建新的语言文件来本地化插件消息。

❓常见问题

问：商店创建失败，提示“No permission”或“经济系统未就绪”？

• 答：请检查玩家是否拥有 quickshop.create.sell 或 quickshop.create.buy 权限，并确认 Vault 和经济插件已正确安装并运行。

问：商店价格可以设置为免费吗？

• 答：可以，但需要在 config.yml 中启用 allow-free-shop 选项。

问：如何备份商店数据？

• 答：商店数据存储在 plugins/QuickShop/database.db（如果使用 SQLite）。定期备份此文件即可。

问：如何迁移旧版 QuickShop 的数据？

• 答：插件通常会自动处理。如果遇到问题，请将旧数据文件放入 plugins/QuickShop 目录，并确保文件命名正确，然后启动服务器。

问：支持哪些容器？

• 答：支持箱子、陷阱箱、木桶、潜影盒等大多数存储容器。具体列表可在配置文件中查看和修改。

⭐附加信息

• 支持与反馈：如需帮助或报告问题，请访问 GitHub Issues。
• API 文档：开发者可查阅 JavaDoc 进行开发。
• 贡献：欢迎通过 GitHub 提交 Pull Request 来贡献代码或翻译。

请确保始终使用来自官方渠道的最新版本插件，以获得最佳体验和安全更新。