原创 付费 FlPermissionShop - 权限商店插件

FlPermissionShop - 权限商店插件 Wiki (v1.0.12)​

核心功能一览（讲人话版）​

• 多样化支付 支持金币 (Vault)、点券 (PlayerPoints)、经验等级，甚至还能要求玩家拿出特定的物品（支持匹配名字和 Lore）。
• 翻页商店 一个商店文件里可以写几十个商品，插件会自动帮你生成“上一页”、“下一页”按钮。
• 链式解锁 想让玩家必须买了“VIP1”才能买“VIP2”？一行配置搞定。
• 购买锁定 买过的东西可以变成“已购买”的图标，防止玩家手滑重复花钱。
• 异步操作 保存数据不卡服，给服务器减轻负担。

​

配置文件怎么写？​

商店文件存放在 plugins/FlPermissionShop/shops/ 目录下，按以下规则配置即可快速搭建专属商店。

▸ 1. 基础信息配置​

shop:
id: "my_shop" # 商店的身份证，不能重复
name: "&6我的高级商店" # 菜单顶部的名字（支持颜色码）
rows: 3 # 菜单有几行（1-6行）
open-sound: "BLOCK_CHEST_OPEN" # 开菜单时的声音

▸ 2. 物品消耗：按名字和 Lore 扣除​

这是本插件的强项！你可以要求玩家必须提交特定的“入场券”或“凭证”：

cost:
items:
- material: "PAPER" # 物品材质
amount: 1 # 数量
name: "&e晋升凭证" # 【可选】必须叫这个名字才行
lore: # 【可选】Lore 也必须一模一样才行
- "&7用于升级的凭证"

提示：如果你不写 name 和 lore，那玩家只要拿着普通的纸就能过关。

▸ 3. 翻页功能 (Pagination)​

如果你商品很多，开启翻页功能提升体验：

pagination:
enabled: true # 开启翻页
prev-slot: 18 # 上一页按钮放哪（0-53）
next-slot: 26 # 下一页按钮放哪
在商品里指定页码：

items:
item_on_p1:
page: 1 # 第一页
display: { slot: 10, ... }
item_on_p2:
page: 2 # 第二页
display: { slot: 10, ... }

▸ 4. 前置条件 (Prerequisites)​

实现“先买 A 才能买 B”的链式解锁逻辑：

items:
level_2:
prerequisites:
- "my_shop.level_1" # 格式：商店ID.商品ID

安装要求​

Java 版本：必须使用 Java 21 或更高版本。核心依赖：Vault (用于金币消耗) ★PlayerPoints (可选，用于点券消耗)PlaceholderAPI (可选，用于支持更多变量)

常用指令​

• /flps open <商店ID> - 为自己打开某个商店。
• /flps open <商店ID> <玩家名> - 给别人远程打开商店。
• /flps reload - 重载所有配置文件（改完配置点一下，立即生效）。
• /flps list - 看看现在加载了哪些商店。

变量支持 (Placeholder)​

在菜单的 Lore 或奖励指令里，你可以使用以下变量，自动适配玩家状态：

• %player% - 玩家名字。
• %cost_money% - 需要的金币数。
• %need_items% - 缺少的物品（会自动显示你配置的物品名）。
• %buy_status% - 显示“可购买”或“条件不足”。

​

自动刷新：如果你的 Lore 中使用了 %need_money% 等变量，建议设置 refresh_ticks: 20（每秒刷新一次），这样玩家金币变动时 GUI 会实时更新。前置系统：你可以利用 prerequisites 制作升级树。例如：必须买了 vip1 才能买 vip2。物品消耗：物品消耗支持匹配 NBT 和 DisplayName，非常适合作为“令牌”或“兑换券”来兑换权限。 反馈与支持如果您在使用过程中遇到任何问题，请随时联系开发者。祝您使用愉快！