PermissionShopZ - 权限商店

简介

PermissionShopZ 是一款功能强大的 Minecraft 插件，允许玩家通过游戏内商店界面，使用游戏货币购买权限、临时权限、用户组或权限轨道升级。它提供了直观的 GUI 供玩家浏览和购买，以及完整的编辑系统供管理员配置商店内容。

💡重要须知

在下载和使用前，请务必了解以下要求

• 核心依赖：本插件必须安装 TabuuCore 和 Vault 才能运行。
• 经济系统：Vault 本身需要一个经济插件（例如 Essentials）来提供经济支持。
• 权限支持：原生支持 GroupManager、PermissionsEx、LuckPerms 和 Vault。其他权限管理器需进行自定义配置。
• 寻求帮助：评论区并非技术支持区。如果您遇到任何问题，请直接通过消息联系开发者。

🎮命令与权限

玩家命令

• /permissionshopz - 打开权限商店主界面。
• 别名：/pshop, /permissionshop
• 所需权限：permissionshopz.default (默认所有玩家拥有)

管理员命令

• /permissionshopz edit - 打开商店编辑器。
• /permissionshopz debuginfo - 显示插件当前状态信息。
• /permissionshopz save - 将所有数据保存并覆盖到本地数据库文件。
• /permissionshopz loaddata - 从文件读取并覆盖所有数据到插件。
• /permissionshopz cleandata - 清理所有插件未主动使用的数据。
• 所有管理员命令均需要权限：permissionshopz.admin (默认仅 OP 拥有)

🔧配置说明

核心配置 (config.yml)

• PermissionManager: 设置使用的权限管理器。可选值："VAULT", "GROUP_MANAGER", "PERMISSIONS_EX", "LUCK_PERMS", 或 "CUSTOM"。
• CustomPermissionCommand: 当 PermissionManager 设为 'CUSTOM' 时，购买权限后执行的命令。可使用 {PLAYER} 和 {PERMISSION} 占位符。
• GUISize: 设置商店 GUI 的大小，必须至少为 3 行。格式参考 InventorySize。
• UseTitle: 是否将提示信息以标题形式显示（而非聊天栏）。
• UseNumberSuffix 与 NumberSuffixes: 是否启用价格数字后缀（例如：k, M, B）及其配置。
• Icons: 配置各类物品的显示材质。
• UnlockedMaterial: 已解锁物品的材质（例如："IRON_BARS"）。
• NodeTypes: 各类节点在菜单中的显示材质。

语言文件 (lang.yml)

此文件用于自定义插件中所有显示的文本信息，包括

• GUI 界面标题、按钮文字。
• 商品（Perk）的标题、描述、价格显示。
• 各类节点（权限、组等）的显示格式。
• 操作成功或失败的信息提示。

✨功能特性

• 可视化商店：为玩家提供清晰、分页的 GUI 商店来购买权限。
• 多类型节点支持：商品可以奖励或要求以下节点类型：
• 永久权限 (Permission)
• 临时权限 (Temporary Permission)
• 用户组 (Group)
• 权限轨道等级 (Track)
• 灵活的编辑器：管理员可通过 GUI 轻松添加、编辑、删除商品和节点，无需直接修改配置文件。
• 条件购买：商品可以设置前置解锁条件（要求拥有其他特定节点）。
• 经济集成：通过 Vault 无缝接入服务器经济系统。
• 多权限管理器支持：原生兼容主流权限插件，并支持自定义命令。

⭐使用与配置步骤

• 安装前置插件：确保服务器已安装并正确运行 TabuuCore、Vault 以及一个 Vault 兼容的经济插件。
• 安装 PermissionShopZ：将插件放入服务器的 plugins 文件夹并重启服务器。
• 基础配置：根据服务器使用的权限插件，编辑 config.yml 中的 PermissionManager 选项。
• 创建商店：管理员在游戏中执行 /permissionshopz edit 打开编辑器，通过 GUI 添加商品并设置其价格、奖励节点和条件。
• 玩家使用：玩家执行 /permissionshopz 即可打开商店界面进行浏览和购买。

❓常见问题

• 问：插件安装后无法启动或报错？
• 答：请首先检查 TabuuCore 和 Vault 是否正确安装。确保经济插件已安装且 Vault 能成功连接到它。

• 问：我使用的权限插件不在原生支持列表中怎么办？
• 答：在 config.yml 中将 PermissionManager 设置为 "CUSTOM"，并在 CustomPermissionCommand 中配置您的权限插件添加权限的命令。

• 问：如何备份或迁移商店数据？
• 答：使用 /permissionshopz save 命令将数据保存到文件。数据文件位于插件数据文件夹中，可以复制进行备份或迁移。

• 问：玩家购买后没有获得权限？
• 答：请检查 config.yml 中的权限管理器设置是否正确。使用 /permissionshopz debuginfo 命令查看插件检测到的权限管理器支持情况。