我的世界

LuckPerms 服务器权限管理插件

LT-YHC

2026-08-13 13:33:30 · 更新于 2026-08-21 01:18:05 · 10 浏览 · 1 回复

LuckPerms
Minecraft 服务器权限管理插件。通过创建分组、分配权限节点，精确控制玩家能够使用的功能。支持 Bukkit/Spigot/Paper、BungeeCord、Sponge、Fabric、Forge、NeoForge、Nukkit 与 Velocity 等服务器平台，被社区数千家服务器及大型网络广泛使用。

为什么选择 LuckPerms
性能优异：开发之初即以性能与可扩展性为核心，几乎所有操作均采用多线程执行，权限查询与元数据查找均有缓存。
稳定可靠：被数千名服主及大型服务器网络信任。
易于上手：可通过游戏内命令、配置文件或网页编辑器三种方式管理权限，默认配置已满足大多数服务器需求。
灵活高效：支持多种数据存储后端，兼容各类服务器平台。
高度可定制：提供大量自定义选项，可根据服务器需求精细调整。
永久免费：采用宽松许可证，可免费下载与使用。

核心功能
群组与权限体系
创建群组（Group），为群组分配权限节点，再将玩家加入群组，实现批量权限管理
群组间支持继承（父群组权限被子群组继承），构建层级化的权限阶梯
通过权重（Weight）解决多群组归属时的优先级冲突，权重更高的群组在前缀/后缀显示中胜出
支持基于上下文（Context）的精细化控制：权限可随世界、游戏模式或其他注册的上下文计算器动态变化
支持服务器级与世界级（per-world）覆盖，实现跨服或单服差异化权限
网页编辑器（Web Editor）

除了游戏内/控制台命令界面，LuckPerms 提供网页版编辑器，开箱即用，无需额外部署：
在游戏内或控制台执行 /lp editor
插件生成一次性 URL
在浏览器中打开，可视化编辑群组、权限、前缀、上下文
点击保存，将回贴命令粘贴回控制台或游戏内
变更立即生效
编辑器由 LuckPerms 团队托管，数据在回贴前不会离开你的服务器，编辑仅存在于浏览器会话中。
实时权限追踪（Verbose）

LuckPerms 内置 verbose 系统，可实时监控其他插件发起的权限检查，精确到触发检查的代码行。录制结果可上传至网页应用，便于分析排查权限问题。
权限树（Permission Trees）

基于插件注册到服务器的权限节点，构建完整的"权限树"。可根据玩家是否拥有某项权限进行颜色标记，直观可视化玩家拥有的权限集合。
操作日志与审计
详细记录所有权限变更操作
可按用户、群组或追踪轨道查询历史
可审查指定管理员执行过的所有操作，便于追溯滥用行为
支持回滚到早期状态
元数据与聊天变量
为群组/玩家设置前缀（prefix）、后缀（suffix）与 meta 值
这些数据可被聊天插件、计分板、Tab 列表格式化插件读取显示
跨服同步
在 BungeeCord 或 Velocity 代理端安装 LuckPerms 后，玩家权限可在后端服务器之间实时同步——玩家的权限等级会跟随其在大厅、生存服、小游戏服之间切换
支持配置消息服务（Messaging Service）实现多服务器间的实时更新推送，可选 SQL、Redis、RabbitMQ、NATS 或插件消息通道

数据存储后端

LuckPerms 的数据默认存储在插件文件夹外，便于在网络中的多台服务器/代理之间共享。存储后端在 config.yml 中切换：
远程数据库（适合跨服网络）
MySQL / MariaDB（MariaDB 略优于 MySQL）
PostgreSQL
MongoDB

优势：允许数据在多个服务器之间共享；带有索引，处理批量查询与更新时效率更高；能处理更大量的数据，支持频繁读写。
本地数据库（开箱即用）
H2（略优于 SQLite，默认选项）
SQLite

数据存储在单一文件中（H2 为 luckperms-h2.mv.db，SQLite 为 luckperms-sqlite.db），必须通过插件命令浏览或编辑，不能直接像文本文件那样手工修改。
可读文本文件（适合小型单服）
YAML（.yml）
JSON（.json）
HOCON（.conf）
TOML（.toml）

文件可在服务器运行时直接编辑，改动自动生效。

安装步骤
单服务器（Paper / Spigot）
从 Modrinth 项目页或 luckperms.net 下载对应平台的构建版本（Bukkit/Spigot/Paper 构建）
将 jar 文件放入服务器 plugins/ 目录
启动服务器一次，让 LuckPerms 生成配置文件
停止服务器，按需修改 plugins/LuckPerms/config.yml
再次启动服务器
建议使用重启而非 /reload，后者可能破坏插件状态。
跨服网络（Velocity / BungeeCord + 后端）
在代理端与每个后端服务器均安装对应的 LuckPerms 构建
所有节点在 config.yml 中指向同一个 MySQL/MariaDB 数据库
配置 messaging-service 以实现实时更新同步
重启代理与所有后端服务器
切换存储后端
在当前后端下执行 /lp export 备份文件导出数据
修改 config.yml 中的 storage-method
重启服务器加载新后端
执行 /lp import 备份文件导入数据

server: global # 服务器名称，用于服务器级权限；设为 global 则此设置被忽略
storage-method: h2 # 存储后端：h2/sqlite/mysql/mariadb/postgresql/mongodb/yaml/json/hocon/toml
messaging-service: sql # 消息服务：none/sql/redis/rabbitmq/nats/pluginmsg
sync-minutes: 3 # 定期同步间隔（分钟）
auto-push-updates: true # 权限变更时自动推送

典型用例：4 级权限阶梯

以下是一个中小服务器常用的权限层级搭建示例：

default (权重 0) → donator (权重 100) → moderator (权重 500) → admin (权重 1000)

相关资源
官方网站：luckperms.net
百科文档：luckperms.net/wiki
网页编辑器：editor.luckperms.net
源代码与问题反馈：GitHub

帖子制作 by LT-YHC

LuckPerms 服务器权限管理插件

评论 (0)

{{title}}

LuckPerms 服务器权限管理插件

评论 (0)

打赏支持

打赏记录

举报内容

编辑版本

{{title}}