꧁ PlayerVaults - GUI ꧂ - PlayerVaults - GUI 玩家仓库图形界面

简介

PlayerVaultsGUI 是一款为 PlayerVaultsX 插件设计的图形界面（GUI）增强插件。它提供了一个美观易用的菜单，让玩家可以直观地查看、打开和购买个人仓库。管理员可以完全自定义 GUI 的外观、物品、价格和消息，并支持通过权限或物品来管理访问。

💡主要功能

• 为 PlayerVaultsX 提供直观的图形化菜单界面。
• 玩家可直接在 GUI 中打开已解锁的仓库或购买新的仓库。
• 支持为每个仓库设置独立的购买价格。
• 高度可定制：可配置 GUI 标题、填充物品、按钮样式、提示信息等。
• 支持给予玩家特殊的“钥匙”物品来打开 GUI 菜单。
• 提供管理员命令，用于管理玩家的仓库数量。
• 可禁用购买功能，或将其设置为权限控制。

🎮命令与权限

玩家命令

• /pvgui

打开仓库 GUI 菜单。

• 权限: playervaults.gui.open

• /pvbuy <仓库编号>

购买指定编号的仓库。

• 权限: playervaults.gui.buy

管理员命令

• /pvadmin <add/take> <玩家名> <数量>

为指定玩家增加或减少其拥有的仓库数量。

• 权限: playervaults.gui.admin

• /pvgive <玩家名> <数量>

给予指定玩家一定数量的 GUI 菜单钥匙物品。

• 权限: playervaults.gui.admin

• /pvguireload

重载插件的配置文件。

• 权限: playervaults.gui.admin

✨配置详解

以下为配置文件 config.yml 的核心内容与说明：

基础设置

override-pv: false
openOnVaultClose: false
disablePurchases: false

• override-pv: 是否覆盖 PlayerVaultsX 的原生命令。
• openOnVaultClose: 关闭一个仓库后是否自动重新打开 GUI 菜单。
• disablePurchases: 是否全局禁用购买功能（可配合权限使用）。

GUI 菜单设置

gui:
  name: "&f[&4Player Vaults Menu&f]"
  fillitem: "STAINED_GLASS_PANE:15"

• name: GUI 菜单的标题。
• fillitem: 用于填充菜单空格的物品。

仓库按钮设置

• unlocked: 已解锁仓库按钮的显示名称、物品和描述。
• locked: 未解锁（可购买）仓库按钮的显示名称、物品和描述。
• 描述中可使用变量 <VAULTNUM>（仓库编号）和 <COST>（价格）。

钥匙物品设置

key:
  consume: false
  firstJoin: true
  name: "&f[&4Player Vaults Menu&f]"
  item: 'CHEST:0'

• consume: 使用钥匙打开 GUI 时是否消耗该物品。
• firstJoin: 是否在玩家首次加入服务器时给予一把钥匙。
• name 与 item: 钥匙物品的显示名称和材质。

消息提示

可自定义各种操作反馈消息，如购买成功 (buySuccess)、资金不足 (insufficientFunds) 等。

价格设置

defaultcost: 10000
vaults:
  1:
    cost: 250
  2:
    cost: 500

• defaultcost: 未单独设置价格的仓库将使用的默认价格。
• 在 vaults 节点下可为每个仓库编号单独设置 cost（购买价格）。

布局矩阵

defaultMatrix: true
matrix:
  - '         '
  - ' xxxxxxx '
  - 'b       f'

• defaultMatrix: 是否使用默认布局。
• matrix: 自定义布局矩阵。x 代表仓库按钮位，b 和 f 代表前后翻页按钮位。

🔧安装与需求

前置需求

• Vault 插件
• PlayerVaultsX 插件

安装步骤

• 确保服务器已安装并运行上述两个前置插件。
• 将 PlayerVaultsGUI.jar 放入服务器的 plugins 文件夹。
• 重启服务器以生成配置文件。
• 根据需求编辑 plugins/PlayerVaultsGUI/config.yml 文件。
• 使用 /pvguireload 重载配置或重启服务器使更改生效。

❓常见问题与提示

• 如何完全禁用购买？

将配置文件中的 disablePurchases 设置为 true，或将所有仓库的 cost 和 defaultcost 都设为 0。

• 如何让玩家自定义按钮？

拥有 playervaults.gui.customize 权限的玩家可以在 GUI 中自定义其仓库按钮的显示物品和名称。

• 购买功能可以设置权限吗？

可以。将 disablePurchases 设为 true，然后只给特定玩家 playervaults.gui.buy 权限，即可实现权限化购买。

• 变量 <VAULTNUM> 和 <COST> 在哪里使用？

它们主要用于配置文件中 locked 和 unlocked 按钮的 lore（描述文本）里，用于动态显示仓库编号和价格。