Whitelist Minecraft : comment gérer les accès de votre serveur

La whitelist est le moyen le plus simple de contrôler qui peut rejoindre votre serveur Minecraft. Elle est indispensable pour les serveurs privés (famille, amis, guilde) ou pendant les phases de développement. Ce guide couvre toutes les commandes, la gestion avancée et les alternatives.

Activer la whitelist

Il y a deux façons d'activer la whitelist :

Option 1 — Via la console (instantané, sans redémarrage) :

/whitelist on

Option 2 — Via server.properties (permanent) :

white-list=true

Redémarrez le serveur après avoir modifié server.properties. La commande /whitelist on s'applique immédiatement mais doit être re-exécutée si vous utilisez white-list=false dans les propriétés.

Toutes les commandes whitelist

# Activer la whitelist
/whitelist on

# Désactiver la whitelist
/whitelist off

# Ajouter un joueur
/whitelist add PseudoJoueur

# Retirer un joueur
/whitelist remove PseudoJoueur

# Voir tous les joueurs autorisés
/whitelist list

# Recharger la liste depuis whitelist.json (si édité manuellement)
/whitelist reload

Fichier whitelist.json — édition manuelle

La whitelist est stockée dans whitelist.json à la racine du serveur. Vous pouvez l'éditer directement via le gestionnaire de fichiers Pterodactyl pour ajouter plusieurs joueurs rapidement :

[
  {
    "uuid": "069a79f4-44e9-4726-a5be-fca90e38aaf5",
    "name": "Notch"
  },
  {
    "uuid": "853c80ef-3c37-49fd-aa49-938b674adae6",
    "name": "jeb_"
  }
]

L'UUID est requis pour les serveurs en mode online (authentification Mojang). Pour trouver l'UUID d'un joueur : namemc.com Inutile de le chercher à la main : /whitelist add <pseudo> récupère l'UUID et l'écrit dans whitelist.json. La commande /whitelist list, elle, affiche les pseudos autorisés.

💡 Après avoir édité whitelist.json manuellement, exécutez /whitelist reload dans la console pour appliquer les changements sans redémarrer.

Gestion des ops (opérateurs)

Les opérateurs ont accès aux commandes d'administration même si la whitelist est activée. Gérez-les séparément :

# Donner les droits op à un joueur
/op PseudoJoueur

# Retirer les droits op
/deop PseudoJoueur

# Bannir un joueur (même s'il est sur la whitelist)
/ban PseudoJoueur raison_du_ban

# Débannir
/pardon PseudoJoueur

# Bannir une IP
/ban-ip 192.168.1.1

Alternatives à la whitelist vanilla

La whitelist vanilla manque de fonctionnalités pour les grands serveurs. Voici deux plugins qui la remplacent :

Foire aux questions

Un joueur banni peut-il contourner la whitelist en changeant de pseudo ?
Non, pas sur un serveur en ligne (online-mode=true). Les identifiants sont basés sur l'UUID Mojang, pas le pseudo. Un joueur qui change de pseudo garde le même UUID et reste banni. En revanche, un compte différent (acheté) aura un UUID différent et pourrait contourner le ban — il faut dans ce cas bannir l'IP.

La whitelist fonctionne-t-elle avec Velocity ou BungeeCord ?
Oui, mais Velocity et BungeeCord n'ont pas de whitelist intégrée : velocity.toml ne contient aucune option de ce type. Deux solutions : activer la whitelist vanilla sur chaque back-end (avec le forwarding moderne, l'UUID du joueur est bien transmis), ou installer un plugin de whitelist côté proxy pour gérer une seule liste pour tout le réseau. Si un seul back-end est protégé, les joueurs non autorisés restent libres sur les autres.

Comment créer une whitelist temporaire pendant la maintenance ?
Activez la whitelist (/whitelist on), retirez tous les joueurs sauf les admins, effectuez la maintenance, puis remettez les joueurs via whitelist.json + /whitelist reload. Pour un message personnalisé à la connexion, un plugin dédié comme Maintenance (Paper, Velocity, BungeeCord) bloque les joueurs non autorisés le temps de l'intervention ; EssentialsX n'a pas de commande de maintenance.

Publié le 11 novembre 2026 par l'Équipe OnPowered — hébergeur belge de serveurs Minecraft et VPS.