- 版权类型
- 转载
- 插件中文名
- PermiX
- 插件英文名
- PermiX
- 支持的核心 [服务端]
- Forge
- 语言支持
- 中文(简体)
- 适配Minecraft版本 [Java]
- 1.21
[MD]
# PermiX
轻量、无依赖的 Spigot 权限组系统。集成图形界面、通配符权限、批量操作、TAB 列表与头顶名称显示，全部功能均由一个紧凑的类实现。
## 简介
PermiX 是一套小巧、完全独立的 **Spigot `1.21.1`** 权限管理系统。它不依赖 LuckPerms、PermissionsEx 或 Vault，整个权限引擎均基于原生 Bukkit/Spigot API 从零构建。
该插件适合不希望使用臃肿企业级权限插件架构的服务器管理员：核心逻辑集中在一个易读的 Java 类中，便于直接查看和修改，无需在大量包与接口之间查找代码。
## 功能
### 权限组
- 创建支持完整颜色代码的权限组：
- 常规颜色：`&a`–`&f`、`&0`–`&9`
- 格式代码：`&l`、`&m`、`&n`、`&o`、`&r`
- HEX 颜色：`&#RRGGBB`
- 每个权限组均拥有稳定的内部 ID，且不会受颜色影响。
- 使用相同名称并指定不同颜色重新执行创建命令，即可修改权限组颜色。
- 支持为玩家授予或移除权限组（`/permgive, /permtakeclass)`）。
- 同样支持离线玩家，数据通过 UUID 追踪。
### 权限管理
- 每个权限组都拥有独立的权限节点列表。
- 支持为单个玩家设置权限覆盖规则，包含三种状态：
- **ALLOW**：允许
- **DENY**：拒绝
- **INHERIT**：继承
- 权限优先级如下：
```text
玩家个人权限 → 权限组权限 → Bukkit 默认权限
```
- 支持通配符权限节点，例如 `essentials.*`。
- 当通配符与具体权限节点同时存在时，具体节点始终优先。
- 两个权限菜单均提供 **全部授予 / 全部移除** 按钮。
- 可立即设置全局 `*` 基准权限，即授予或拒绝全部权限。
- 更具体的权限规则仍可覆盖该全局设置。
- 支持切换通配符视图。
- 可将权限菜单从逐项列出全部节点，切换为按已检测插件显示 `plugin.*` 通配符。
- 可一键授予或撤销某个插件的整套权限。
- 每位玩家仅使用一个 `PermissionAttachment`。
- 每次权限变更时都会完整重建，避免权限累积或泄漏。
### 图形界面
图形界面基于原生 Bukkit Inventory API 构建，无需任何第三方库。
- 权限组列表菜单。
- 权限组权限菜单：
- 支持查看单独权限节点或插件级通配符。
- 支持分页。
- 玩家个人权限菜单：
- 同样支持单项节点与通配符两种视图。
- 通过不同颜色区分 ALLOW、DENY 与 INHERIT 状态。
- 内置 **配置编辑器**：
- 可直接在游戏内编辑 `config.yml`。
- 文本内容通过聊天栏输入。
- 完整防护物品移动操作，并提供分页、返回、下一页和关闭按钮。
### 权限组显示
- **TAB 列表**：支持完全自定义格式，默认变量格式为：
```text
%class% | %player%
```
- **头顶名称与计分板侧边栏**：
- 通过 Scoreboard Team 实现。
- 可与 TAB 列表独立开关。
- 可分别设置显示格式。
### 数据存储
- 所有数据均以 YAML 格式保存在 `data.yml` 中。
- 玩家通过 UUID 追踪，同时单独保存昵称，便于查看与管理。
- 数据可在服务器重启、`/permreload,` 以及玩家重新加入后继续保留。
### 本地化
所有面向玩家的消息均保存在 `messages.yml` 中。
- 默认提供英文内容。
- 可直接编辑语言文件，无需修改插件代码。
[/MD]
# PermiX
轻量、无依赖的 Spigot 权限组系统。集成图形界面、通配符权限、批量操作、TAB 列表与头顶名称显示，全部功能均由一个紧凑的类实现。
## 简介
PermiX 是一套小巧、完全独立的 **Spigot `1.21.1`** 权限管理系统。它不依赖 LuckPerms、PermissionsEx 或 Vault，整个权限引擎均基于原生 Bukkit/Spigot API 从零构建。
该插件适合不希望使用臃肿企业级权限插件架构的服务器管理员：核心逻辑集中在一个易读的 Java 类中，便于直接查看和修改，无需在大量包与接口之间查找代码。
## 功能
### 权限组
- 创建支持完整颜色代码的权限组：
- 常规颜色：`&a`–`&f`、`&0`–`&9`
- 格式代码：`&l`、`&m`、`&n`、`&o`、`&r`
- HEX 颜色：`&#RRGGBB`
- 每个权限组均拥有稳定的内部 ID，且不会受颜色影响。
- 使用相同名称并指定不同颜色重新执行创建命令，即可修改权限组颜色。
- 支持为玩家授予或移除权限组（`/permgive, /permtakeclass)`）。
- 同样支持离线玩家，数据通过 UUID 追踪。
### 权限管理
- 每个权限组都拥有独立的权限节点列表。
- 支持为单个玩家设置权限覆盖规则，包含三种状态：
- **ALLOW**：允许
- **DENY**：拒绝
- **INHERIT**：继承
- 权限优先级如下：
```text
玩家个人权限 → 权限组权限 → Bukkit 默认权限
```
- 支持通配符权限节点，例如 `essentials.*`。
- 当通配符与具体权限节点同时存在时，具体节点始终优先。
- 两个权限菜单均提供 **全部授予 / 全部移除** 按钮。
- 可立即设置全局 `*` 基准权限，即授予或拒绝全部权限。
- 更具体的权限规则仍可覆盖该全局设置。
- 支持切换通配符视图。
- 可将权限菜单从逐项列出全部节点，切换为按已检测插件显示 `plugin.*` 通配符。
- 可一键授予或撤销某个插件的整套权限。
- 每位玩家仅使用一个 `PermissionAttachment`。
- 每次权限变更时都会完整重建，避免权限累积或泄漏。
### 图形界面
图形界面基于原生 Bukkit Inventory API 构建，无需任何第三方库。
- 权限组列表菜单。
- 权限组权限菜单：
- 支持查看单独权限节点或插件级通配符。
- 支持分页。
- 玩家个人权限菜单：
- 同样支持单项节点与通配符两种视图。
- 通过不同颜色区分 ALLOW、DENY 与 INHERIT 状态。
- 内置 **配置编辑器**：
- 可直接在游戏内编辑 `config.yml`。
- 文本内容通过聊天栏输入。
- 完整防护物品移动操作，并提供分页、返回、下一页和关闭按钮。
### 权限组显示
- **TAB 列表**：支持完全自定义格式，默认变量格式为：
```text
%class% | %player%
```
- **头顶名称与计分板侧边栏**：
- 通过 Scoreboard Team 实现。
- 可与 TAB 列表独立开关。
- 可分别设置显示格式。
### 数据存储
- 所有数据均以 YAML 格式保存在 `data.yml` 中。
- 玩家通过 UUID 追踪，同时单独保存昵称，便于查看与管理。
- 数据可在服务器重启、`/permreload,` 以及玩家重新加入后继续保留。
### 本地化
所有面向玩家的消息均保存在 `messages.yml` 中。
- 默认提供英文内容。
- 可直接编辑语言文件，无需修改插件代码。
[/MD]