Whitelist et opérateurs

Un serveur ouvert à tous se fait visiter. Cette page explique comment n’autoriser que les joueurs que vous connaissez, comment donner les droits d’administration aux bonnes personnes, et comment exclure celles qui posent problème. Elle s’adresse aux propriétaires d’un serveur Minecraft CloudFive, administré depuis panel.cloudfive.xyz.

Deux notions à ne pas confondre :

• La whitelist et les opérateurs concernent le jeu : qui peut se connecter, et qui peut taper des commandes en jeu.
• Les sous-utilisateurs du panel concernent l’hébergement : qui peut redémarrer le serveur, lire la console ou toucher aux fichiers. C’est un autre système, décrit dans Gérer les sous-utilisateurs.

Donner le statut d’opérateur à un joueur ne lui ouvre pas votre panel. Et l’inverse est vrai aussi.

Où vivent ces réglages

Quatre fichiers à la racine du serveur, que le serveur écrit lui-même quand vous passez par les commandes :

Fichier	Contenu
whitelist.json	les joueurs autorisés à se connecter
ops.json	les opérateurs et leur niveau de permission
banned-players.json	les joueurs bannis
banned-ips.json	les adresses IP bannies

Le plus simple est de ne jamais les éditer à la main : les commandes font le même travail sans risque d’erreur de syntaxe. Si vous y touchez quand même, passez par le gestionnaire de fichiers et respectez le JSON — une virgule en trop et le serveur ignore le fichier entier.

Taper une commande : avec ou sans la barre oblique ?

Depuis la console du panel, les commandes s’écrivent sans / : whitelist add Alex. En jeu, dans le tchat, elles s’écrivent avec : /whitelist add Alex. Toutes les commandes de cette page sont données au format console.

Activer la whitelist

1. Ouvrez votre serveur dans le panel, puis la console (guide).

2. Saisissez la commande d’activation :

   whitelist on

3. Ajoutez-vous immédiatement, avant de vous déconnecter :

   whitelist add VotrePseudo

4. Vérifiez la liste :

   whitelist list

L’activation est immédiate et survit aux redémarrages : la commande écrit white-list=true dans server.properties. Vous pouvez aussi modifier cette ligne vous-même, serveur arrêté.

Une ligne voisine mérite votre attention :

server.properties

white-list=true
enforce-whitelist=true

Avec enforce-whitelist=true, un joueur retiré de la whitelist est expulsé tout de suite, même s’il est déjà connecté. Sans elle, il reste en jeu jusqu’à sa prochaine déconnexion.

Attention

Activer la whitelist sans s’y être ajouté ferme la porte à tout le monde, vous compris. Ce n’est pas grave — la console du panel reste accessible et vous pouvez vous ajouter depuis là. Mais faites les deux commandes dans la même minute.

Ajouter et retirer des joueurs

Par commande (recommandé)

whitelist add Alex
whitelist remove Alex
whitelist list
whitelist reload

Le serveur résout le pseudo auprès des serveurs d’authentification de Minecraft et enregistre l’identifiant unique du joueur. C’est ce qui rend l’entrée fiable même si le joueur change de pseudo plus tard.

Par le fichier

Modifiez whitelist.json dans le gestionnaire de fichiers, puis rechargez :

whitelist reload

Sans ce reload, le serveur continue d’utiliser la liste qu’il a en mémoire et réécrira votre fichier à la première commande. C’est la cause numéro un des « j’ai ajouté le joueur mais il est refusé ».

Note

Un pseudo mal orthographié est rejeté : le serveur répond qu’il ne trouve pas le joueur. Les pseudos Minecraft ne contiennent que des lettres, des chiffres et des tirets bas, sans espace. Demandez une copie exacte à l’intéressé plutôt que de le saisir à l’oreille.

Serveur en mode hors-ligne

Si online-mode=false dans server.properties, les pseudos ne sont plus vérifiés : n’importe qui peut se connecter sous le nom d’un joueur de votre whitelist, et les identifiants uniques ne correspondent plus à ceux d’un serveur normal. Une whitelist n’y protège plus de rien. Laissez online-mode=true sauf si votre installation l’exige, et dans ce cas comptez sur un plugin d’authentification plutôt que sur la whitelist.

Attribuer le statut d’opérateur

Un opérateur peut utiliser les commandes d’administration en jeu : se téléporter, changer de mode, donner des objets, gérer la whitelist.

1. Depuis la console, passez la commande :

   op Alex

2. Vérifiez la liste des opérateurs en ouvrant ops.json, ou en relisant la réponse de la console.

3. Pour retirer les droits :

   deop Alex

Danger

Un opérateur de niveau 4 peut arrêter le serveur, bannir les autres joueurs, se donner n’importe quel objet et — via les blocs de commande — modifier le monde en profondeur. N’accordez ce statut qu’à des personnes que vous connaissez, et retirez-le dès qu’il n’est plus utile. Un deop ne répare pas un monde saccagé : seule une sauvegarde le fait (guide).

Les niveaux de permission

Le niveau est enregistré dans ops.json, champ level. Chaque niveau inclut les précédents.

Niveau	Ce qu’il autorise
1	ignorer la protection de la zone de spawn
2	les commandes de jeu : mode de jeu, difficulté, téléportation, objets, règles de jeu, édition des blocs de commande
3	la gestion des joueurs : expulsion, bannissement, whitelist, attribution du statut d’opérateur
4	la gestion du serveur : arrêt, sauvegarde forcée, toutes les commandes

La valeur attribuée par défaut par la commande op se règle dans server.properties :

server.properties

op-permission-level=4

Baissez-la à 2 ou 3 si vous voulez que vos modérateurs disposent des commandes utiles sans pouvoir arrêter le serveur ni se déop les uns les autres.

Pour aller plus fin : un plugin de permissions

Les quatre niveaux de Minecraft sont grossiers — on ne peut pas donner la téléportation sans donner le mode créatif. Sur un serveur Paper ou Spigot, un plugin de permissions (LuckPerms est le plus courant) permet de composer des grades commande par commande, et de ne garder aucun opérateur du tout. Voyez Installer des plugins et des mods et Versions, Paper, Forge et Fabric.

Gérer les bannissements

Trois outils, du plus doux au plus définitif.

Expulser — le joueur est déconnecté et peut revenir aussitôt. Utile pour couper court à un comportement sans sanctionner.

kick Alex Calme-toi cinq minutes

Bannir un joueur — l’entrée est liée à son identifiant unique, elle résiste donc à un changement de pseudo.

ban Alex Griefing sur la base commune
banlist players
pardon Alex

Bannir une adresse IP — à réserver aux cas lourds.

ban-ip 203.0.113.10
banlist ips
pardon-ip 203.0.113.10

Attention

Une adresse IP est rarement personnelle : elle peut être partagée par toute une maison, un campus ou un opérateur mobile. Un ban-ip exclut souvent des joueurs innocents, et le fautif revient dès que son opérateur lui attribue une nouvelle adresse. Préférez le bannissement par pseudo, et notez l’adresse quelque part au lieu de la bannir.

Note

Ces bannissements n’ont rien à voir avec la protection réseau de CloudFive. L’anti-DDoS filtre les attaques en amont, en permanence et sans réglage de votre part — voyez Comprendre l’anti-DDoS CloudFive. À l’inverse, bannir une IP dans Minecraft n’arrête pas une attaque : le trafic arrive quand même jusqu’au serveur.

Pour une modération sérieuse — bannissements temporaires, historique, motifs, plusieurs modérateurs — passez par un plugin dédié. Les fichiers de Minecraft ne gardent ni durée ni journal lisible.

Si ça ne marche pas

Le joueur est dans la whitelist mais reste refusé. Dans l’ordre : rechargez la liste (whitelist reload), vérifiez l’orthographe exacte du pseudo, et assurez-vous qu’il n’est pas banni par ailleurs (banlist players) — un bannissement a priorité sur la whitelist, et le message affiché au joueur n’est pas toujours explicite.

Je me suis enfermé dehors. La console du panel est un opérateur permanent : elle n’est jamais soumise à la whitelist ni aux bannissements. Ajoutez-vous depuis là, ou passez whitelist off le temps de remettre les choses en ordre.

Mes modifications de whitelist.json ou ops.json disparaissent. Le serveur réécrit ces fichiers depuis sa mémoire. Soit vous l’arrêtez avant d’éditer (guide), soit vous rechargez après. La bonne habitude reste de passer par les commandes.

La commande op répond que le joueur est introuvable. Le serveur n’arrive pas à joindre les serveurs d’authentification de Minecraft, ou le pseudo n’existe pas. Vérifiez le pseudo, puis consultez status.cloudfive.xyz : si un incident réseau est en cours, l’information y figure. Les pannes des services Mojang, elles, se constatent dans la console sous forme d’erreurs de connexion sortante.

Un joueur banni revient sous un autre pseudo. C’est la limite du système : rien n’empêche un compte neuf. La whitelist est la seule réponse efficace — on passe d’une liste de refusés à une liste d’autorisés.

Si vous restez bloqué, ouvrez un ticket de support avec le nom du serveur, la commande saisie et la réponse exacte de la console.