Conventions & permissions
Cette page décrit les conventions utilisées dans tout le wiki et le fonctionnement général du système de commandes et de permissions.
Notation des commandes
Notation | Signification |
|---|---|
| La commande à taper en jeu. |
| Argument obligatoire. |
| Argument optionnel. |
| Choix entre plusieurs valeurs ( |
| Nom d'un joueur (souvent autocomplété en jeu). |
Système de commandes
Tous les plugins Astral utilisent le framework ACF (Aikar's Command Framework). Concrètement :
Une commande est définie par une annotation
@CommandAlias(nom principal + alias).Sa permission est définie par
@CommandPermission.Sa description provient de l'annotation
@Description.Les sous-commandes (
@Subcommand) peuvent posséder leur propre permission.
Héritage des permissions
Lorsqu'une sous-commande n'a pas de permission propre, elle hérite de la permission de la commande parente.
À l'inverse, certaines sous-commandes ajoutent un niveau de permission plus fin (ex. economy.command.balance.set), et certaines variantes ajoutent un suffixe :
.others— autorise l'action sur un autre joueur (ex.essentials.heal.others)..all— applique l'action à tout l'inventaire (ex.essentials.repair.all).essentials.gamemode.<mode>— permission par mode de jeu (survival,creative…).
Points de vigilance
Certaines commandes présentent des comportements particuliers relevés dans le code. À connaître avant utilisation en production :
Réseau & cross-server
Le réseau fonctionne sous Velocity (proxy) avec plusieurs serveurs Paper. Certaines commandes sont cross-server (téléportations, messages privés, enchères…) et d'autres ne s'exécutent que sur certains groupes de serveurs configurés. La commande /pack est par exemple une commande du proxy Velocity, pas d'un serveur Paper.