QuickShop-Hikari
QuickShop-Hikari 是一款高性能、功能丰富的 Minecraft 商店插件，适用于大型网络服务器和家庭小服。它易于上手，同时提供了精细的控制选项、强大的兼容性以及面向全球玩家的多语言支持。
核心特性
为大型网络服务器优化
我们编写了高性能代码，充分利用您的多核处理器，并将耗时任务移至异步线程执行。
- 异步执行磁盘或网络 I/O 任务。
- 利用多核处理器批量执行任务。
- 精密的商店查找缓存系统，轻松应对繁忙的红石服务器活动。
- 兼容 BungeeCord 和 Velocity 上的聊天插件。
- 基于权限节点驱动，每个功能都可以通过权限节点精确控制。
- 基于数据包的展示物品，无延迟。
- 提供大量可选附加组件和兼容性模块，以增强和丰富玩家体验。
为小型家庭服务器优化
我们编写了优化代码，在提供广泛功能的同时节省您的服务器资源。同时，QuickShop-Hikari 对新手也非常友好。
- 遵循简单的安装指南，10 分钟内即可让 QuickShop-Hikari 准备就绪。
- 内置 H2 数据库，无需安装 MySQL，默认配置已调优，开箱即用！
为全球玩家优化
- 易于使用：手持物品，点击箱子，输入价格，即可开始您的生意！
- 右键点击商店招牌即可打开控制面板，轻松管理常见操作。
- 告别诈骗，在购买前预览商店中出售的物品。
- 添加助手帮助您管理商店，或与他人分摊收益。
- 利用 QuickShop-Hikari 的语言系统和
TranslatableComponent，为来自世界各地的玩家自动切换到其客户端显示语言。 - 还有更多功能！
掌控一切，插件属于您
您能想到的，或许都在这里！
- 控制不同群组的最大商店数量。
- 太贵？太便宜？说不！
- 向创建商店的玩家定期收取费用。
- 将物品列入黑名单禁止出售？没问题！
- 使用其他方块作为商店？可以！
- 无漏洞，保持安全！
- 我们可能是少数几个具有交易一致性的商店插件之一？
- 基于数据包的展示物品，漏斗无能为力！
- 交易系统，确保在发生错误时回滚所有经济和库存操作。
- 良好的编码，适用于大多数边界情况。
更技术性？更进一步！
如果您已经可以上手 QuickShop-Hikari，那么看看我们能提供的更高级功能。
- 保护检查器，无论已知或未知，保护插件都能自动适配我们。
- 每个商店的权限管理，允许玩家自己控制对其商店的所有类型的访问。从搜索结果中隐藏？禁止玩家购买？您都可以做到！
- 随心所欲地自定义您的控制，做您想做的事。
增强您的体验
我们大量的可选附加组件允许基于 Hikari 改进和丰富玩家体验。
兼容与合作
我们创建了大量兼容性组件，使其他插件能与 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 来贡献代码或翻译。
请确保始终使用来自官方渠道的最新版本插件，以获得最佳体验和安全更新。
