- 版权类型
- 二次开发
- 插件中文名称
- FoliaPermsFork
- 插件英文名称
- FoliaPermsFork
- 支持的核心(服务端)
- Folia
- 语言支持
- English
- 适配版本(Java)
- 最新版本
- 26.x
[MD]
## 简介
FoliaPerms 是一款专为 **Folia** 多线程 Minecraft 服务端设计的轻量级权限管理插件。它提供了直观的权限系统,支持用户/用户组管理、权限继承、以及内置的 GUI 编辑器,无需任何外部依赖。
## 详细信息
### 功能特性
- ✅ **默认用户组** — 每位新玩家自动分配到 `default` 用户组
- ✅ **用户组继承** — 用户组可继承父组的权限(含循环依赖检测)
- ✅ **单用户组机制** — 每位玩家同时仅属于一个用户组
- ✅ **GUI 权限编辑器** — 游戏内图形界面管理权限
- ✅ **GUI 继承编辑器** — 可视化管理用户组继承关系
- ✅ **用户 & 用户组权限** — 支持为玩家或用户组添加/移除权限
- ✅ **YAML 持久化** — 所有数据存储于 `permissions.yml` 文件
- ✅ **通配符支持** — 支持通配符权限(如 `plugin.*`)
- ✅ **Folia 兼容** — 基于 Folia 线程模型构建
- ✅ **零依赖** — 独立运行,无需其他插件
### 适用版本
- Minecraft 服务端版本:**26.1.2**
- Paper API:**26.1.2**
- Java:**25+**
### 适用平台
- **Folia**(仅限 Folia,不支持 Bukkit/Spigot/Paper/Purpur)
### 支持语言
- 英文
### 命令列表
| 命令 | 描述 |
|------|------|
| `/fperm help` | 显示帮助菜单 |
| `/fperm reload` | 从文件重载权限 |
| `/fperm gather` | 收集所有插件的权限 |
| `/fperm refresh` | 刷新所有权限附件 |
| `/fperm user addperm <玩家> <权限>` | 为玩家添加权限 |
| `/fperm user removeperm <玩家> <权限>` | 移除玩家权限 |
| `/fperm user addgroup <玩家> <用户组>` | 将玩家加入用户组 |
| `/fperm user removegroup <玩家> <用户组>` | 将玩家移出用户组 |
| `/fperm group create <名称>` | 创建新用户组 |
| `/fperm group delete <名称>` | 删除用户组(`default` 不可删除) |
| `/fperm group addperm <名称> <权限>` | 为用户组添加权限 |
| `/fperm group adduser <名称> <玩家>` | 将玩家添加至用户组 |
| `/fperm group removeuser <名称> <玩家>` | 将玩家移出用户组 |
| `/fperm group setinherit <用户组> <父组>` | 设置用户组继承 |
| `/fperm group removeinherit <用户组> <父组>` | 移除继承关系 |
| `/fperm group inheritance <用户组>` | 查看继承链 |
| `/fperm group perms <用户组>` | 查看所有有效权限(含继承) |
| `/fperm check <玩家> <权限>` | 检查玩家是否拥有某权限 |
| `/fperm listperms <玩家>` | 列出玩家所有权限 |
| `/fperm editor` | 打开游戏内权限编辑器 GUI |
### 安装方式
1. 从 [GitHub Releases](https://github.com/MoRanYue/FoliaPermsFork/releases) 下载最新 JAR 文件
2. 将 JAR 放入服务端 `plugins/` 文件夹
3. 重启服务器(或使用插件管理器)
4. 通过命令或 GUI 编辑器配置权限
### 链接
- **GitHub**: [github.com/MoRanYue/FoliaPermsFork](https://github.com/MoRanYue/FoliaPermsFork)
- **文档**: [kaiakkmc.pages.dev/docs](https://kaiakkmc.pages.dev/docs)
- **问题反馈**: [Issue Tracker](https://github.com/MoRanYue/FoliaPermsFork/issues)
### 许可证
本项目基于 **MIT 许可证** 开源。
[/MD]