安装
这一页将会引导您在您的 Spigot 服务器上安装 QuickShop-Hikari。
环境需求
- Paper 系 Minecraft 服务端(高于 1.20 的版本,使用 Java 21)
- 用于桥接经济插件与 QuickShop 的 Vault。
- 显示虚拟展示物品和分玩家语言还需安装支持的发包库插件:
- 任意兼容 Vault 的经济插件,例如 XConomy。 同样支持 EssentialsX。
- 一个权限管理插件,例如 LuckPerms.
本教程假设你使用的 QuickShop-Hikari、ProtocolLib、XConomy、Vault 以及 LuckPerms 插件都是最新版本,且系统环境为 Windows 11。 不过安装过程在 Linux 上也大致相似。
安装前置依赖
在安装 QuickShop-Hikari 之前,请确保您已经安装了所有前置插件:Vault、ProtocolLib 或 PacketEvents、XConomy(也可以是 EssentialsX)和 LuckPerms!
下载插件,将其放入 plugins 文件夹。
配置显示协议
如果同时安装了 ProtocolLib 与 PacketEvents,且你需要使用后者展示物品,那么你需要在 config.yml 中设置 shop.display-protocol: 'packetevents'。
安装 QuickShop-Hikari
从 Modrinth 下载最新版本的 QuickShop-Hikari。 请先忽略部分带有 Compat- 前缀的文件。
你需要获取的文件应当有一个 Primary 标签,如下图所示:

将 QuickShop 的 jar 文件放入 plugins 文件夹,启动服务器,然后在控制台输入 qs 命令。 如果插件安装正确,那么输入命令后会弹出帮助界面:

如果你碰到了报错,你可以浏览常见问题章节,或者加入我们的 Discord 聊天群组,在 #qsh-support 频道寻求帮助。
配置 QuickShop 以允许玩家使用
默认情况下,玩家无法创建商店。
要允许玩家创建和拥有商店,您必须授予他们必要的权限。
对大多数用户来说,你需要做的只是运行一个简单的命令:
/lp group default permission set quickshop.player true
然后就大功告成了! 玩家现在可以创建和使用商店,也可以使用其他功能。
对于进阶权限设置,请看这一章节。
一切就绪! 可以开始使用了!
现在,QuickShop-Hikari 正在您的服务器上运行。关于更多设置,请查看左侧的导航面板并阅读不同的部分。