Allowlist et permissions opérateur sur un serveur Minecraft Bedrock

Deux fichiers contrôlent l’accès à un serveur Bedrock : allowlist.json décide qui peut entrer, et permissions.json décide ce que chacun peut faire. Ne les confondez pas.

L’allowlist

Dans BDS, allow-list=true est le réglage par défaut. Seuls les joueurs inscrits peuvent alors se connecter. C’est idéal pour un serveur entre amis. Pour un serveur public, passez la valeur à false dans server.properties.

Ajouter un joueur

Dans la console du serveur, sans barre oblique, utilisez le Gamertag Xbox du joueur :

allowlist add NomDuJoueur
allowlist add "Nom Avec Espaces"
allowlist remove NomDuJoueur
allowlist list

Pas besoin de redémarrer. Les guillemets sont obligatoires si le Gamertag contient un espace.

Modifier le fichier à la main

Le fichier allowlist.json contient un tableau JSON :

[
  { "ignoresPlayerLimit": false, "name": "NomDuJoueur" },
  { "ignoresPlayerLimit": true, "name": "Administrateur" }
]

ignoresPlayerLimit laisse entrer un joueur même quand le serveur est plein, ce qui est pratique pour les administrateurs. Le serveur complète le fichier avec le xuid du joueur lors de sa première connexion. Après une modification manuelle, appliquez les changements :

allowlist reload

Les rôles

Bedrock propose trois rôles :

Rôle	Ce qu’il permet
visitor	Observer le monde sans le modifier
member	Jouer normalement
operator	Jouer et utiliser les commandes d’administration

Le rôle attribué par défaut aux nouveaux joueurs se règle avec default-player-permission-level, sur member à l’origine.

Nommer un opérateur

Le joueur doit être connecté. Dans la console :

op NomDuJoueur
deop NomDuJoueur

Le fichier permissions.json

Ce fichier, placé à côté de l’exécutable, associe un rôle à un identifiant xuid :

[
  { "permission": "operator", "xuid": "2535400000000000" },
  { "permission": "visitor", "xuid": "2535411111111111" }
]

Ce xuid est différent du Gamertag. Le plus simple pour l’obtenir est de faire connecter le joueur une fois : son identifiant apparaît dans la console du serveur à côté de son nom. Il faut un online-mode actif pour que l’identifiant soit vérifié.

Après une modification manuelle, rechargez le fichier depuis la console :

permission reload

La commande permission list affiche les rôles actuellement appliqués.

Les commandes en jeu

Être opérateur ne suffit pas : allow-cheats doit aussi valoir true dans server.properties pour utiliser la plupart des commandes en jeu. Consultez notre liste des commandes Bedrock.

La configuration d’un serveur entre amis

1. Gardez allow-list=true.
2. Laissez online-mode=true.
3. Ajoutez chaque ami avec allowlist add.
4. Faites-vous connaître en tant qu’opérateur avec op VotreGamertag.
5. Gardez default-player-permission-level=member, ou utilisez visitor si certains invités ne doivent pas construire.

La configuration d’un serveur public

1. Passez à allow-list=false.
2. Laissez online-mode=true, sinon rien ne garantit l’identité des joueurs.
3. Réservez le rôle operator à l’équipe.
4. Ne mettez jamais default-player-permission-level=operator.
5. Pour modérer, le logiciel officiel propose kick. Les fonctions de bannissement avancées demandent un plugin sur PowerNukkitX, ou un addon.

PowerNukkitX

PowerNukkitX fonctionne différemment : l’allowlist est désactivée par défaut, s’active avec allowList dans pnx.yml, et utilise le fichier white-list.txt. Voir notre guide d’installation de PowerNukkitX.

Problèmes fréquents

« Vous n’êtes pas invité sur ce serveur ». Le joueur n’est pas dans la liste, ou vous avez fait une faute dans son Gamertag. Vérifiez aussi qu’il n’a pas changé de nom récemment.

Le rôle disparaît au redémarrage. Attribuez-le durablement par permissions.json, en vérifiant le xuid.

Une ancienne installation utilise whitelist.json. Si ce fichier est présent, il remplace allowlist.json. Pour migrer, supprimez allowlist.json, renommez whitelist.json en allowlist.json, puis redémarrez.

Le fichier est ignoré. Une virgule mal placée suffit à invalider un fichier JSON. Passez-le dans un validateur.