Mettre une whitelist sur son serveur Minecraft

La whitelist (liste blanche) ne laisse entrer que les joueurs que vous avez choisis. C'est la protection la plus simple contre les inconnus, et la base des serveurs semi-privés, où l'on entre sur candidature. Elle sert aussi pendant une maintenance ou avant l'ouverture, pour tester avec l'équipe.

Activer la whitelist

Depuis la console (ou en jeu, avec les droits d'opérateur) :

whitelist on
whitelist add Steve
whitelist list

La commande whitelist on passe white-list=true dans server.properties : le réglage survit au redémarrage. Les joueurs ajoutés sont enregistrés dans whitelist.json, avec leur pseudo et leur UUID.

Commande	Effet
whitelist on / off	active ou désactive la liste
whitelist add <pseudo>	ajoute un joueur
whitelist remove <pseudo>	retire un joueur
whitelist list	affiche la liste
whitelist reload	relit whitelist.json après une modification à la main

enforce-whitelist : expulser ceux qui ne sont plus sur la liste

Par défaut, retirer un joueur de la liste ne l'expulse pas s'il est connecté : il ne pourra simplement pas revenir. Avec enforce-whitelist=true dans server.properties, le serveur expulse aussitôt tout joueur connecté qui n'est pas sur la liste au moment où elle est rechargée. C'est le réglage à activer pour une maintenance : whitelist on, et tout le monde sauf l'équipe sort.

Le piège des UUID

La whitelist retient l'UUID du joueur, pas seulement son pseudo : un joueur qui change de pseudo reste autorisé. Deux cas demandent de l'attention :

• Serveur en online-mode=false (comptes non officiels) : l'UUID est calculé à partir du pseudo. N'importe qui prenant le pseudo d'un joueur autorisé passe la whitelist. Sur un tel serveur, la whitelist ne protège qu'avec un plugin d'authentification par mot de passe. Voir Protéger son serveur.
• Derrière un proxy (Velocity) : activez le transfert des informations de joueur (modern forwarding), sinon les UUID reçus par les serveurs ne correspondent pas à ceux des joueurs. L'outil Pseudo ↔ UUID donne l'UUID officiel et l'UUID hors ligne d'un pseudo, pour vérifier.

Les joueurs Bedrock

Avec Geyser et Floodgate, les joueurs Bedrock n'ont pas de compte Java : whitelist add ne les trouve pas. Floodgate fournit sa propre commande :

fwhitelist add Steve

Indiquez le pseudo Xbox du joueur (son gamertag), tel qu'il apparaît dans Minecraft Bedrock.

Une whitelist par candidature

Beaucoup de serveurs semi-privés fonctionnent ainsi : on candidate, l'équipe valide, on est ajouté. Pour que ça tienne dans la durée :

• Un formulaire court : pseudo exact, âge, comment le joueur a connu le serveur, une ou deux questions sur ce qu'il vient chercher.
• Une réponse sous 48 heures. Au-delà, le joueur est parti ailleurs.
• Des critères écrits, pour que chaque membre de l'équipe décide de la même façon.
• Un message d'accueil au premier passage : règlement, salon Discord, premiers pas.

La whitelist devient un argument : sur votre fiche, précisez « whitelist sur candidature » et le délai de réponse. Les joueurs qui cherchent une communauté calme la recherchent justement.

Une whitelist liée à Discord

DiscordSRV peut exiger qu'un joueur ait lié son compte Discord pour se connecter : seuls les membres de votre serveur Discord entrent, sans rien ajouter à la main. C'est pratique pour une communauté déjà rassemblée sur Discord ; le guide Monter le Discord de son serveur détaille la liaison.

Les erreurs fréquentes

• Une faute de frappe dans le pseudo : le joueur est refusé. Vérifiez avec whitelist list.
• Modifier whitelist.json sans whitelist reload : le changement n'est pas pris en compte.
• Oublier white-list=true après un changement d'hébergeur : le serveur est ouvert à tous. Le générateur de server.properties montre ce réglage et les autres.
• Confondre whitelist et liste des opérateurs : être sur la whitelist ne donne aucun droit, seulement l'accès.