Configurer la whitelist d’un serveur Minecraft – n’autoriser que les amis

Avec une whitelist Minecraft, tu limites ton serveur aux joueurs explicitement autorisés. C’est utile pour les mondes Survival privés, les projets de construction, les événements ou les communautés où tu veux garder le contrôle des accès. Trois points sont essentiels : white-list=true, des noms de joueurs correctement tenus à jour et enforce-whitelist=true, afin que les changements s’appliquent de façon fiable.

Prérequis

Tu as besoin d’un accès à la console du serveur, de droits OP en jeu ou d’un accès au fichier server.properties. Tu dois aussi connaître les noms Minecraft exacts des joueurs. Pour les comptes Java, le nom du joueur suffit généralement. Si des joueurs Bedrock rejoignent via Geyser, le nom peut apparaître avec un préfixe selon la configuration de Geyser ; dans l’exemple de départ, un point est utilisé.

Si tu es justement en train de configurer le serveur de manière générale, le guide complémentaire Louer et configurer un serveur Minecraft – Guide complet 2026 peut t’aider. Pour d’autres configurations coop avec une logique d’accès similaire, tu trouveras aussi Louer et configurer un serveur Valheim – Guide coop 2026.

Configurer la whitelist Minecraft

Qu’est-ce que la whitelist ?

La whitelist est un contrôle d’accès pour ton serveur. Seuls les joueurs présents sur la liste peuvent rejoindre. Elle ne remplace pas la modération, mais empêche des comptes inconnus de rejoindre simplement via l’adresse du serveur. Pour un hébergement multi-jeux payant, c’est particulièrement pratique, car tu peux séparer plus clairement l’accès au serveur, les demandes de support et les opérations : celui qui n’est pas sur la liste ne peut pas entrer.

Microsoft documente la commande Bedrock correspondante sous la forme /allowlist ; /whitelist y est mentionné comme alias, et les actions add, remove, list, off, on et reload sont décrites : Microsoft Learn sur allowlist/whitelist. Pour les serveurs Java, les entrées server.properties et les commandes /whitelist montrées ci-dessous restent la base pratique.

Activer la whitelist

Dans server.properties :

white-list=true
enforce-whitelist=true

Pendant que tu es dans server.properties : la ligne motd définit l’entrée de ton serveur dans la liste des serveurs — tu peux la mettre en couleur avec notre générateur MOTD gratuit.

Ou avec une commande en jeu :

/whitelist on

Si tu modifies directement le fichier, arrête d’abord le serveur ou redémarre-le ensuite. Les changements via commandes sont plus pratiques en fonctionnement, car tu n’as pas besoin d’ouvrir le fichier à chaque fois.

Ajouter des joueurs

/whitelist add <NomDuJoueur>

Pour les joueurs Bedrock (via Geyser) :

/whitelist add .<BedRockName>

Fais attention à l’orthographe. Si un joueur ne peut pas rejoindre alors que tu l’as ajouté, compare son nom avec l’affichage lors de la tentative de connexion ou dans les logs du serveur. Avec les configurations Geyser, il est particulièrement important de savoir si un préfixe est utilisé et comment la casse est traitée.

Gérer la whitelist

Utilise /whitelist list après chaque changement important. Tu repères ainsi immédiatement les fautes de frappe ou les noms saisis deux fois par erreur. Si tu supprimes un joueur, enforce-whitelist=true est important pour que l’exclusion ne devienne pas seulement pertinente à la prochaine tentative de connexion.

whitelist.json

La whitelist est enregistrée dans whitelist.json :

[
  {
    "uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "name": "NomDuJoueur"
  }
]

Modifie ce fichier uniquement si tu sais ce que tu fais. Pour l’exploitation normale, les commandes sont plus sûres, car le serveur gère correctement les noms et les UUID. Si tu modifies le fichier manuellement, utilise ensuite /whitelist reload ou redémarre le serveur.

Vérifier le résultat

Vérifie d’abord avec /whitelist list que tous les joueurs souhaités sont présents. Ensuite, un joueur inscrit devrait pouvoir rejoindre. Un compte non inscrit devrait être refusé. Contrôle aussi la console du serveur : tu y verras si la tentative de connexion échoue à cause de la whitelist, d’un mauvais nom ou d’un autre problème.

Pour les projets privés, une petite routine est utile : ajouter le joueur, tester la connexion, afficher la liste, documenter le changement. Surtout avec plusieurs admins, cela évite que les questions de support restent floues plus tard.

Dépannage

Le joueur est sur la liste, mais ne peut pas rejoindre

Vérifie le nom exact, le mode de jeu et les éventuels préfixes avec Geyser. En cas de doute, supprime l’entrée avec /whitelist remove <name>, puis ajoute-la à nouveau.

Les joueurs supprimés restent en ligne

Définis enforce-whitelist=true et recharge la liste avec /whitelist reload. Sans ce réglage, les joueurs supprimés peuvent, selon l’état du serveur, rester connectés jusqu’à leur déconnexion.

Les changements dans le fichier ne s’appliquent pas

Si tu as modifié server.properties ou whitelist.json manuellement, recharge la whitelist ou redémarre proprement le serveur. Vérifie aussi que tu as bien modifié le fichier de l’instance de serveur active.

Confondre OPs et whitelist

Les droits d’opérateur sont des droits d’administration, pas une liste d’accès propre. Garde peu d’OPs et gère la whitelist séparément. Ainsi, il reste clair qui peut administrer et qui peut seulement jouer.

Conseils

• Enforce Whitelist : active enforce-whitelist=true pour que les joueurs soient expulsés lorsqu’ils sont supprimés de la liste
• Ops : les opérateurs (OPs) peuvent aussi rejoindre sans whitelist si enforce-whitelist est désactivé
• Automatisation : utilise des plugins comme EasyWhitelist pour une gestion basée sur le Web

Vérification, limites et retour arrière sûr

Le guide « Configurer la whitelist d’un serveur Minecraft – n’autoriser que les amis » s’applique au type de serveur décrit dans l’article et à l’état des versions visible au moment de la vérification. Les noms de menus, versions disponibles, compatibilités de mods ou plugins et ressources nécessaires peuvent changer après des mises à jour. Ne transfère donc aucune valeur sans vérification vers une autre version de jeu, de loader ou de serveur.

Avant de modifier le monde, la sauvegarde, la configuration ou des extensions, crée une sauvegarde des fichiers concernés. Ne change ensuite qu’une seule étape cohérente à la fois et vérifie-la avec la même version client et serveur que celle avec laquelle tu veux jouer plus tard.

Un test individuel réussi ne garantit ni les performances ni la disponibilité. La taille du monde, les mods, les plugins, le nombre de joueurs, le chemin réseau et la charge simultanée peuvent modifier le résultat. Documente la version, le changement et le résultat du test afin de pouvoir comprendre les écarts ultérieurs.

FAQ

Dois-je redémarrer après chaque changement ?

Pas forcément. Si tu utilises des commandes comme /whitelist add, /whitelist remove ou /whitelist reload, tu peux gérer la liste pendant que le serveur tourne. Après des modifications manuelles de fichiers, un rechargement ou un redémarrage est judicieux.

La whitelist est-elle meilleure qu’un mot de passe ?

Pour Minecraft, la whitelist est la méthode la plus courante, car elle autorise des comptes précis. Un mot de passe ne protège pas contre des identifiants transmis à d’autres, tandis qu’une whitelist est liée aux noms de joueurs ou aux comptes.

Dois-je toujours activer enforce-whitelist=true ?

Pour les serveurs privés, c’est généralement utile. Ce réglage garantit que les joueurs supprimés ne restent pas en ligne après un rechargement alors qu’ils ne sont plus sur la liste.

La whitelist fonctionne-t-elle avec les mods et plugins ?

Oui, la whitelist de base est une fonction serveur. Les plugins peuvent offrir une gestion supplémentaire, mais ils doivent être choisis consciemment et maintenus à jour.

Que faire avec les joueurs Bedrock via Geyser ?

Vérifie comment ta configuration Geyser mappe les noms Bedrock. Dans l’exemple, .<BedRockName> est utilisé. Si la connexion échoue, contrôle le nom réellement affiché dans la console ou les logs.