le guide ultime et complet • Minecraft.fr – Un bon serveur Minecraft

Vous êtes administrateur d'un serveur exécutant Bukkit et vous souhaitez installer un système de permission, presque indispensable, mais vous ne pouvez pas? Vous ne comprenez rien à ce système de "nœuds", votre fichier de configuration ne fonctionne pas ou vous n’avez tout simplement pas le temps de le regarder? Si vous êtes dans ce cas, ce guide complet sur les autorisations sous Bukkit vous aidera grandement.

Sommaire

• Que sont les autorisations?
• Quel plugin installer?
• Autorisations facilitées
• Le fichier de configuration
  • La liste des utilisateurs
  • La liste des groupes
• Les commandes et permissions spécifiques au plugin
• Pour les développeurs
• Préfixes chez le chat
• De conclure

Que sont les autorisations?

Par défaut (en fait, cela dépend des plugins mais la plupart des développeurs appliquent cette règle), les commandes du serveur et de ses plugins sont accessibles uniquement aux opérateurs ou à l'OP. Ce n’est pas très pratique si vous voulez personnaliser qui peut faire quoi; des autorisations ont été créées pour pallier ce manque. La plupart des gros serveurs utilisent ce système: il consiste à classer les utilisateurs du serveur en différents groupes, chaque groupe disposant de ses propres autorisations; Cela permet de bien définir les droits de chacun et de différencier les différents rangs d'un serveur (visiteur, joueur, modérateur, administrateur, etc.).

Quel plugin installer?

De nombreux plugins d'autorisation existent. Le plus utilisé a longtemps été Autorisations (un nom très populaire, avez-vous vu?), Créé par TheYeti puis repris par rcjrrjcr depuis la version 3. Malheureusement, l'équipe de développement du plugin a abandonné le projet; Les autorisations sont maintenant obsolètes, en particulier depuis la nouvelle API apportée avec Bukkit version 1.1-R5.

Il s'agit de PermissionsBukkit, alors moins connu à l'époque, qui a repris le flambeau. C’est en fait le plugin officiel (mais pas natif) développé par l’équipe Bukkit, d’où son nom. C’est celui que j’aurais choisi dans ce guide afin que vous puissiez le télécharger maintenant et l’installer sur votre serveur à cette adresse.

Autorisations facilitées

Le fonctionnement de PermissionsBukkit est très simple. La base de ce système sont les "nœuds"; chaque nœud correspond à une commande ou fonctionnalité d'un plugin, donnée par le développeur du plugin en question. Chaque utilisateur ou groupe d'utilisateurs a une liste de nœuds, avec le plus souvent une réflexion simple: vous avez le nœud que vous pouvez faire, vous n'avez pas le nœud que vous ne pouvez pas faire. Par exemple, le plug-in Essentials a ce noeud (pris au hasard dans la liste):

essentials.time

Ce nœud correspond, comme vous l'avez sûrement deviné, à la commande / heure du plugin, ce qui permet de voir l'heure d'un monde (à ne pas confondre avec essentials.time.set qui permet de changer l'heure). Lorsque l'utilisateur envoie cette commande, le plugin cherche s'il a le nœud correspondant et autorise ou non l'exécution de la commande (après, cela dépend à nouveau des plugins).

Ensuite, vous devrez dire qui peut faire quoi et je comprends qu’il est plutôt fastidieux de donner chaque nœud un par un à chaque joueur. C’est pourquoi PermissionsBukkit vous permet de classer les lecteurs en groupes, chaque groupe disposant de ses propres autorisations. Ainsi, vous pourrez définir les autorisations de tous sans prendre les devants.

Le fichier de configuration

Nous allons maintenant attaquer la plus grande partie de ce guide: la configuration du plugin. Je vous invite maintenant à télécharger Notepad ++ si ce n’est pas déjà fait (hautement recommandé) et à ouvrir le fichier plug-in config.yml avec le logiciel que vous venez d’acquérir.

Attention : configurer le logiciel pour faire la touche de tabulation (TAB) N'ajoutez pas le caractère spécial des onglets mais quatre espaces! Veillez également à respecter l'indentation (espaces entre le début de la ligne et le texte), le YAML étant basé exclusivement sur celui-ci pour détecter la fin de certains éléments!

Vous devriez normalement avoir ceci:

utilisateurs:
ConspiracyWizard:
autorisations:
permissions.example: true
groupes:
- admin
groupes:
défaut:
autorisations:
permissions.build: false
admin:
autorisations:
autorisations. *: vrai
héritage:
- utilisateur
utilisateur:
autorisations:
permissions.build: true
mondes:
Créatif:
coolplugin.item: true
héritage:
- défaut
des postes:
build: & # 39; & cVous n’avez pas l’autorisation de construire ici. & # 39;

débogage: faux

Ne vous inquiétez pas si vous ne comprenez pas ce qui est écrit, c’est précisément le but de ce guide de tout vous expliquer. Le texte que vous avez ci-dessus est en fait un exemple condensé de tout ce qu'il est possible de faire avec ce plugin, à savoir:

• La liste des utilisateurs
• Un utilisateur (ConspiracyWizard) avec son groupe (admin) et des autorisations individuelles (permissions.example)
• La liste des groupes
• Groupe par défaut, qui correspond aux visiteurs (par défaut), et un exemple d'autorisation non accordée (permissions.build)
• Un groupe (admin) avec un "héritage" ("héritage" en anglais, nous le verrons plus tard)
• Un autre groupe (utilisateur) avec une permission normale (permissions.build: true) et d'autres permissions selon les mondes et un autre héritage
• Une des parties de la configuration du plugin (messages) et une autre (debug)

Commençons maintenant, par ordre décroissant. Vous pouvez traduire le message " Vous n'avez pas la permission de construire ici. " par " Vous n'avez pas les autorisations pour construire ici. ".

La liste des utilisateurs

En commençant par "utilisateurs:", la liste des utilisateurs contient tous les utilisateurs des groupes autres que celui par défaut et vous permet de définir des groupes et des autorisations pour chaque utilisateur. Voici la syntaxe de cette partie:

utilisateurs:
[nom d’utilisateur]:
autorisations:
[node de permission]: [true/false]
[node de permission 2]: [true/false]
[…]

groupes:
– [groupe 1]
– [groupe 2]
[…]
[nom d’utilisateur]:
autorisations:
[node de permission]: [true/false]
[node de permission 2]: [true/false]
[…]

groupes:
– [groupe 1]
– [groupe 2]
[…]
[…]

Voici l'explication complète de tout ce que vous trouvez entre crochets.

• […] – indique que l'information peut être dupliquée et répétée
• permissions – optionnel – la liste des permissions accordées ou non à cet utilisateur
• [nom d’utilisateur] – mettre le nom de la personne (identifiant, identifiant, identifiant, login …) concerné par les informations suivantes
• [node de permission x] – ajouter ici un noeud pour autoriser ou non
• [true/false] – mettre "vrai" pour que le nœud gauche soit autorisé à refuser à la personne indiquée ci-dessus ou "faux". Notez que la plupart du temps, un nœud non spécifié dans les autorisations sera considéré comme refusé ou accessible uniquement aux opérateurs.
• groupes – la liste des groupes auxquels cet utilisateur appartient
• [groupe x] – entrez un nom de groupe auquel appartient l'utilisateur spécifié ci-dessus. S'il est dans plus d'un groupe, il aura les autorisations des deux groupes

La liste des groupes

groupes:
défaut:
autorisations:
[node de permission]: [true/false]
[node de permission 2]: [true/false]
[…]
[groupe 1]:
autorisations:
[node de permission]: [true/false]
[node de permission 2]: [true/false]
[…]

mondes:
[monde 1]:
[node de permission]: [true/false]
[node de permission 2]: [true/false]
[…]
[monde 2]:
[node de permission]: [true/false]
[node de permission 2]: [true/false]
[…]

héritage:
– [groupe 1]
– [groupe 2]
– […]
[groupe 2]:
autorisations:
[node de permission]: [true/false]
[node de permission 2]: [true/false]
[…]

mondes:
[monde 1]:
[node de permission]: [true/false]
[node de permission 2]: [true/false]
[…]
[monde 2]:
[node de permission]: [true/false]
[node de permission 2]: [true/false]
[…]

héritage:
– [groupe 1]
– [groupe 2]
– […]
[…]

Ici, cela devient un peu plus complexe. Tout ce qui se trouve ci-dessus est identique à ici, je ne dirai pas quelques informations en double (moi, flemmard?):

• default – c'est le groupe par défaut, son nom ne peut pas être changé
• [groupe x] – le nom du groupe auquel les informations suivantes s'appliquent
• mondes – utilisez "mondes" ou "autorisations" ou les deux. "Mondes" permet d'appliquer certaines autorisations à certains mondes uniquement
• [monde x] – le nom du monde auquel appartiennent les autorisations suivantes
• héritage – facultatif – vous avez ici le fameux héritage dont nous avons parlé plus haut; les groupes qui héritent des autres auront les mêmes autorisations que les groupes dont ils héritent, en plus des groupes habituels (par exemple, si le groupe "admin" hérite de "utilisateur", il aura alors la permission "d'utiliser" les habituels). Cela évite de devoir copier les mêmes autorisations dix mille fois pour plusieurs groupes différents ne pouvant avoir que des différences.
• [groupe x] (en héritage) – le nom du groupe dont le groupe actuel hérite

Les commandes et permissions spécifiques au plugin

Heureusement pour nous, le plugin a des commandes pour gérer la configuration directement dans le jeu. C’est moins pratique, mais peut aider à promouvoir ou rétrograder un joueur.

Voici la liste complète de toutes les commandes avec les nœuds qui vont avec:

• / permissions reload – permissions.reload – recharge la configuration, plus rapidement que / reload mais s’applique uniquement à PermissionsBukkit
• / vérification des autorisations [node] [player] – permissions.check – vérifie si le joueur [player] a la permission [node]
• / permissions info [node] – permissions.info – permissions.info – affiche des informations sur le nœud [node]
• / dump autorisations [player] [page] – permissions.dump – affiche les informations du joueur [player] sur plusieurs pages (argument [page])
• / permissions groupe – permissions.group. * – liste les commandes associées à la gestion des groupes et donne accès à toutes ces commandes
• / permissions groupe list – permissions.group.list – liste des groupes
• / joueurs du groupe d'autorisations [group] – permissions.group.players – liste les joueurs du groupe [group]
• / groupe d'autorisations setperm [group] [[world:]nœud] [true|false] – permissions.group.setperm – ajoute le noeud [node] dans les autorisations de groupe [group] dans le monde [world] (optionnel) avec true ou false
• / groupe d'autorisations unsetperm [group] [[world:]nœud]- permissions.group.unsetperm – effectue l'opposé de la commande group setperm ci-dessus
• / joueur de permissions – permissions.player. * – liste les commandes associées à la gestion des joueurs et donne accès à toutes ces commandes
• / permissions groupes de joueurs [player] – permissions.player.groups – répertorie les groupes du lecteur [player]
• / permissions player setgroup [player] [group] – permissions.player.setgroup – met le joueur [player] dans le groupe [group]
• / permissions player addgroup [player] [group] – permissions.player.addgroup – ajouter un joueur [player] dans le groupe [group]
• / permissions joueur removegroup [player] [group] – permissions.player.removegroup – supprime le lecteur [player] du groupe [group]
• / autorisations joueur setperm [player] [[world:]nœud] [true|false] – permissions.player.setperm – ajoute le noeud [node] dans les autorisations du joueur [player] dans le monde [world] (optionnel) avec true ou false
• / permissions player unsetperm [player] [[world:]nœud]- permissions.player.unsetperm – effectue l'inverse de la commande de lecteur setperm ci-dessus

Il existe également le noeud permissions.build qui autorise ou non la construction (pour empêcher les visiteurs de casser des blocs, par exemple), ainsi que les autorisations. * Ce qui donne accès à toutes les fonctionnalités du plugin.

Pour les développeurs

L'utilisation des autorisations dans le développement de plugins est très simple. Tout d’abord, vous devez ajouter ces lignes dans le fichier plugin.yml de votre plugin:

autorisations:
[node 1]:
la description: Finit les galères avec les permissions sur votre serveur Bukkit Minecraft ! Avec notre tuto / guide ultra complet, vous aures toutes les clés en main.
défaut: [true/false/op/not op]
[node 2]:
la description: Finit les galères avec les permissions sur votre serveur Bukkit Minecraft ! Avec notre tuto / guide ultra complet, vous aures toutes les clés en main.
défaut: [true/false/op/not op]
[…]

Voici quelques explications:

• [node x] – le nœud auquel les informations suivantes s'appliquent
• Finit les galères avec les permissions sur votre serveur Bukkit Minecraft ! Avec notre tuto / guide ultra complet, vous aures toutes les clés en main. – la description de ce noeud
• [default] – si l'autorisation n'est pas spécifiée dans la configuration de PermissionsBukkit, elle est accordée (true), refusée (false), accordée uniquement aux opérateurs (op) ou aux non-opérateurs (non op).

Pour savoir si un joueur a une permission ou non, il est nécessaire d'utiliser (considérant que joueur est une variable de type Player non null et [node] l'autorisation en question):

si (player.hasPermission ("[node]")

// Si le joueur a la permission, on fait quelque chose

autre

// Sinon on fait autre chose

Préfixes chez le chat

L'avantage des autorisations est de personnaliser le chat en ajoutant des préfixes et des suffixes. Voici un exemple :

On peut voir ici que des préfixes en couleur ont été ajoutés devant le nom du joueur, contenant le monde dans lequel se trouve le joueur et le groupe auquel il appartient. Mais comment fais-tu cela? Vous devez utiliser le plugin Simple Prefix, que je vous invite à télécharger et à installer sur votre serveur maintenant.

Voici la configuration par défaut du plugin:

modèle:
format: & # 39;[time] [world] [prefix][name][suffix]    & # 39;
heure: & # 39;[h:mm aa]& # 39;
Des mondes
monde:
pseudo: & # 39; & e[World]& F
Groupe:
exemple:
préfixe: & # 39; & a[Example]& F
suffixe: & # 39; & # 39;
utilisateur:
Flabaliki:
préfixe: & # 39; & c[Who?]& F
suffixe: & # 39; & # 39;

Voici une explication rapide de cette configuration:

• format – c'est le schéma d'un message, vous pouvez mettre ce que vous voulez avec les couleurs que vous voulez. Vous pouvez afficher des valeurs spéciales comme le temps avec [time], le monde avec [world], le préfixe avec [prefix], le nom de la personne avec [name] et le suffixe avec [suffix]
• heure – il s’agit du format d’affichage de l’heure (tag [time])
• Mondes – vous pouvez déterminer ici les pseudonymes que vos mondes auront. C'est ce texte qui sera affiché à la place du nom classique du monde, pratique quand vous avez un monde avec un mauvais nom (comme monde par exemple)
• Groupe – et oui, vous devez transcrire vos groupes ici! Chaque groupe a son propre préfixe et suffixe
• Utilisateur – si vous ne souhaitez pas utiliser le système de permission pour déterminer qui fait partie de chaque groupe (ce que nous ferons), vous pouvez utiliser cette fonctionnalité.

Voici la configuration typique du plugin, à utiliser avec PermissionsBukkit:

modèle:
format: & # 39;[time] [world] [prefix][name][suffix] & # 39;
heure: & # 39;[h:mm aa]& # 39;
Des mondes
monde:
pseudo: & # 39; & e[World]& F
Groupe:
exemple:
préfixe: & # 39; & a[Example]& F
suffixe: »
utilisateur:
Flabaliki:
préfixe: & # 39; & c[Who?]& F
suffixe: »

Et les explications qui vont bien:

• [monde x] – le nom du monde dont vous souhaitez personnaliser le nom
• [pseudo] – le nom que tu veux donner à ce monde
• [groupe x] – le nom du groupe pour personnaliser le préfixe et le suffixe, ce ne sont pas nécessairement les mêmes groupes que ceux de PermissionsBukkit
• [préfixe] – le préfixe à mettre pour ce groupe
• [suffixe] – le suffixe à mettre pour ce groupe

Une fois défini, il est nécessaire d'indiquer au plug-in quel groupe de PermissionsBukkit correspond à quel groupe de préfixe simple. Pour ce faire, ajoutez l'autorisation simpleprefix au groupe de votre choix.[groupe], ou [groupe] est le groupe correspondant dans le préfixe simple. Par exemple, le groupe "par défaut" aura l'autorisation simpleprefix.visitor car le groupe dans la configuration du préfixe simple s'appelle "visiteur".

De conclure

Pour conclure, nous pouvons dire que PermissionsBukkit est un plugin d'utilisation compliqué, mais une fois que vous le maîtrisez, vous pouvez faire de grandes choses avec;).