
CustomPerm 允许服务器向非管理员(non-op)玩家授予单一命令权限:例如给建造者 /gamemode 权限,给管理员 /tp 权限,除此之外不再给予其他权限。支持等级、别名、速率限制以及完整的游戏内界面,可与或不可与 LuckPerms 配合使用。
按命令逐步授予权限。

一条命令一个节点: 暴露任意原版或模组命令,并通过授予 customperm.command.<name> 节点来授权。
等级(Grades): 将玩家分组,并为每个等级分别设置 ALLOW(允许)和 DENY(拒绝)节点。
玩家节点(Player nodes): 针对单个玩家的例外情况,无需为此创建新的等级。
可限制的管理员权限: 显式的 DENY 节点同样适用于管理员:即使意外被赋予 op 身份,也不会开放任何未明确授权的命令。
全量门控: 可选功能,使所有命令(包括管理员)都受其对应节点的管控。
独立运行: 无需 LuckPerms:等级配置保存在可读的 JSON 文件中,并支持热重载。

别名(Aliases): 将多个命令合并为一个,例如 /spawn 或 /kit,并拥有独立的权限节点。
参数(Arguments): 如 /heal <player>:支持玩家名称、数字和文本,并进行验证与补全。
速率限制(Rate limits): 例如每小时允许某命令执行三次,按玩家单独计算。
按等级或玩家设置: VIP 等级可获得更多使用次数,而受信任的玩家可能完全不受限制。
重启后保留计数: 计数器在服务端重启后依然保留,因此重新连接不会重置使用次数。

全游戏内操作: /customperm gui 用于管理等级、玩家、命令、别名和限制。
默认简洁: 仅显示日常控制选项;“高级”或“自定义”模式才会展示其余功能。
委派管理员: 按区域读写权限:例如版主只能查看日志,无法查看等级信息。
活动日志: 记录每项管理员操作和玩家命令,支持在游戏内搜索。
清晰告警: 若配置文件损坏或 LuckPerms 服务中断,会明确提示问题及解决步骤。
继承与权重: 等级之间可相互继承并决定优先级,且可拒绝继承父级权限。
按世界设置: 节点、等级或前缀可限定于特定维度或游戏模式。
临时权限: grade assign Steve vip 30d:到期自动失效。
晋升阶梯: 沿阶梯进行晋升与降级,每条阶梯对应一个节点。
聊天前缀: 支持带优先级的聊天前缀与后缀,以及昵称。
元数据: 供其他模组读取的玩家属性值,例如家园数量限制。
LuckPerms: 当安装时由它主导决策;CustomPerm 仍会暴露相关命令与别名。
LuckPerms 编辑器: 可直接通过界面编辑组、玩家和晋升阶梯。
导入与导出: 分两步校验检查,将等级数据在 CustomPerm 与 LuckPerms 之间迁移。
集群模式: 多台服务器通过同一数据库共享等级、别名和限制。
永不卡顿: 即使数据库响应缓慢也不会阻塞服务器:变更先排队等待,随后应用。
公共 API:读取权限、等级和元数据,并通过事件跟踪变更。
安全写入:默认关闭,按模组单独启用,所有变更均记录日志。
其他模组的检查:根据你自己的等级响应 NeoForge 中其他模组的权限检查请求。
1. 将 jar 文件放入服务器的 mods 文件夹,并放入管理员客户端以使用界面。
2. 从控制台执行:customperm grade create admins,然后执行 customperm grade addperm admins customperm.*。
3. 执行 customperm grade assign <name> admins,然后在游戏中打开 /customperm gui。
4. 在 Commands(命令)页面,暴露你的第一个命令并将其节点授予某个等级。
遇到问题或有想法?提交 Issue。

CustomPerm 允许服务器逐个命令地将非 OP 玩家的指令权限委托给他们:例如让建造者使用 /gamemode,让管理员使用 /tp,仅此而已。支持等级、别名、限制以及完整的游戏内界面,无需 LuckPerms 也可运行。
逐命令管理权限。
一个命令,一个节点:暴露任意命令,授予 customperm.command.<name> 即可。
等级:将玩家分组,并为每个等级分配其 ALLOW 和 DENY 节点。
单个玩家的节点:为单个玩家设置例外,无需创建新等级。
可限制的 OP:明确的 DENY 同样适用于 OP:误操作不会开启任何权限。
完全锁定:可选功能,每条命令都受其节点控制,包括 OP。
独立运行:无需 LuckPerms:等级存储在可读的 JSON 文件中,支持热重载。
别名: 多条命令合为一,如 /spawn 或 /kit,并拥有独立的节点。
参数: /heal <玩家>:支持玩家、数字和文本,具备验证与自动补全功能。
使用限制: 允许每位玩家每小时仅能使用三次该命令。
按权限组或玩家: VIP 权限组拥有更多使用次数,受信任的玩家则无任何限制。
重启后保留: 计数器在服务端重启后依然存在:重新连接不会将计数归零。
游戏内操作: 通过 /customperm gui 在遊戲中直接管理权限组、玩家、命令、别名及限制。
默认简洁: 默认仅显示核心功能;切换至“高级”或“自定义”模式可查看其余选项。
委派管理员: 基于区域的读写权限:例如版主只能查看日志,无法修改权限组。
活动日志: 记录每项管理员变更及玩家使用的命令,均可在游戏内查阅。
清晰警报: 若配置文件损坏或 LuckPerms 出现故障,系统将明确提示问题所在及解决方法。
继承与权重: 权限组之间可相互继承并设定优先级,也可拒绝父级权限。
按世界限定: 节点、权限组或前缀可限制于特定维度或游戏模式。
临时权限: 执行 grade assign Steve vip 30d 后,权限将在指定时间后自动过期。
Tracks(追踪): 在等级阶梯上进行晋升或降级,每个 Track 对应一个节点。
聊天前缀: 支持带有优先级设置的前缀与后缀,以及昵称功能。
Meta(元数据): 供其他模组读取的玩家自定义数值,例如家园数量限制。
LuckPerms: 若已安装,由 LuckPerms 决定权限;CustomPerm 始终暴露命令和别名。
LuckPerms 编辑器: 通过界面修改组、玩家和轨道(tracks)。
导入和导出: 分两步验证,将你的等级迁移至或从 LuckPerms 导入/导出。
集群模式: 多个服务器通过数据库共享等级、别名和限制。
永不阻塞: 缓慢的数据库绝不会阻塞服务器:变更会等待,然后应用。
公共 API: 读取权限、等级和元数据,并通过事件监听变更。
安全写入: 默认禁用,按模组逐个授权,每次变更均记录日志。
其他模组测试: 响应来自你等级的其他 NeoForge 模组的权限测试。
1. 将 jar 文件放入服务器的 mods 文件夹,并放入管理员客户端以使用界面。
2. 从控制台执行:customperm grade create admins,然后 customperm grade addperm admins customperm.*。
3. 执行 customperm grade assign <name> admins,然后在游戏中打开 /customperm gui。
4. 在“命令”页面,暴露你的第一个命令并将其节点授予某个等级。
遇到问题或有想法?提交工单。

作者 / Auteur: THEFricadelle | 许可证 / Licence: 保留所有权利

CustomPerm lets a server hand out single commands to players who are not operators: /gamemode to builders, /tp to moderators, nothing more. Grades, aliases, rate limits and a full in-game interface, with or without LuckPerms.
Permissions, command by command.

One command, one node: expose any vanilla or modded command, grant customperm.command.<name>.
Grades: group players and give each grade its ALLOW and DENY nodes.
Player nodes: one exception for one player, without inventing a grade.
Restrictable ops: an explicit DENY binds operators too: an accidental op opens nothing.
Gate everything: optionally, every command follows its node, ops included.
Works alone: no LuckPerms needed: grades live in readable JSON files, reloaded live.

Aliases: turn several commands into one, like /spawn or /kit, with its own node.
Arguments: /heal <player>: players, numbers and words, validated and completed.
Rate limits: allow a command three times an hour, per player.
Per grade or player: a VIP grade gets more uses, a trusted player none at all.
Kept on restart: counts survive restarts, so reconnecting resets nothing.

Everything in game: /customperm gui manages grades, players, commands, aliases and limits.
Simple by default: the everyday controls only; Advanced or Custom shows the rest.
Delegated admins: read and change rights per area: a moderator sees logs, not grades.
Activity log: every admin change and player command, searchable in game.
Clear alerts: a damaged file or a LuckPerms outage is reported with what to do.
Inheritance and weights: grades inherit and outrank each other, and can refuse a parent.
Per world: a node, grade or prefix limited to a dimension or a game mode.
Temporary: grade assign Steve vip 30d: it expires on its own.
Tracks: promote and demote along a ladder, with a node per track.
Chat prefixes: prefixes and suffixes with priorities, and nicknames.
Meta: values other mods read per player, like a home limit.
LuckPerms: when installed, it decides; CustomPerm still exposes commands and aliases.
LuckPerms editor: groups, players and tracks edited from the interface.
Import and export: move your grades to or from LuckPerms, in two checked steps.
Cluster mode: several servers share grades, aliases and limits through one database.
Never frozen: a slow database never holds the server: changes wait, then apply.
Public API: read permissions, grades and meta, and follow changes through events.
Safe writes: off by default, allowed mod by mod, every change logged.
Other mods' checks: answers the NeoForge permission checks of other mods from your grades.
1. Put the jar in the server's mods folder, and on your admins' clients for the interface.
2. From the console: customperm grade create admins, then customperm grade addperm admins customperm.*.
3. customperm grade assign <name> admins, then open /customperm gui in game.
4. On the Commands page, expose your first command and give its node to a grade.
A problem or an idea? Open an issue.

CustomPerm permet à un serveur de confier des commandes une par une à des joueurs non opérateurs : /gamemode aux bâtisseurs, /tp aux modérateurs, rien de plus. Grades, alias, limites et une interface complète en jeu, avec ou sans LuckPerms.
Les permissions, commande par commande.
Une commande, un nœud : exposez n'importe quelle commande, accordez customperm.command.<nom>.
Grades : regroupez les joueurs et donnez à chaque grade ses nœuds ALLOW et DENY.
Nœuds par joueur : une exception pour un seul joueur, sans inventer de grade.
Ops restreignables : un DENY explicite s'applique aussi aux opérateurs : un op par erreur n'ouvre rien.
Tout verrouiller : en option, chaque commande suit son nœud, ops compris.
Fonctionne seul : sans LuckPerms : les grades vivent dans des fichiers JSON lisibles, rechargés à chaud.
Alias : plusieurs commandes en une, comme /spawn ou /kit, avec son propre nœud.
Arguments : /heal <joueur> : joueurs, nombres et mots, validés et complétés.
Limites d'usage : autorisez une commande trois fois par heure, par joueur.
Par grade ou joueur : un grade VIP a plus d'utilisations, un joueur de confiance aucune limite.
Gardées au redémarrage : les compteurs survivent aux redémarrages : se reconnecter ne remet rien à zéro.
Tout en jeu : /customperm gui gère grades, joueurs, commandes, alias et limites.
Simple par défaut : seulement l'essentiel ; Avancée ou Personnalisée montre le reste.
Admins délégués : droits de lecture et de modification par zone : un modérateur voit les journaux, pas les grades.
Journal d'activité : chaque changement d'admin et commande de joueur, consultables en jeu.
Alertes claires : un fichier abîmé ou une panne de LuckPerms est signalé avec quoi faire.
Héritage et poids : les grades héritent et priment les uns sur les autres, et peuvent refuser un parent.
Par monde : un nœud, un grade ou un préfixe limité à une dimension ou un mode de jeu.
Temporaire : grade assign Steve vip 30d : il expire tout seul.
Tracks : promouvoir et rétrograder sur une échelle, avec un nœud par track.
Préfixes de chat : préfixes et suffixes avec priorités, et surnoms.
Meta : des valeurs que d'autres mods lisent par joueur, comme un nombre de homes.
LuckPerms : s'il est installé, il décide ; CustomPerm expose toujours commandes et alias.
Éditeur LuckPerms : groupes, joueurs et tracks modifiés depuis l'interface.
Import et export : faites passer vos grades vers ou depuis LuckPerms, en deux étapes vérifiées.
Mode cluster : plusieurs serveurs partagent grades, alias et limites via une base de données.
Jamais figé : une base lente ne bloque jamais le serveur : les changements attendent, puis s'appliquent.
API publique : lisez permissions, grades et meta, et suivez les changements par événements.
Écritures sûres : désactivées par défaut, autorisées mod par mod, chaque changement journalisé.
Tests des autres mods : répond aux tests de permission NeoForge des autres mods depuis vos grades.
1. Placez le jar dans le dossier mods du serveur, et sur le client de vos admins pour l'interface.
2. Depuis la console : customperm grade create admins, puis customperm grade addperm admins customperm.*.
3. customperm grade assign <nom> admins, puis ouvrez /customperm gui en jeu.
4. Sur la page Commandes, exposez votre première commande et donnez son nœud à un grade.
Un problème ou une idée ? Ouvrez un ticket.

Author / Auteur: THEFricadelle | License / Licence: All Rights Reserved
下载 CustomPerm
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CustomPerm
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CustomPerm
下载 CustomPerm
下载 CustomPerm
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CustomPerm
CustomPerm 2.5.1
新增
- 支持 NeoForge 26.3 — CustomPerm 为 Minecraft 26.3(NeoForge 26.3.0.103,Java 25)构建的模组与 1.21.1 版本并存。命令、权限、管理界面以及 LuckPerms 集成在 26.3 上的行为与 1.21.1 一致。集群模式仅直连其数据库:由于 Arcadia Lib 没有 26.3 的构建版本,因此在该版本中不提供其连接选项。
- 模组列表中的徽标 — “模组”屏幕在两个版本上均显示 CustomPerm 横幅(在 26.3 上声明为
bannerFile,其中logoFile已被弃用)。
更改
- 仓库结构 — 纯 Java 代码(权限解析、配置模型、集群存储、速率限制)已移至
core/目录,并编译到每个目标版本;每个 Minecraft 版本都是独立的 Gradle 项目(neoforge-1.21.1/、neoforge-26.3/)。对服务器端无任何影响。 - Jar 文件名包含目标平台标识 —
customperm-neoforge-1.21.1-<version>.jar和customperm-neoforge-26.3-<version>.jar,从而避免混淆同一版本的两个构建包。更新时请像往常一样从mods/目录中移除旧的customperm-<version>.jar。 - 26.3 上 LuckPerms 的
world上下文 — LuckPerms 5.5 将其world上下文设置为维度(通过其world-rewrite机制),而不再是存档名称。导入功能仍会遗留world节点,但现在会说明原因;带有 LuckPermsdimension-type上下文的节点按原有方式导入。
修复
-
/customperm debug不再因内部错误而失败 — 在使用 LuckPerms 的情况下,对于公开命令且玩家未持有明确值的情况,该命令此前会报错而非返回报告。 -
二次重载提示“正在重载” — 当
/customperm reload在另一次重载尚未完成时启动,可能会返回之前重载的磁盘错误信息,而非正确提示Reload already in progress。 -
26.3 上的集群建议 — 在 Minecraft 26.3 上(Arcadia Lib 无构建版本),集群警报不再提示管理员安装它,而是指向直连选项。
-
支持 NeoForge 26.3 — CustomPerm 已针对 Minecraft 26.3(NeoForge 26.3.0.103,Java 25)进行编译,同时也支持 1.21.1。命令、权限、管理界面以及 LuckPerms 集成在 26.3 中的行为与 1.21.1 保持一致。集群模式仅直连其数据库:由于 Arcadia Lib 没有提供 26.3 的构建版本,因此未在此版本中提供连接功能。
-
模组列表中的 Logo — 在“Mods”(模组)屏幕上,CustomPerm 的标志横幅会在两个版本中显示(在 26.3 中通过
bannerFile声明,而logoFile已被弃用)。
变更
- 仓库结构重组 — 纯 Java 代码(权限解析、配置模板、集群存储、使用限制等)移至
core/目录,并在每个目标平台下编译;每个 Minecraft 版本对应一个独立的 Gradle 项目(neoforge-1.21.1/、neoforge-26.3/)。对服务器端无任何影响。 - Jar 文件名标明目标平台 — 文件名为
customperm-neoforge-1.21.1-<version>.jar和customperm-neoforge-26.3-<version>.jar,以避免混淆同一版本的两种构建产物。升级时,请像往常一样从mods/文件夹中移除旧的customperm-<version>.jar文件。 - 26.3 中 LuckPerms 的
world上下文 — LuckPerms 5.5 将其world上下文设置为维度(通过其world-rewrite机制),而非之前的世界存档名称。导入功能仍会忽略world节点,并在此说明原因;带有 LuckPermsdimension-type上下文的节点按原有方式导入。
修复
/customperm debug不再因内部错误而失败 — 在使用 LuckPerms 时,如果命令已公开且玩家没有显式值,该命令之前会因错误而中止,而非显示其报告。- 第二次重载提示“重载正在进行中” — 在另一个
/customperm reload仍在运行时发起的重载,可能会返回旧重载的磁盘错误,而不是Reload already in progress(重载已在进行中)。 - 26.3 版本的集群建议 — 在 Minecraft 26.3 中,由于 Arcadia Lib 没有构建版本,集群警告不再建议安装它:而是指向直接连接。
英文
新增
- 供其他模组使用的公共 API —
io.github.thefricadelle.customperm.api,位于模组 JAR 包内,拥有独立版本(CustomPermApi.API_MAJOR为 1,API_MINOR为 0)。其他模组针对已发布的 JAR 包进行编译(使用compileOnly),并将 CustomPerm 设为可选依赖。可读取活跃后端的响应,包括 LuckPerms:显式与有效检查、离线检查、持有的等级、等级详情、元数据、前缀、后缀及上下文。可通过与命令相同的代码(验证、锁定保护、保存、集群、刷新)写入覆盖等级分配、ALLOW 和 DENY 节点、元数据、前缀和后缀、轨道晋升与降级,以及等级的创建与删除。默认关闭:settings.json新增api区块,writes默认为 false,writers列表为空,可通过/customperm api编辑;若settings.json中无此区块则保持原样加载。被拒绝的模组会触发一条管理员警报并指明其 ID;模组所做的每次更改都会记录在活动日志中,来源标记为mod:<modid>(来源api),首次操作将以 INFO 级别记录。在 LuckPerms 下,所有写入操作均会被拒绝。NeoForge.EVENT_BUS上的事件会在变更最终确定后触发,无论该变更是由命令、界面、API、过期、集群、LuckPerms、重载还是后端更改引起的。详见 docs/API.md。 - 界面中的 Mod API 页面 — Mod API 页面用于在游戏内管理 API 访问权限:是否开启写入、允许哪些模组(通过 ID 添加,可从已加载模组中补全,或移除)、被拒绝的模组以及自服务器启动以来进行过写入操作的模组。对已被拒绝的模组执行 Allow 操作会将其列入允许列表,并在确认后将写入功能开启。每项操作均执行
/customperm api的代码逻辑,并记录在活动日志中;读取配置需要customperm.view.config权限,修改配置需要customperm.manage.config权限。该页面属于新增的视图切换项“Mod API”,因此 Simple 视图中会隐藏它;当某模组被拒绝时,仪表盘上的警报会打开此页面,且侧边栏在所有视图中均显示该页面。视图面板的切换按钮会收缩以适配 854x480 分辨率下最多显示十三个选项。 - 界面视图:Simple、Advanced、Custom — 刷新按钮旁的 View 按钮用于选择管理界面的显示程度。Simple(默认)保留日常使用的控件;Advanced 显示所有控件,与之前一致;Custom 提供十二个组别的勾选选项(世界与上下文、持续时间、继承、元数据、轨道、权重与显示名称、前缀优先级与堆叠、昵称、别名参数、集群、速率限制持久化、导入与导出)。隐藏的控件不会发送任何数据,行仍会显示其上下文、剩余时间、优先级和权重,帮助文档也会省略隐藏控件的相关主题和说明行。该设置按客户端保存在
config/customperm/client.json中,且绝不会授予任何额外权限:侧边栏同样会省略管理员无法读取的页面,仪表盘也会隐藏相关区域的图块。LuckPerms 编辑器不受影响。
更改
- 接口网络协议 3 —— 接口载荷发生变化(页面上下文携带管理员可读取的区域,Mod API 页面为新增),因此协议从 2 升级至 3,且每个频道名称现在都带有版本号(
customperm:gui_page_v3)。NeoForge 在两端以不同版本知晓同一频道时会拒绝连接,即使是可选频道;通过在名称中包含版本号,运行 CustomPerm 2.0.x 客户端的玩家加入 2.5.0 服务器时可以正常进行,只是界面功能会处于关闭状态,直到该客户端上的 CustomPerm 得到更新,反之亦然。/customperm gui命令会显示服务器使用的协议版本。 - Java 包
io.github.thefricadelle.customperm—— 代码已从com.arcadia.customperm移出。对服务器端没有影响:模组 ID、权限节点、配置文件夹及文件均保持不变。使用 API 的模组将针对io.github.thefricadelle.customperm.api进行编译,这是 API 唯一存在的包。 - 许可证 3.1:允许模组使用 API —— 允许基于未修改的官方 jar 编译其他模组并调用
io.github.thefricadelle.customperm.api(§3(d));禁止修改、捆绑或重新上传该 Mod。已发布的版本保留其随附的许可证。 - 按区域划分读取权限(对没有
customperm.*的管理员而言是破坏性变更) —— 过去,customperm.admin允许管理员读取所有区域:界面的每一页、每一个列表、日志和诊断信息。现在它仅作为入口权限:用于仪表盘、帮助、/customperm status、modcheck和管理员警报。读取某个区域需要新的customperm.view.<area>节点(commands、aliases、ratelimits、grades、luckperms、logs、config),而customperm.manage.<area>也会自动授予对该区域的读取权限;customperm.view.*可读取所有区域,customperm.*依然授予所有权限。服务器会强制执行此规则:管理员无法读取的页面不会被发送,只读子命令(如grade list、user list、track list、alias list、command list、scan、debug、test、ratelimit list、log admin、contexts、names等)在其命令树中不可见,补全建议不再提出隐藏区域的名称,仪表盘和status会省略隐藏区域的数据,LuckPerms 编辑器在没有customperm.view.luckperms权限时会拒绝生成快照。玩家页面和track list需要customperm.view.grades权限,但仅拥有 track 节点仍可通过命令移动玩家。曾经仅持有部分管理节点的customperm.admin管理员现在只能读取这些特定区域:若要维持之前的读取权限,请授予customperm.view.*。启动日志和 MIGRATION.md 中有相关说明;配置格式保持不变。 - 集群变更无需等待数据库即可响应 —— 在集群中进行的更改曾需在服务器线程上等待最多 250 毫秒以让数据库接收,若数据库较慢,每次管理员更改都会导致一个刻的卡顿。现在更改会立即生效并发送,无需等待:命令和界面状态行会显示
<change> — waiting for the cluster database...,随后一旦数据库响应,会显示<change> — applied, published to the cluster.或[CustomPerm] Refused: <reason> Undone: <change>,并且界面页面会刷新以显示最终状态。在线操作员仍会收到被拒绝的通知。API 写入仅在服务器线程上完成,并以最终结果为准(若是被拒绝则为REFUSED_CLUSTER),API 事件和活动日志条目也遵循该结果。当服务器离开集群时,若仍有未响应的更改,会被报告为未确认。在非集群环境下没有任何变化。 - 配置文件在服务器线程之外写入 —— 过去,每次管理员更改都会在服务器线程上写入五个配置文件(临时文件、移动操作,在一小时的集群基准测试中耗时约 2.7 秒,在慢速或扫描磁盘上耗时更长)。每个文件的文本内容仍在更改发生处生成,然后交由唯一的写入线程处理,该线程仅保留每个文件的最新文本,因此即使出现大量更改也只需一次写入,且文件绝不会回退到旧文本。若写入失败,更改将保留在内存中,触发新的
CONFIG_SAVE_FAILED警报(指明文件名和原因),并在下次更改或重载时重试;下一次更改的回复会提示文件正在写入中。/customperm reload首先会等待已提交的写入操作(最长 5 秒),若无法写入则拒绝重载并保留内存。停止服务时也会以相同方式等待,并记录任何未写入的文件。
修复
-
别名可选词 — 玩家可输入的单词参数,例如
minecraft:bread,系统会提供该选项但命令解析器拒绝接受。现在仅允许字母、数字以及_ - . +;已保存的选项继续加载。 -
被拒绝的查看节点隐藏其区域 — 持有
customperm.*或某区域管理节点的管理员,在该区域的customperm.view.<area>节点设置为 DENY(拒绝)时,仍可读此区域。现在显式的查看节点 DENY 将优先于两者,适用于页面和读取命令;更改区域仍遵循其管理节点。 -
从未启动的 LuckPerms 提示重启 — 在单人游戏或 LuckPerms 未能启用时,警报曾声称
/customperm reload可恢复它,但这无法实现。现在提示只有重启才有效;在游戏过程中失败但仍存在的 LuckPerms 仍可通过重载恢复。 -
仪表盘警报完整显示 — 长警报曾在两到三行后截断,且在短窗口中最后一行被拦腰切断。现在它会逐行滚动,且行宽适应窗口剩余空间。
-
/customperm test对管理员节点 — 此前它将customperm.admin、customperm.view.*、customperm.manage.*和customperm.track.*报告为授予任何操作员,而这些节点需要显式 ALLOW(允许)。现在会正确说明这一点,并列出拥有这些权限的世界主机(无需节点即可持有)。 -
无法加入的集群说明原因 — 当数据库在启动时拒绝加入(用户缺少写入权限、表缺失或变更),警报仅显示数据库“无法连接或被拒绝”。现在会指出具体表名及所需权限。
-
界面中的长文本改为滚动而非截断 — 超过容器长度的横幅或命令说明以往会在句中截断(如拒绝模式下的 Grades 横幅、Commands 页面中的长节点名称)。现在它们会缓慢上下滚动,并在两端暂停。
-
LuckPerms 编辑器的只读提示 — 对于没有
customperm.manage.luckperms的管理员,该提示曾绘制在 Tracks 标签页上方。现在它位于标签页旁边,在窗口较窄时缩短为“只读”。 -
LuckPerms 无需重启即可恢复 — 游戏过程中单次 LuckPerms 故障(存储超时、检查错误)曾使 CustomPerm 保持在降级状态直至服务器重启。现在
/customperm reload会再次请求 LuckPerms:若其响应,则 LuckPerms 后端重新接管,未订阅的钩子会被订阅,管理员警报解除,重载消息也会说明此情况。若在启动时不兼容或未启动的 LuckPerms 仍需重启,警报会指明属于哪种情况。 -
活动日志在启动时完整保留 — 清理保留期可能删除旧文件,而服务器在启动时正回溯读取该日志,导致读取在此处停止,新条目直到下次重启前都不会出现在界面中。现在消失的文件会被跳过,其余部分正常读取。
-
速率限制历史在无法读取时永不覆盖 — 对
<world>/data/customperm_ratelimits.json的任何读取错误都被视为损坏:短暂锁定的文件会被移至别处并重设所有计数器;若重命名也失败,下次世界保存会用自上次计数以来的少量使用记录替换整个历史。现在仅非 JSON 格式的文件会被移至别处。无法读取的文件会保留原位,暂停保存,新的管理员警报会指出文件名,修复后/customperm reload会重新读取并添加期间计数的使用记录。 -
损坏的活动日志文件 — 一个非 UTF-8 字节或一个无法读取的日志文件曾清空 Logs 页面的整个标签页并隐藏所有更早的文件。现在每个文件独立读取并以宽松方式解码,因此仅损坏的行被跳过,服务器日志会指出文件名。因崩溃而截断的一行不再吞没下一项条目。
-
不可读的集群条目被暂缓处理 — 集群存储中一行无法解码(截断、结构错误)会导致其之前应用的条目在内存中生效但未保存,并在此处停止轮询;本版本未知的行类型会在下次变更时被从存储中删除。现在此类行在存储中保持不变,条目保留该服务器的副本,新的管理员警报会指出它,且在此服务器上更改该条目会覆盖它。中途失败的轮询仍会应用已读取的活动日志条目和共享速率限制使用记录。
-
配置加载错误会注明文件和原因 — 无法读取的配置(锁定、无访问权限)此前被报告为无效 JSON,且未提供路径。服务器日志现在会给出路径、原因及操作建议,管理员警报和
/customperm reload的回答会显示invalid or empty(无效或为空)或unreadable(不可读)并附带文件名。 -
未知的
tls值不再意味着明文 —cluster.database.tls设置为除off、trust或verify(拼写错误)之外的值时,曾被当作off处理,导致直连以明文发送密码。现在该值会保留在文件中,集群模式不连接任何内容,服务器日志和管理员警报会指出该值及合法值。未知的cluster.connection也会以同样方式被拒绝,而非回退到 Arcadia Lib。 -
集群永不阻塞服务器线程 — 此前集群中的变更会在服务器线程上写入数据库,加入过程也在该线程运行(若发现前一次运行的心跳则会休眠 12 秒),停止操作亦然:静默的数据库断开可能导致游戏因连接和套接字超时而挂起。现在所有数据库调用均在集群线程上执行。加入过程在后台进行(仪表盘显示“正在连接”,期间拒绝变更);变更最多等待 250 ms 获取响应,后续到达的拒绝会撤销变更并通知操作员;停止操作最多等待 2 s,并记录未能发送的内容。
-
集群时钟偏差 — 存活检查、重复名称检查以及共享日志和共享速率限制的清理操作,此前会将每台服务器自身的时钟与其他服务器写入的时间进行比较:一台时间靠前的服务器会删除其他服务器刚刚计数的使用记录,从而导致共享限制被绕过。现在,时间的保存和比较均在数据库的时钟中进行。
-
运行期间集群表被删除或更改 — 此前报告为“无法访问”,只能通过重启重新创建。现在的警报会指明缺失或已更改的表名及相应处理建议;若表缺失,将在下一次尝试时重新创建(此时数据库用户可能拥有写入权限),且如果行数据丢失,服务器将像启动时一样重新加入集群。对于已更改的表,系统不会对其进行任何修改。
-
集群告警出现后又消失 — 一个仅具有读取权限的数据库用户或缺失的计数器行,会在每次状态变更时触发告警,并在下一次读取时清除告警,此过程每隔几秒发生一次。现在,告警仅在首次触发时显示其原因(例如“数据库用户无权写入:请授予 ...”),并且仅在写入成功时才清除告警;被拒绝的日志写入会进行退避处理,而不是在每次轮询时重试。缺失的计数器行会被放回其存储的最高编号位置。
-
集群存储中出现不可能的数值 — 某行被编辑为一个巨大的数值会导致所有后续行无法读取,而版本号为 0 的行会导致该条目的所有更改永久冲突。现在,读取位置永远不会越过计数器;版本号低于或等于 0 的值会被下一次更改覆盖;同时会生成新的管理员告警以标识此类行。
-
负数过期时间不再视为永久有效 —
grades.json中低于零的expires值(前缀、后缀或任何...Expiries值)此前会被读作永久有效(类似于 0)。现在会被读作已经过期:该条目不授予也不显示任何内容,过期清理程序会将其移除,加载过程会在服务器日志中列出该条目。请参阅 MIGRATION.md。 -
未来日期的活动日志条目被清理 — 日期晚于今天(时钟回拨、集群对等节点时间靠前)的条目会被写入一个以该未来日期命名的日志文件中,而保留策略从未删除该文件。现在,该条目会被写入今天的日志文件,并保留其自身的时间戳。
-
标准化配置值报告 — 在加载
settings.json、ratelimits.json或grades.json时被替换的不可能值(例如cluster.pollSeconds -4、超出范围的端口号、将自身列为父级的等级)现在会以警告形式记录一次,并注明文件名、键名以及保留的值。
法语
新增内容
- 供其他模组使用的公开 API ——
io.github.thefricadelle.customperm.api,位于模组 jar 包内,拥有独立版本(CustomPermApi.API_MAJOR为 1,API_MINOR为 0)。其他模组针对发布的 jar 进行编译(使用compileOnly),并将 CustomPerm 设为可选依赖。读取操作响应来自活动后端的数据,包括 LuckPerms:显式检查与有效检查、离线检查、拥有的等级、等级详情、元数据、前缀、后缀及上下文。写入操作涵盖等级分配、ALLOW 和 DENY 节点、元数据、前缀与后缀设置、在 track 上的晋升与降级,以及等级的创建与删除;其代码逻辑与命令一致(包含验证、防锁定保护、保存、集群同步及刷新机制)。写入功能默认禁用:settings.json新增api区块,其中writes默认为 false,writers为空列表,可通过/customperm api命令修改;若 settings.json 中缺少该区块,则加载时不作变更。被拒绝的模组会触发一条管理员警报,指明该模组名称;所有由模组执行的更改均记录在活动日志中,来源标记为mod:<modid>(源类型为api),且首次操作将以 INFO 级别记录。在 LuckPerms 下,任何写入操作均会被拒绝。一旦更改最终生效,无论其来源如何(命令、界面、API、过期、集群、LuckPerms、重载或后端切换),都会在NeoForge.EVENT_BUS上发布相应事件。详见 docs/API.md。 - 界面中的 Mod API 页面 —— 一个 Mod API 页面用于管理游戏内的 API 访问权限:如果写入功能已启用,则可管理授权模组(通过 ID 添加,支持从已加载模组中自动补全,也可移除)、被拒绝的模组以及自服务器启动以来执行过写入操作的模组。对某条被拒绝的模组选择 Allow(允许)后,会将其加入白名单;若此时写入功能处于禁用状态,则在确认后开启写入。每项操作均执行
/customperm api命令对应的代码逻辑,并记录至活动日志;读取请求需具备customperm.view.config权限,修改操作需具备customperm.manage.config权限。此页面归属于一个新的视图开关“Mod API”,因此 Simple 视图默认隐藏它;只要存在被拒绝的模组,仪表盘的警报将打开该页面,侧边栏会在所有视图中显示该页面。View 面板中的视图切换按钮进行了缩减,以便在 854x480 分辨率下容纳十三个选项。 - 界面视图:Simple(简单)、Advanced(高级)、Custom(自定义) —— Refresh 按钮旁新增 View 按钮,用于选择管理界面所显示的内容。Simple(默认)保留日常所需的控件;Advanced 显示所有控件,与之前行为一致;Custom 允许勾选十二个组别(世界与上下文、持续时间、继承、元数据、tracks、权重与显示名称、优先级与前缀堆叠、别名、别名参数、集群、使用限制持久性、导入与导出)。被隐藏的字段不会提交任何数据,行仍继续显示其上下文、剩余时间、优先级和权重,帮助文档也会省略被隐藏控件的相关主题和行。该选择仅针对每个客户端本地生效,存储在
config/customperm/client.json中,且绝不会授予额外权限:侧边栏同样会省略管理员无法读取的页面,仪表盘也会隐藏被屏蔽领域的磁贴。LuckPerms 编辑器不受此简化影响。
修改
- 界面网络协议 3 — 界面数据包已更改(页面上下文包含管理员可读的领域,且 Mod API 页面为新增功能),因此协议从 2 升级至 3,每个频道名称现在都带有版本号后缀(例如
customperm:gui_page_v3)。NeoForge 会拒绝连接:即使某个频道是可选的,如果双方对该频道的版本认知不一致,连接也会被拒绝。通过在频道名中嵌入版本号,使用 CustomPerm 2.0.x 客户端的玩家通常可以加入运行 2.5.0 的服务端,此时界面将被禁用,直到该客户端上的 CustomPerm 更新;反之亦然。/customperm gui命令会显示服务端当前使用的协议版本。 - Java 包
io.github.thefricadelle.customperm— 代码已从com.arcadia.customperm迁移。对服务端而言无任何变化:模组标识符、权限节点、配置文件夹及文件均保持不变。使用 API 的模组需针对io.github.thefricadelle.customperm.api进行编译,这是 API 始终存在的唯一包。 - 许可证 3.1:模组可使用 API — 允许将另一个模组编译到未修改的官方 jar 文件中并调用
io.github.thefricadelle.customperm.api(见第 3(d) 条);但禁止修改、重新打包或重新发布该模组。已发布的版本保留其原始发行时的许可证。 - 按领域的读取权限(破坏性变更:无
customperm.*的管理员受影响) — 此前customperm.admin允许管理员读取所有领域:界面的每个页面、每个列表、日志和诊断信息。现在它仅作为入口:仪表盘、帮助、/customperm status、modcheck以及管理员警报。读取特定领域需要新的节点customperm.view.<area>(包括commands、aliases、ratelimits、grades、luckperms、logs、config),而customperm.manage.<area>同时授予该领域的读取权限;customperm.view.*可读取所有领域,customperm.*仍授予全部权限。服务端会强制执行此限制:管理员无法读取的页面不会发送;只读子命令(grade list、user list、track list、alias list、command list、scan、debug、test、ratelimit list、log admin、contexts、names及其他)在其命令树中不可见;补全提示不再提供被隐藏领域的名称;仪表盘和status会省略被隐藏领域的数字;LuckPerms 编辑器在没有customperm.view.luckperms时拒绝快照操作。contexts和names现由customperm.view.config控制读取,由customperm.manage.config控制修改。Players 页面和track list需要customperm.view.grades,但单独的 track 节点仍允许通过命令移动玩家。曾经拥有customperm.admin但仅具备少量管理节点的管理员,现在只能读取这些管理节点对应的领域:若要保留之前的读取权限,请赋予customperm.view.*。启动日志和 MIGRATION.md 均对此进行了提示;配置文件格式未发生变化。 - 集群中的变更无需等待数据库响应 — 之前在集群中进行的变更会在服务端线程上最多等待 250 毫秒,直至数据库接受,这会导致每次管理变更在数据库缓慢时出现 tick 峰值。现在变更立即应用并发送,无需等待:命令和界面状态栏会显示
<change> — waiting for the cluster database...,待数据库响应后,将显示<change> — applied, published to the cluster.或[CustomPerm] Refused: <reason> Undone: <change>,并且界面页面会以最终状态刷新。在线操作员仍会收到任何拒绝通知。API 写入操作仅在服务端线程上获得最终结果(对于拒绝情况为REFUSED_CLUSTER)后才完成,API 事件和活动日志条目也将遵循此结果。若服务器退出集群时仍有变更未收到响应,则标记为未确认。非集群环境下无任何变化。 - 配置文件写入脱离服务端线程 — 此前每次管理变更都会在服务端线程上写入五个配置文件(临时文件、移动文件,在基准集群测试中耗时约 2.7 秒,在慢速磁盘或分析环境下更久)。每个文件的文本内容仍在变更发生处生成,然后交由唯一的写入线程处理,该线程仅保留每个文件的最新文本:一系列快速变更只需一次写入,且文件绝不会回退到旧文本。写入失败时,变更仍保留在内存中,触发新的
CONFIG_SAVE_FAILED警报(指明文件名及原因),并在下次变更或重载时重试;下一次变更的响应会表明文件尚未写入。/customperm reload命令会先等待已提交的写入操作(最多等待 5 秒),若任一文件无法写入则拒绝重载,内存数据得以保留。服务器关闭时会以相同方式等待这些写入,并记录所有未成功写入的文件。
修复
-
选择玩家可输入的别名词 — 参数
word曾接受如minecraft:bread之类的选项,虽会提供建议但命令解析器会拒绝。现在选项仅允许包含字母、数字以及_ - . +;已注册的选项仍正常加载。 -
被拒绝的视图节点会隐藏其领域 — 拥有
customperm.*的管理员,或拥有某领域管理节点的权限者,在其customperm.view.<area>节点为 DENY(拒绝)时,仍能读取该领域。现在显式的视图节点 DENY 将优先于上述两者,适用于页面和读取命令;修改领域仍遵循其管理节点。 -
未启动的 LuckPerms 需重启才能生效 — 在单人游戏或 LuckPerms 无法激活时,提示曾声称
/customperm reload可恢复它,但这不可能实现。现在提示仅说明只有重启才能解决;游戏中途失败的 LuckPerms 仍可通过重载恢复。 -
仪表盘警告信息完整显示 — 长警告信息此前仅显示两到三行,且在较小窗口中最后一行会被截断。现在它会滚动显示所有行,且单行内容会根据窗口剩余空间自适应。
-
/customperm test测试管理员节点 — 此前它错误地将customperm.admin、customperm.view.*、customperm.manage.*和customperm.track.*报告为对所有操作员授予,而这些节点实际需要显式 ALLOW(允许)。现在它会正确说明这一点,并指出世界主机(world host),后者在没有这些节点的情况下默认持有它们。 -
无法加入的集群会说明原因 — 当数据库在启动时拒绝连接(例如用户无写入权限、表缺失或被修改),提示仅显示数据库“未能连接或已拒绝”。现在它会明确指出需要授权的表和权限。
-
界面中的长文本改为滚动而非截断 — 超过区域宽度的横幅或命令说明此前会在句子中间被截断(例如 Deny 模式下的 Grades 横幅,或 Commands 页面上过长的节点名称)。现在它们会缓慢向上滚动然后返回,并在两端暂停。
-
LuckPerms 编辑器的只读标注位置修正 — 对于没有
customperm.manage.luckperms的管理员,此前的标注绘制在了 Tracks 标签页之上。现在它位于标签页旁边,当窗口较窄时会缩写为“Read-only”(只读)。 -
LuckPerms 无需重启即可恢复 — 游戏中途单次 LuckPerms 故障(如存储超时或检查错误)曾导致 CustomPerm 回退至备用状态直至服务器重启。现在
/customperm reload会重新查询 LuckPerms:若响应正常,LuckPerms 后端将接管控制权,其 hooks 若尚未订阅则会被订阅,管理员警告将被清除,重载消息也会予以说明。若 LuckPerms 不兼容或在启动时从未成功启动,仍需重启,且警告会指明具体适用情况。 -
启动时保留完整的活动日志 — 保留期清理可能在服务器启动期间读取日志时删除旧文件,导致读取在该文件处停止,使更新的条目直到下次重启前都无法在界面中看到。现在消失的文件将被忽略,其余部分继续读取。
-
若无法读取则永不覆盖速率限制历史记录 — 对
<world>/data/customperm_ratelimits.json的任何读取错误此前都被视为损坏:短暂锁定的文件会被移走并重设所有计数器;若移走也失败,下一次世界保存会用自上次计数以来的少量使用记录覆盖历史记录。现在仅非 JSON 格式的文件会被移走。不可读的文件将保留原位,备份暂停,新的管理员警告会列出该文件,修复后/customperm reload会重新读取它并补录期间的计数。 -
损坏的日志文件 — 单个非 UTF-8 字节或单个不可读的日志文件此前会导致 Logs 页面整个标签页清空,并隐藏所有更旧的日志文件。现在每个文件独立读取并采用容错解码:仅损坏的行被忽略,服务器日志会注明文件名。因崩溃而截断的行不再吞没下一条目。
-
不可读的集群条目会被排除 — 无法解码的集群存储行(截断或格式错误)此前会导致该行之前应用的条目在内存中被修改但未保存或未生效,并停止定期读取;此版本未知类型的行会在下次更改时被从存储中删除。现在此类行在存储中保持原样,条目保留该服务器的副本,新的管理员警告会列出它,且在此服务器上修改该条目会将其覆盖。中途失败的定期读取仍会应用已读取的活动日志条目和共享的速率限制使用情况。
-
配置加载错误会指明文件和原因 — 不可读的配置文件(锁定或无访问权限)此前被报告为无效 JSON,且未显示路径。现在服务器日志会给出路径、原因和操作步骤,管理员警告和
/customperm reload的响应会标明invalid or empty(无效或为空)或unreadable(不可读),并附带文件名。 -
Une valeur
tlsinconnue ne signifie plus texte en clair —cluster.database.tlsréglé sur autre chose queoff,trustouverify(une faute de frappe deverify) était lu commeoffet la connexion directe envoyait son mot de passe en clair. Une telle valeur est maintenant conservée dans le fichier, le mode cluster ne se connecte à rien, et le journal du serveur et une alerte admin nomment la valeur et celles acceptées. Uncluster.connectioninconnu est refusé de la même façon au lieu de se rabattre sur Arcadia Lib. -
Le cluster ne bloque jamais le thread serveur — un changement fait en cluster était écrit dans la base sur le thread serveur, la connexion au cluster s'y déroulait (avec une attente de 12 s quand le battement de cœur d'une exécution précédente était trouvé) et l'arrêt aussi : une coupure silencieuse de la base pouvait bloquer le jeu pendant les délais de connexion et de socket. Chaque appel à la base passe maintenant par le thread du cluster. La connexion se fait en arrière-plan (le tableau de bord indique la connexion en cours, les changements sont refusés pendant ce temps) ; un changement attend sa réponse 250 ms au plus, et un refus qui arrive plus tard l'annule et prévient les opérateurs ; un arrêt attend 2 s au plus et journalise ce qu'il n'a pas pu envoyer.
-
Décalage d'horloge du cluster — la détection des serveurs actifs, la vérification des noms en double et les purges du journal partagé et des usages partagés de limites comparaient l'horloge de chaque serveur à des heures écrites par les autres : un serveur en avance supprimait les usages que les autres venaient de compter, ce qui permettait de contourner une limite partagée. Les heures sont maintenant conservées et comparées selon l'horloge de la base.
-
Table du cluster supprimée ou modifiée en cours de route — signalée comme « injoignable » et recréée seulement par un redémarrage. L'alerte nomme maintenant la table manquante ou modifiée et la marche à suivre ; une table manquante est recréée à la tentative suivante quand l'utilisateur de la base en a le droit, et les serveurs rejoignent à nouveau comme au démarrage si les lignes ont été perdues. Une table modifiée n'est jamais altérée.
-
Alerte de cluster qui allait et venait — un utilisateur de base qui ne peut que lire, ou une ligne de compteur manquante, levait l'alerte à chaque changement et l'effaçait à la lecture suivante, toutes les quelques secondes. L'alerte est maintenant levée une fois avec sa cause (« the database user may not write: grant ... ») et effacée seulement quand une écriture passe ; les écritures de journal refusées espacent leurs tentatives au lieu d'être retentées à chaque lecture périodique. Une ligne de compteur manquante est remise au plus grand numéro stocké.
-
Nombres impossibles dans le stockage du cluster — une ligne modifiée avec un nombre énorme rendait illisibles toutes les lignes suivantes, et une ligne en version 0 faisait entrer en conflit pour toujours chaque changement de cette entrée. La position de lecture ne dépasse jamais le compteur, une version de 0 ou moins est écrasée par le changement suivant, et une nouvelle alerte admin nomme ces lignes.
-
Une expiration négative n'est plus permanente — un
expiresinférieur à zéro dansgrades.json(préfixe, suffixe ou toute valeur...Expiries) se lisait comme permanent, comme 0. Il se lit maintenant comme déjà expiré : l'entrée n'accorde et n'affiche rien, le balayage des expirations la retire, et le chargement la nomme dans le journal du serveur. Voir MIGRATION.md. -
Entrées du journal d'activité datées du futur purgées — une entrée datée après aujourd'hui (horloge reculée, pair du cluster en avance) était écrite dans un fichier du jour portant cette date future, que la rétention ne supprimait jamais. Elle va maintenant dans le fichier du jour et garde sa propre heure.
-
Valeurs de configuration normalisées signalées — une valeur impossible remplacée au chargement dans
settings.json,ratelimits.jsonougrades.json(par exemplecluster.pollSeconds -4, un port hors limites, un grade listé comme son propre parent) est maintenant journalisée une fois en avertissement, avec le fichier, la clé et la valeur retenue.
CustomPerm 2.0.0
正在从 1.0.x 升级?请先阅读升级前须知:升级后,在通过控制台授予新的节点之前,没有人能够管理 CustomPerm。替换 jar 文件之前,请备份你的配置文件夹。
兼容性: Minecraft 1.21.1 · NeoForge 21.1.221+ · Java 21 · LuckPerms 5.4.150+(可选)· Arcadia Lib 1.3.0+(仅限集群模式)
升级前须知
有三项更改可能导致你被锁定或改变玩家可执行的操作。完整列表及如何回退的方法请参阅 迁移指南。
-
管理功能需要已授予的权限。
/customperm命令以及用于打开界面的操作,任何等级为 2 的管理员原本都可以使用。现在他们需要拥有 op 等级 2 以及customperm.admin权限,并且每次更改都需要对应区域的节点权限(customperm.manage.commands、.aliases、.ratelimits、.grades、.logs、.config、.luckperms)。仅凭 op 等级无法打开任何东西,即使是等级 4。升级后,没有人持有这些节点。 请通过控制台授予它们:customperm grade create admins customperm grade addperm admins customperm.* customperm grade assign <name> admins或者,如果使用 LuckPerms,请使用
lp user <name> permission set customperm.* true。服务器日志会在每次启动时提示此信息,且控制台始终拥有访问权限。 -
最具体的条目优先(内部等级)。 以前,任何地方的 DENY(拒绝)都会覆盖任何 ALLOW(允许)。现在的解析遵循 LuckPerms 的规则:精确节点优于
a.b.*,后者优于a.*,再后者优于*,且仅在相同层级时 DENY 获胜。一个既拒绝通配符又允许更窄范围节点的等级,现在会授予该节点。 -
显式的 DENY 也适用于操作员。 操作员保留所有未设置节点的命令,但现在如果某个节点对他们显式设置为 DENY(内部等级,或在 LuckPerms 中设为
false),他们也将被拒绝访问。
界面写入节点 customperm.gui.<area>.edit 已被上述 customperm.manage.<area> 节点取代。
集群模式需要一个提供数据库驱动的模组。 CustomPerm 不附带 MariaDB 或 MySQL 驱动。在集群中的每个服务器上,安装 Arcadia Lib 1.3.0 或更高版本,或者另一个提供此类驱动的模组。如果没有它,服务器会正常单独启动,但 /customperm status 会显示缺少驱动。Arcadia Lib 也必须安装在玩家的客户端上:因为其网络通道是必需的,所以没有它的客户端会被拒绝。单独的 CustomPerm 从不要求客户端模组。
新增功能
原生管理界面
/customperm gui 打开一个使用 Minecraft 自身小部件绘制的界面。它取代了 TesseraUI 面板,并需要在管理员的客户端上安装 CustomPerm,无需其他内容。页面包括:带有管理员警报的控制台、命令、别名、速率限制、等级、玩家、日志、LuckPerms 导入和导出、当运行 LuckPerms 时的 LuckPerms 编辑器,以及解释每项功能的帮助页面。每个字段都会在输入时自动补全等级、玩家、节点、命令、上下文和持续时间。服务器保持权威地位:每个操作都会经过检查、速率限制和记录。
接近 LuckPerms 的权限模型
内部等级获得继承、被拒绝的等级、权重、由单个玩家携带的节点、默认等级、临时条目(30d)、限制于特定世界、游戏模式或静态上下文的条目、带有 promote 和 demote 的轨道、元数据、聊天前缀和后缀以及昵称。通过 NeoForge 权限 API 声明的其他模组的节点也会从等级中响应,/customperm modcheck 列出了那些仅与 LuckPerms 交互的模组。
在 CustomPerm 和 LuckPerms 之间迁移
/customperm import 将 LuckPerms 组、玩家和节点导入;/customperm export 将等级写入 LuckPerms。两者在写入任何内容之前都会显示报告,请先备份,并让你选择哪些组、玩家、轨道和类型的条目参与迁移。
集群模式
多个没有 LuckPerms 的服务器通过一个 MariaDB 或 MySQL 数据库共享它们的等级、玩家持有的权限、暴露的命令、别名、速率限制和活动日志,可以直接连接或通过 Arcadia Lib 进行连接。在一个服务器上的更改会在大约两秒内应用到所有服务器。每个服务器选择自己遵循的部分。命令、别名或速率限制可以限制在某些服务器上,而等级或玩家可以在单个服务器上允许或拒绝(server=<name> 或 server=here)。默认关闭。
别名和速率限制
- 别名接受键入的参数(
player、integer、word、text),可选默认值,在步骤中用作${name}。 - 速率限制具有层级:规则、然后是服务器自身的限制、然后是等级的值、最后是玩家的值(
10/1h、unlimited),通过/customperm ratelimit grade|player|server或从界面设置。计数器可以在集群中共享,使用历史在重启后保留。
活动日志和警报
每次管理更改都会记录谁、何时、来自哪里以及结果,包括通过 /lp 进行的更改。记录玩家输入的命令是可用的,默认关闭,私人消息和密码会被屏蔽。当 LuckPerms 不可用或配置文件加载失败时,操作员会在聊天中收到警报。
移除
- TesseraUI 面板 和
tesseraui可选依赖项。原生界面取代了它;管理员可以卸载 TesseraUI。
修复
/function和/return在每次调用时均失败。- 快捷命令可以绕过命令暴露限制和速率限制。
- 停止暴露的命令仍可能由其旧的网关授予权限。
- 暴露命令不再削弱 LuckPerms 对操作员的权限。
- LuckPerms 导入和导出使用了错误的世界上下文。
- 包含
null条目的手动编辑文件可能导致权限检查中断,且管理员命令可能会清除加载失败的文件。 - 在 Windows 上,当防病毒软件占用文件时,保存可能会失败。
- 每个玩家的速率限制历史不再无限增长。
- 重载会重写所有配置文件并生成一组新的备份:几次未做任何更改的重载会将之前保留的三个备份全部挤出。现在仅写入并备份内容发生变化的文件。
完整列表请参阅 更新日志。
许可协议
2.0.0 是首个以专有、源码可见许可协议(保留所有权利)发布的构建版本。源代码在 GitHub 上保持可读。从 CurseForge 和 Modrinth 获取未修改官方文件的整合包是被允许的;其他任何用途均需获得书面许可。1.0.5 及更早版本仍按其发布时的许可协议提供。请参阅 NOTICE.md。
报告问题
请在 追踪器 上提交 Issue,并提供你的服务器类型(专用服务器或单人游戏)、LuckPerms 版本(如有)、集群模式是否开启,以及 logs/latest.log 中的相关行。
CustomPerm 2.0.0
您是从 1.0.x 升级的吗?请先阅读 更新前须知 :更新后,在新节点从控制台授予之前,任何人都无法管理 CustomPerm。在替换 jar 文件之前,请备份您的配置文件夹。
兼容性: Minecraft 1.21.1 · NeoForge 21.1.221+ · Java 21 · LuckPerms 5.4.150+(可选)· Arcadia Lib 1.3.0+(仅限集群模式)
更新前须知
有三项变更可能会导致您失去访问权限或改变玩家可执行的操作。完整列表及回退方法请参阅 迁移指南。
-
管理需要授予的权限。
/customperm和界面此前对等级 2 及以上的所有操作员开放。现在需要等级 2 并且customperm.admin,且每项修改都需要其对应领域的节点权限(customperm.manage.commands、.aliases、.ratelimits、.grades、.logs、.config、.luckperms)。仅拥有操作员等级不会打开任何东西,即使是等级 4。更新后,没有任何人拥有这些节点。 请从控制台授予它们:customperm grade create admins customperm grade addperm admins customperm.* customperm grade assign <name> admins或者使用 LuckPerms,执行
lp user <name> permission set customperm.* true。服务器日志会在每次启动时提醒这一点,并且控制台始终保留访问权限。 -
最精确的条目优先(内部等级)。 此前,任何位置的 DENY(拒绝)都优于 ALLOW(允许)。现在的解析遵循 LuckPerms 的逻辑:精确节点优于
a.b.*,后者优于a.*,再后者优于*,且 DENY 仅在相同层级时才具有优势。一个拒绝通配符但允许更精确节点的等级,现在将授予该更精确节点。 -
显式 DENY 适用于操作员。 操作员仍保留所有未定义节点的命令权限,但现在,明确拒绝给他们的节点(通过内部等级,或在 LuckPerms 中设置为
false)也将被拒绝。
界面 customperm.gui.<domain>.edit 的写入节点已被上述 customperm.manage.<domain> 节点取代。
集群模式需要一个提供数据库驱动程序的模组。 CustomPerm 不附带任何 MariaDB 或 MySQL 驱动程序。在集群中的每台服务器上安装 Arcadia Lib 1.3.0 或更高版本,或任何其他提供该驱动的模组。没有它,服务器将正常单独启动,但 /customperm status 会报告缺少驱动程序。Arcadia Lib 也必须安装在玩家的客户端上:其网络通道是必需的,未安装它的客户端将被拒绝。仅 CustomPerm 本身从不要求客户端模组。
新功能
原生管理界面
/customperm gui 打开一个使用 Minecraft 小部件绘制的界面。它取代了 TesseraUI 面板,且仅需在管理员的客户端上安装 CustomPerm。页面包括:带有管理员警报的控制台、命令、别名、速率限制、等级、玩家、日志、LuckPerms 导入和导出、当 LuckPerms 运行时出现的 LuckPerms 编辑器,以及解释各项功能的帮助页面。每个字段在输入时都会自动补全等级、玩家、节点、命令、上下文和持续时间。服务器仍是权威方:每项操作都会经过验证、速率限制并记录日志。
接近 LuckPerms 的权限模型
内部等级获得了继承、拒绝等级、权重、单玩家持有节点、默认等级、临时条目(30d)、限制于特定世界、游戏模式或静态上下文的条目、带有 promote 和 demote 的轨道、元数据、聊天前缀和后缀,以及昵称。通过 NeoForge 权限 API 声明的其他模组的节点由等级解析,而 /customperm modcheck 列出了仅与 LuckPerms 交互的模组。
在 CustomPerm 和 LuckPerms 之间切换
/customperm import 接管 LuckPerms 的组、玩家和节点;/customperm export 将等级写入 LuckPerms。两者在写入前都会显示报告,先进行备份,并让用户选择哪些组、玩家、轨道和条目类型会被传输。
集群模式
多个未安装 LuckPerms 的服务器通过 MariaDB 或 MySQL 数据库实时共享其权限组、玩家数据、暴露的命令、别名、限制以及活动日志,也可通过 Arcadia Lib 进行同步。在一台服务器上的更改约两秒内即可应用到所有服务器。每个服务器可自主选择同步的部分内容。命令、别名或限制可以限定于特定服务器,而权限组或玩家可以在单个服务器上被授权或拒绝访问(使用 server=<名称> 或 server=here)。默认禁用。
别名与使用限制
- 别名支持类型化参数(
player、integer、word、text),可设为可选并带有默认值,在步骤中通过${name}引用。 - 使用限制具有层级结构:规则层、服务器自身的限制层、等级(grade)的值层,以及玩家个人的值层(例如
10/1h、unlimited),可通过/customperm ratelimit grade|player|server命令或从界面进行设置。计数器可在集群内共享,且历史记录在重启后得以保留。
活动日志与警报
每次管理操作都会记录操作者、时间、来源以及结果,包括通过 /lp 进行的更改。默认情况下禁用玩家输入命令的日志记录功能,同时会屏蔽私聊消息和密码。当 LuckPerms 不可用或配置文件加载失败时,管理员会在聊天中收到警报。
移除项
- TesseraUI 面板及可选依赖
tesseraui。原生界面已替代其功能;管理员可以卸载 TesseraUI。
修复
/function和/return在每次调用时都会失败。- 缩短的命令可以绕过暴露机制和使用限制。
- 不再被暴露的命令仍可通过其旧的限制条件获得权限。
- 暴露命令不再削弱 LuckPerms 对操作员的权限控制。
- LuckPerms 的导入和导出功能使用了错误的世界上下文。
- 手动编辑且包含
null条目的文件可能导致验证失效,而一条管理员命令可能清除加载失败的配置文件。 - 在 Windows 系统上,若杀毒软件占用文件,备份可能会失败。
- 玩家限量的历史记录不再无限增长。
- 重载会重写所有配置文件,并每次都生成新的备份集:仅进行几次无实质更改的重载,就足以将保留的三份历史备份全部淘汰。现在只有内容发生变化的文件和备份才会被写入和保存。
完整变更列表请查看 changelog。
许可证
2.0.0 是首个以“可见源码专有许可证”(版权所有)发布的版本。代码仍在 GitHub 上公开可读。允许 CurseForge 和 Modrinth 整合包获取未经修改的官方文件;其他任何用途均需书面授权。1.0.5 及更早版本仍沿用其最初发布的许可证提供下载。详见 NOTICE.md。
报告问题
在 tracker 上提交 Issue,注明服务器类型(专用或单人)、LuckPerms 版本(如有)、是否启用集群模式,以及 logs/latest.log 中的相关日志行。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
添加区块认领和玩家组队功能,并与 Xaero's Minimap 和 World Map 集成
模组
添加全屏世界地图,显示你在世界中已探索的区域。与 Xaero's Minimap 搭配使用效果极佳。

















评论 0
登录后参与评分
还没有评论,来抢沙发吧