PermsCraft 是一款现代、高性能的 Minecraft 服务器权限插件,专为需要超越基础群组管理的管理员设计——支持上下文权限、临时头衔、多服务器同步以及面向外部工具的完整 REST API。
与那些将此类功能作为事后补充的插件不同,PermsCraft 从设计之初就围绕这些核心特性构建,同时保持日常命令足够简单,你无需打开 wiki 就能轻松创建群组。

? 安装指南
将 PermsCraft jar 文件放入你的 plugins 文件夹并重启服务器。首次启动时,请在控制台运行 /pc setup 以初始化你的首个管理员。PermsCraft 开箱即用,内置存储即可满足需求;但如果你运行的是代理网络(proxy network),它还支持 MySQL、SQLite 和 Redis 网络同步——如果计划使用这些高级存储方案,请在第一次重启前在 config.yml 中进行配置。
不确定是否安装正确? 在游戏中或控制台运行 /pc info ——它会打印当前活动的存储后端、已加载的上下文以及插件版本。
正在从其他插件迁移? 使用 /pc migrate <plugin> 自动导入现有的群组、用户和权限。
✅ 兼容性
PermsCraft 支持 Paper、Spigot、Purpur 和 Folia,适用于 Minecraft 1.21.x。Vault 和 PlaceholderAPI 为软依赖(Softdepends),均为可选——插件在无它们的情况下也能正常运行,但启用它们可分别解锁基于经济的上下文和占位符功能。
? 功能特性
- 晋升轨道(Tracks) — 创建头衔晋升轨道,通过单一命令提升或降低玩家在其中的等级
- 群组(Groups) — 创建、编辑和删除群组,支持权限、前缀、后缀、权重及继承关系
- 上下文权限(Contextual Permissions) — 将权限限定于世界、游戏模式、一天中的时间、在线时长或经济余额等特定范围
- 权限授予 GUI — 直接从游戏内菜单向任何玩家、群组或轨道授予或撤销权限
- REST API — 为外部工具和集成生成作用域受限的 API 密钥
- 近期日志(Recent Log) — 查看最近的权限变更,按操作类型着色区分
- 备份与还原(Backup & Restore) — 随时导出和导入所有数据(YAML 格式)
- 用户管理(Users) — 编辑玩家权限和所属群组,设置个人前缀/后缀,或在晋升轨道中调整等级
? 配置说明
大多数服务器只需在 config.yml 中选择存储后端即可,无需进行其他修改。上下文计算器(世界、游戏模式、一天中的时间、在线时长、经济)可单独启用或禁用,以便只激活你需要的部分。
? 如何报告问题
请使用页面顶部链接的问题追踪器(issue tracker)提交 bug 报告。请包含你的服务器版本、已安装的其他插件,以及相关控制台错误或日志——这将极大加快排查问题的速度。
注意:PermsCraft 正在积极开发中。部分 REST API 端点仍处于测试阶段(beta)——在生产环境中依赖它们之前,请查阅 wiki 以了解当前的稳定性状态。
PermsCraft is a modern, high-performance permissions plugin for Minecraft servers, built for admins who need more than basic group management — contextual permissions, temporary ranks, multi-server sync, and a full REST API for external tools.
Unlike plugins that bolt these features on as an afterthought, PermsCraft was designed around them from the start, while keeping the day-to-day commands simple enough that you don't need a wiki open just to create a group.

? Installation Guide
Drop the PermsCraft jar into your plugins folder and restart your server. On first boot, run /pc setup from console to bootstrap your first admin. PermsCraft works out of the box with the built-in storage, but supports MySQL, SQLite, and Redis network sync if you're running a proxy network — configure this in config.yml before your first restart if you plan to use it.
Not sure if it installed correctly? Run /pc info in-game or console — it'll print your active storage backend, loaded contexts, and plugin version.
Migrating from another plugin? Use /pc migrate <plugin> to import your existing groups, users, and permissions automatically.
✅ Compatibility
PermsCraft supports Paper, Spigot, Purpur, and Folia on Minecraft 1.21.x. Softdepends on Vault and PlaceholderAPI are optional — the plugin runs fine without them, but enabling them unlocks economy-based contexts and placeholders respectively.
? Features
- Tracks — Create rank progression tracks, promote and demote players through them with a single command
- Groups — Create, edit, and delete groups with permissions, prefix, suffix, weight, and inheritance
- Contextual Permissions — Scope permissions to world, gamemode, time of day, playtime, or economy balance
- Grant Permission GUI — Grant or revoke permissions to any player, group, or track directly from an in-game menu
- REST API — Generate scoped API keys for external tools and integrations
- Recent Log — View recent permission changes, color-coded by action type
- Backup & Restore — Export and import all data as YAML at any time
- Users — Edit player permissions and groups, set personal prefix/suffix, promote or demote on tracks
? Configuration
Most servers won't need to touch config.yml beyond picking a storage backend. Context calculators (world, gamemode, time of day, playtime, economy) can be toggled individually if you only want a subset active.
? How to Report Issues
Please use the issue tracker linked at the top of the page to report bugs. Include your server version, other installed plugins, and relevant console errors or logs — this makes it much faster to track down what's going on.
Note: PermsCraft is actively developed. Some REST API endpoints are still in beta — check the wiki for current stability status before relying on them in production.
评论 0
登录后参与评分
还没有评论,来抢沙发吧