CustomPerm

Granular server-side command permissions for Minecraft NeoForge — grant individual vanilla or modded commands to non-op players, with or without LuckPerms.

🧪 Current build 1.0.5 is published on the Beta channel while final testing wraps up. It is feature-complete and safe to try on a test server; feedback is welcome.

Why CustomPerm?

Vanilla Minecraft only knows op (every command) or non-op (no management commands). There is no middle ground.

CustomPerm lets you hand out exactly the commands you choose to non-op players — no full op required:

• Let a player use /gamemode spectator but never /op.
• Give /give to a VIP rank without unlocking /ban.
• Chain several commands into a single custom command (aliases / macros).

It integrates natively with LuckPerms when installed, and otherwise ships its own JSON grade system — so it works on any server.

Features

• Granular command permissions — expose any vanilla or modded root command with /customperm command add <name>, then grant it per rank.
• Works with and without LuckPerms — customperm.command.<name> is resolved by LuckPerms when installed (grant via /lp, wildcards included) or by the internal grades otherwise.
• Default-deny — nothing is exposed by default; non-exposed commands keep their original vanilla/modded requirement.
• Internal JSON RBAC — multi-grade permissions, explicit DENY over ALLOW, and wildcard nodes (*, customperm.command.*, customperm.alias.*), no external plugin needed.
• Aliases / macros — build custom commands like /fly, /heal, /starter from one or more steps; steps run with op-4 authority so admin-signed macros can call op-only commands. Recursion is bounded, shadowing is warned, and /customperm is reserved.
• Per-command rate limits (new in 1.0.5) — cap how many times a player may run a command or alias in a sliding window via /customperm ratelimit ....
• Optional TesseraUI admin panel (new in 1.0.5) — /customperm gui opens a graphical menu for Grades, Aliases and Status when TesseraUI is installed client-side. Purely optional — everything stays fully usable from chat.
• Server-side only — no client mod required. Vanilla clients connect without issue; the optional GUI channel is registered optional() so it never blocks the handshake.
• Atomic hot-reload — /customperm reload loads all configs as one transaction; invalid JSON keeps the previous snapshot. Timestamped backups are kept automatically.
• Configurable LuckPerms fail-safe — if LuckPerms becomes unavailable at runtime, settings.json chooses fail-closed (deny, default) or internal fallback (internal).
• Built-in diagnostics — /customperm status, /customperm scan, /customperm debug, /customperm test.

Installation

1. Install NeoForge 21.1.221+ for Minecraft 1.21.1 (Java 21).
2. Drop customperm-1.0.5.jar into your server's mods/ folder.
3. (Optional) Add LuckPerms (NeoForge 1.21.1 build) for full RBAC.
4. (Optional) Have admins install TesseraUI client-side for /customperm gui.
5. Start the server. You should see [CustomPerm] Ready — backend=... in the log.

Quick start

With LuckPerms

customperm alias add spec gamemode spectator
lp group vip permission set customperm.alias.spec true
lp user Steve parent add vip

Steve can now use /spec without ever getting /gamemode.

Without LuckPerms (internal grades)

customperm command add gamemode
customperm grade create vip
customperm grade addperm vip customperm.command.gamemode
customperm grade assign Steve vip

Requirements

License: GNU General Public License v3.0 only (GPL-3.0-only) · Author: THEFricadelle

---

CustomPerm (Version Française)

Système de permissions de commandes côté serveur pour Minecraft NeoForge — accordez des commandes vanilla ou moddées précises à des joueurs non-op, avec ou sans LuckPerms.

🧪 La version 1.0.5 est publiée sur le canal Bêta le temps de finaliser les tests. Elle est complète et sûre à essayer sur un serveur de test ; vos retours sont les bienvenus.

Pourquoi CustomPerm ?

Minecraft vanilla ne connaît que op (toutes les commandes) ou non-op (aucune commande de gestion). Aucun intermédiaire.

CustomPerm vous laisse distribuer exactement les commandes de votre choix à des joueurs non-op — sans op complet :

• Autoriser /gamemode spectator mais jamais /op.
• Donner /give à un rang VIP sans débloquer /ban.
• Enchaîner plusieurs commandes en une seule commande personnalisée (alias / macros).

Il s'intègre nativement à LuckPerms s'il est installé, et embarque sinon son propre système de grades JSON — il fonctionne donc sur n'importe quel serveur.

Fonctionnalités

• Permissions de commandes granulaires — exposez n'importe quelle commande racine vanilla ou moddée avec /customperm command add <nom>, puis accordez-la par rang.
• Fonctionne avec et sans LuckPerms — customperm.command.<nom> est résolu par LuckPerms s'il est installé (via /lp, wildcards inclus) ou par les grades internes sinon.
• Refus par défaut — rien n'est exposé par défaut ; les commandes non exposées conservent leur exigence vanilla/moddée d'origine.
• RBAC JSON interne — permissions multi-grades, DENY explicite prioritaire sur ALLOW, et nœuds wildcard (*, customperm.command.*, customperm.alias.*), sans plugin externe.
• Alias / macros — créez des commandes comme /fly, /heal, /starter à partir d'une ou plusieurs étapes ; les étapes s'exécutent avec l'autorité op-4 pour que des macros validées par l'admin appellent des commandes op. La récursion est bornée, le masquage est signalé, et /customperm est réservé.
• Limites d'usage par commande (nouveau en 1.0.5) — plafonnez le nombre d'exécutions d'une commande ou d'un alias par joueur sur une fenêtre glissante via /customperm ratelimit ....
• Panneau d'administration TesseraUI optionnel (nouveau en 1.0.5) — /customperm gui ouvre un menu graphique pour les Grades, Alias et Statut lorsque TesseraUI est installé côté client. Totalement optionnel — tout reste utilisable depuis le chat.
• Côté serveur uniquement — aucun mod client requis. Les clients vanilla se connectent sans souci ; le canal de l'interface optionnelle est en optional() et ne bloque jamais la connexion.
• Rechargement à chaud atomique — /customperm reload charge toutes les configs en une transaction ; un JSON invalide conserve l'instantané précédent. Des sauvegardes horodatées sont conservées automatiquement.
• Repli LuckPerms configurable — si LuckPerms devient indisponible à l'exécution, settings.json choisit le refus (deny, défaut) ou le repli interne (internal).
• Diagnostics intégrés — /customperm status, /customperm scan, /customperm debug, /customperm test.

Installation

1. Installez NeoForge 21.1.221+ pour Minecraft 1.21.1 (Java 21).
2. Placez customperm-1.0.5.jar dans le dossier mods/ de votre serveur.
3. (Optionnel) Ajoutez LuckPerms (build NeoForge 1.21.1) pour un RBAC complet.
4. (Optionnel) Faites installer TesseraUI côté client aux admins pour /customperm gui.
5. Démarrez le serveur. La ligne [CustomPerm] Ready — backend=... doit apparaître dans les logs.

Démarrage rapide

Avec LuckPerms

customperm alias add spec gamemode spectator
lp group vip permission set customperm.alias.spec true
lp user Steve parent add vip

Steve peut désormais utiliser /spec sans jamais obtenir /gamemode.

Sans LuckPerms (grades internes)

customperm command add gamemode
customperm grade create vip
customperm grade addperm vip customperm.command.gamemode
customperm grade assign Steve vip

Prérequis

Licence : GNU General Public License v3.0 only (GPL-3.0-only) · Auteur : THEFricadelle