zPermissions - 超级权限系统

zPermissions 是一款专注于权限管理的 Superperms（即 Bukkit 权限）插件，支持 SQL 数据库和平面文件存储。经过多年生产环境测试，它功能强大且稳定，提供了多世界支持、多晋升路径、深度组继承以及可选的区域特定权限等功能，旨在成为一个简单而功能全面的权限解决方案。

💡核心特性

• 多种存储选项：支持 SQL（如 PostgreSQL、MySQL、H2）和平面文件存储。默认的 Bukkit SQLite 不受支持，若使用将自动回退到平面文件。
• 组继承：组可以从多个父组继承权限。
• 多组成员：玩家可以同时属于多个组。权限应用的顺序由可配置的组权重决定。
• 多世界支持：可以为玩家和组设置特定世界的权限。
• 可选区域支持：权限可以与 WorldGuard 区域、Residence 住所、Factions 领地或 Factoid 土地关联。
• 多晋升路径：支持多个独立的晋升轨道，并可限制谁能在哪些轨道上进行晋升/降级操作。
• 短期权限与组：可以为玩家设置持续数秒到数分钟的临时权限，或设置具有特定持续时间（如1天到1年）的临时组分配。
• 聊天前缀与后缀：可为玩家和组分配聊天前缀和后缀（需要配合 Vault 兼容的聊天格式化插件，如 Herochat、zChat）。
• API：提供全面的只读 API，也推荐开发者通过 Vault 进行调用。
• 元数据支持：可为玩家和组关联任意元数据（字符串、整数、浮点数、布尔值），可通过原生 API 或 Vault Chat API 查询。
• 自动组权限：可自动为每个组设置基于组名的权限（默认为 group.<组名>），便于与 WorldEdit 和 WorldGuard 等插件开箱即用地配合。
• 可重分配默认组：默认组（分配给未明确指定组的玩家）名为 default，且可以更改。

❓概念说明

• 组的通用性：组是“通用”的，跨所有世界生效，暂无引入世界特定组的计划。
• 权限层级：权限分为 4 个“层级”，按从通用到具体的顺序应用：
• 通用组权限
• 世界特定组权限
• 区域特定组权限
• 区域与世界特定组权限
• 通用玩家权限
• 世界特定玩家权限
• 区域特定玩家权限
• 区域与世界特定玩家权限
• 多组与权重：玩家可属于多个组。组可分配权重，权重越高，其权限越晚应用（即覆盖较早的组）。权重相同的组按字母顺序应用。
• 组继承：组可以从一个或多个父组继承。父组的应用顺序是反向的，因此第一个父组的权限会覆盖后续父组。

⭐安装与使用

• 将 zPermissions.jar 放入服务器的 plugins 目录并启动服务器。
• 首次运行会在 plugins/zPermissions 目录下生成 config.yml 文件，可在此编辑默认组和默认轨道设置，并创建你的晋升轨道。
• 在游戏中输入 /permissions 开始使用（/perm 或 /p 也可能可用，取决于别名设置）。

权限节点格式

在 get、set 和 unset 子命令中，权限节点可按以下方式指定：

• <permission> - 未限定的权限节点，适用于所有世界和所有区域。
• <world>:<permission> - 使权限特定于某个世界，在世界名称后加冒号前缀。
• <region>/<permission> - 使权限特定于某个区域，在区域名称后加斜杠前缀。
• <region>/<world>:<permission> - 使权限同时特定于某个区域和世界。目前，区域限定符必须始终在前。

等级命令

等级命令包括 /promote、/demote、/setrank 和 /unsetrank，默认会向所有管理员广播变更。

• 使用 -q 选项可静默操作（例如被自动化流程调用时），但操作仍会记录到服务器日志中以便审计。
• 使用 -Q 选项则会将变更广播给所有用户。

使用 SQL 数据库（1.4+ 版本）

在 plugin.yml 中配置数据库连接和表名映射，示例如下：

database:
  username: minecraft_93076
  isolation: SERIALIZABLE
  driver: com.mysql.jdbc.Driver
  password: ---
  url: jdbc:mysql://minecraft091.verygames.net/minecraft_93076
tables:
  ToHSchemaVersion: zp_schema_version
  Entry: zp_entries
  Membership: zp_memberships
  PermissionEntity: zp_entities
  PermissionRegion: zp_regions
  PermissionWorld: zp_worlds
  EntityMetadata: zp_metadata
  Inheritance: zp_inheritances
  DataVersion: zp_data_version

🎮更多文档

• 权限列表
• 详细命令用法
• 临时权限与组
• 自定义表名
• Vault 支持
• 插件开发者指南
• 架构更新说明

🔧许可与源码

zPermissions 基于 Apache License, Version 2.0 发布。

源码可在 GitHub 找到

• zPermissions
• ToHPluginUtils

本项目的开发构建版本可在提供的持续集成服务器获取：zPermissions-standlone

✨其他资源与支持

• Townships - 融合 Factions 和 Towny 特色的最佳领地所有权插件！
• Heroes Premium - 最佳 Minecraft 职业与技能 RPG 插件！

遇到问题？

• 首先，请查看已知问题和 FAQ。
• 如果仍有疑问，请在论坛发帖。
• 对于任何 Bug 或问题，请创建工单。
• 除非我们已相识，否则私信将被忽略。