Commandes whitelist, op et ban de Minecraft

Pour laisser entrer un ami, tapez whitelist add PSEUDO. Pour en faire un opérateur, op PSEUDO. Pour bloquer un joueur, ban PSEUDO. Tapez-les dans la console du serveur sans slash, ou dans le chat du jeu avec un slash si vous êtes déjà opérateur. Sur Java Edition 26.3, un nouveau serveur démarre avec la liste blanche activée : personne ne peut se connecter sans avoir été ajouté à la liste. Le générateur ci-dessous écrit la commande exacte.

Pour Java Edition 26.3. La syntaxe, les types d’arguments, les noms des niveaux de permission et les valeurs par défaut viennent des données que génère le serveur officiel 26.3 (MESURÉ, 4 octobre 2026) ; les autres faits sont étiquetés comme secondaires. Nous n’avons pas lancé de session de joueur. Java Edition uniquement : Bedrock utilise d’autres commandes.

Générateur de commandes

Choisissez l’action, saisissez le pseudo, ajoutez une raison si la commande en accepte une. Vous obtenez la forme console et la forme en jeu. Si JavaScript est désactivé, utilisez les tableaux plus bas.

Exemples

Ce que le générateur écrit pour des tâches courantes :

Objectif	Console du serveur	En jeu
Laisser entrer un ami	whitelist add Alex_2	/whitelist add Alex_2
Nommer un ami opérateur	op Steve	/op Steve
Bannir un vandale, avec une raison	ban Mallory griefing the spawn	/ban Mallory griefing the spawn
Bannir une adresse	ban-ip 203.0.113.7 spam	/ban-ip 203.0.113.7 spam
Expulser un joueur inactif	kick Jordan AFK too long	/kick Jordan AFK too long
Lever un bannissement	pardon Mallory	/pardon Mallory

Liste blanche (whitelist)

La liste blanche est la liste des joueurs autorisés à entrer. Quand elle est activée, quiconque n’y figure pas, et n’est pas opérateur, est refusé à la connexion.

Les crochets indiquent un argument facultatif. Chaque commande est la même dans la console et en jeu ; seul le slash initial change.

Commande	Ce qu’elle fait	Droits
whitelist add <targets>	Inscrit un joueur sur la liste blanche, même s’il n’est pas connecté.	Niveau 3 (admins)
whitelist remove <targets>	Retire un joueur de la liste blanche.	Niveau 3 (admins)
whitelist on	Active la liste blanche.	Niveau 3 (admins)
whitelist off	Désactive la liste blanche.	Niveau 3 (admins)
whitelist list	Affiche les pseudos de la liste blanche.	Niveau 3 (admins)
whitelist reload	Relit whitelist.json sur le disque. À utiliser après une modification à la main.	Niveau 3 (admins)

La valeur par défaut en 26.3 : la liste blanche est activée

Un serveur 26.3 tout neuf écrit white-list=true dans server.properties (MESURÉ : le fichier généré par le serveur officiel 26.3 dans un dossier vierge, 4 octobre 2026). Avant la 26.3, la liste blanche était désactivée par défaut (source secondaire : l’historique du wiki communautaire place le changement dans une version de test précoce de la 26.3 ; nous n’avons pas lancé de serveur plus ancien).

Un nouveau serveur a une liste blanche vide et aucun opérateur (DÉDUIT : personne n’a encore été ajouté) : activée, elle refuse donc tous les joueurs, avec un message disant que vous n’êtes pas sur la liste blanche (la valeur par défaut est MESURÉE ; le wiki communautaire liste les messages de déconnexion, et les joueurs les voient dans leur langue ; le fait que les opérateurs passent outre la liste blanche vient aussi du wiki, source secondaire). La première commande doit venir de la console du serveur (ou de la console de votre panneau d’hébergement) : whitelist add VotrePseudo, ou op VotrePseudo.

Pour un serveur ouvert, tapez whitelist off dans la console, ou mettez white-list=false dans server.properties et redémarrez. Pour un serveur privé entre amis, laissez-la activée.

Les deux clés de server.properties

Clé	Valeur par défaut (26.3)	Rôle
white-list	true	Active la liste blanche. Activée, un joueur qui n’est ni dans whitelist.json ni opérateur est refusé à la connexion.
enforce-whitelist	false	Avec false, recharger la liste ne déconnecte personne. Avec true, un rechargement contrôle aussi les joueurs en ligne, et ceux que la nouvelle liste n’inclut pas sont renvoyés du serveur.

Les valeurs par défaut sont MESURÉES dans le fichier 26.3 généré. Le comportement des deux clés vient du wiki communautaire (source secondaire) et n’a pas été vérifié sur un serveur en marche. Les commandes whitelist on et whitelist off activent et désactivent la liste blanche pendant que le serveur tourne (même source) ; nous n’avons pas vérifié si elles réécrivent aussi la clé white-list.

Toutes les clés du fichier sont expliquées sur notre page server.properties.

whitelist.json

La liste blanche est dans whitelist.json, dans le dossier du serveur. Chaque entrée contient un pseudo et un UUID, et le serveur vérifie l’UUID, pas le pseudo (wiki communautaire, source secondaire). Si vous modifiez le fichier à la main pendant que le serveur tourne, lancez ensuite whitelist reload (même source).

Pourquoi ne suis-je pas sur la liste blanche ?

Un message disant que vous n’êtes pas sur la liste blanche signifie que le serveur n’a trouvé aucune entrée pour votre compte et que vous n’êtes pas opérateur. Les causes, de la plus courante à la plus rare :

La liste blanche est activée et vous n’y êtes pas. C’est le cas normal sur un serveur 26.3, où elle démarre activée. Un opérateur ou la console lance whitelist add VotrePseudo.
Le mauvais pseudo a été ajouté. Le serveur vérifie l’UUID du compte (source secondaire). Une faute de frappe peut désigner un autre compte, bien réel (DÉDUIT), qui entre à la place de votre ami. Lancez whitelist list, comparez avec le vrai pseudo, retirez la mauvaise entrée avec whitelist remove puis ajoutez la bonne. Un joueur qui a changé de pseudo correspond toujours : la liste peut afficher l’ancien pseudo, mais l’UUID est le même (DÉDUIT de la même source). list uuids affiche l’UUID de chaque joueur en ligne.
Le serveur tourne en mode hors ligne (online-mode=false). Le wiki communautaire (source secondaire) indique qu’en mode hors ligne, l’identifiant de chaque joueur est calculé à partir du pseudo tapé et non tiré de son compte Mojang : une entrée créée en mode en ligne ne correspond donc plus. Nous ne l’avons pas reproduit. Retirez l’entrée et ajoutez de nouveau le pseudo pendant que le serveur tourne dans le mode que vous garderez. En mode hors ligne, la liste blanche ne protège pas le serveur : quiconque tape un pseudo de la liste y correspond (DÉDUIT de la même source). Gardez online-mode=true.
whitelist.json a été modifié à la main sans rechargement. Lancez whitelist reload dans la console. Jusque-là, le serveur garde en mémoire l’ancienne liste.
C’est un autre refus. Un compte banni reçoit un message disant qu’il est banni du serveur, avec la raison ; une adresse bannie reçoit un message disant que l’adresse IP est bannie (le wiki communautaire liste ces messages, source secondaire ; les joueurs les voient dans leur langue). Si le message parle de bannissement, consultez banlist.

Ce n’est pas une cause : sur Java Edition, les opérateurs passent outre la liste blanche (wiki communautaire, source secondaire). Non couvert : les joueurs qui entrent par un relais ou un pont Bedrock, deux cas que nous n’avons pas vérifiés dans une source primaire. Bedrock Edition a sa propre commande, /allowlist (Microsoft Learn).

Opérateurs (op)

Un opérateur est un joueur autorisé à lancer des commandes serveur. /op ajoute le joueur à ops.json et /deop le retire. Le niveau qu’il reçoit est la clé op-permission-level de server.properties, 4 par défaut (la valeur par défaut est MESURÉE ; le lien entre /op et cette clé vient du wiki communautaire, source secondaire).

Commande	Ce qu’elle fait	Droits
op <targets>	Nomme un joueur opérateur.	Niveau 3 (admins)
deop <targets>	Retire le statut d’opérateur.	Niveau 3 (admins)

Niveaux de permission

La liste de commandes 26.3 nomme trois niveaux : gamemasters, admins et owners (MESURÉ). Le fait qu’il s’agit des niveaux 2, 3 et 4, et qu’un niveau inclut tout ce que permettent les niveaux inférieurs, vient du wiki communautaire (source secondaire). Le tableau montre ce qu’exigent les commandes extraites ; il couvre 23 commandes, pas toutes celles du jeu.

Niveau	Nom	Commandes qui l’exigent
0	(aucune exigence)	list. Pas besoin d’être opérateur.
1	(non nommé dans la liste)	Aucune des commandes mesurées. Le wiki communautaire (source secondaire) dit qu’il permet de construire dans la zone de protection du point d’apparition.
2	gamemasters	gamemode, gamerule, defaultgamemode, difficulty, time, weather, seed.
3	admins	whitelist, op, deop, ban, ban-ip, pardon, pardon-ip, banlist, kick, setidletimeout.
4	owners	stop, save-all, save-off, save-on, publish.

ops.json et op-permission-level

ops.json contient une entrée par opérateur, avec le pseudo et l’UUID, un nombre « level » et un indicateur « bypassesPlayerLimit » (wiki communautaire, source secondaire). Pour changer un niveau, modifiez le nombre. Parmi les commandes extraites, aucune ne recharge ops.json : arrêtez le serveur avant de le modifier et relancez-le ensuite (DÉDUIT).

Avec le niveau 4 par défaut, tout opérateur peut arrêter le serveur et utiliser les commandes de sauvegarde (MESURÉ : elles exigent owners). Pour vous le réserver, mettez op-permission-level=3 et donnez le niveau 4 à la main dans ops.json. Un opérateur de niveau 3 peut lancer /op (MESURÉ : op exige admins) et le wiki dit que les nouveaux opérateurs reçoivent le niveau de op-permission-level (source secondaire) : baisser cette valeur par défaut empêche donc aussi un opérateur de niveau 3 de créer des opérateurs de niveau 4 (DÉDUIT).

Console ou en jeu

La console du serveur exécute n’importe quelle commande, sans slash et sans statut d’opérateur (DÉDUIT, comportement habituel ; non testé). En jeu, les commandes du chat commencent par un slash et demandent un opérateur du bon niveau.

Le premier opérateur d’un nouveau serveur se crée en général depuis la console (ou la console de votre panneau d’hébergement) : op VotrePseudo. Modifier ops.json serveur arrêté fonctionne aussi (wiki communautaire, source secondaire). Ensuite, les opérateurs peuvent utiliser les commandes en jeu.

Sécurité

Ne nommez opérateurs que des gens à qui vous confieriez vos clés. Un opérateur peut bannir des joueurs, changer qui peut entrer et, au niveau 4, arrêter le serveur. Donnez le niveau le plus bas qui fait l’affaire et utilisez deop quand quelqu’un n’en a plus besoin. Un opérateur de niveau 3 peut aussi lancer deop (MESURÉ : deop exige admins) et donc retirer d’autres opérateurs ; nous n’avons pas vérifié si cela inclut les opérateurs de niveau 4.

Cette page parle des opérateurs. Pour les commandes qui donnent des objets, voyez notre générateur de commandes Minecraft.

Bannissements, bannissements d’adresse et expulsions

ban bloque un compte, ban-ip bloque une adresse, kick ne fait que déconnecter. Toutes demandent le niveau 3 (MESURÉ). Ce sont les commandes de Java Edition.

Commande	Ce qu’elle fait	Droits
ban <targets> [<reason>]	Bannit un compte joueur. La raison est facultative et s’affiche au joueur banni.	Niveau 3 (admins)
pardon <targets>	Lève le bannissement d’un compte joueur.	Niveau 3 (admins)
ban-ip <target> [<reason>]	Bannit une adresse IPv4, ou l’adresse d’un joueur en ligne si vous donnez un pseudo.	Niveau 3 (admins)
pardon-ip <target>	Lève le bannissement d’une adresse IPv4.	Niveau 3 (admins)
banlist [players\|ips]	Liste les bannissements. Ajoutez players ou ips pour n’en afficher qu’un type.	Niveau 3 (admins)
kick <targets> [<reason>]	Déconnecte un joueur tout de suite. Ce n’est pas un bannissement : il peut revenir.	Niveau 3 (admins)
list uuids	Affiche chaque joueur en ligne avec son UUID.	Tout le monde

ban ou ban-ip ?

ban enregistre le compte du joueur : le wiki indique qu’il bloque l’UUID du profil (source secondaire). Le joueur ne peut plus entrer avec ce compte, mais il le peut avec un autre.

ban-ip enregistre une adresse. Ce bannissement bloque tous ceux qui se connectent depuis cette adresse : un frère sur le même routeur, une école, un relais partagé. C’est un outil peu précis, et les adresses changent. Le wiki dit que la commande accepte aussi le pseudo d’un joueur en ligne, et bannit alors son adresse (source secondaire) ; le joueur doit être en ligne. Si vos joueurs passent par un tunnel ou un relais, cette adresse peut être celle du relais, et la bannir peut enfermer tout le monde dehors.

Seules les adresses IPv4 peuvent être saisies. La liste de commandes donne l’argument d’adresse comme un mot Brigadier unique, qui s’arrête au premier deux-points : une adresse IPv6 est rejetée avec le « Expected whitespace to end one argument » de Brigadier (MESURÉ : essai de la bibliothèque libre Brigadier 1.3.11 ; le wiki communautaire note la même limite comme bogue MC-97885, source secondaire). Pour un joueur en IPv6, la forme avec pseudo de ban-ip est à essayer ; nous ne l’avons pas testée.

La raison et le stockage des bannissements

La raison est tout ce qui suit le pseudo, espaces compris, et le joueur banni la voit (source secondaire). Évitez @ et § dans une raison : le jeu peut lire @ comme un sélecteur, et § fait déconnecter le joueur qui le tape dans le chat (wiki communautaire, source secondaire). Une commande tapée en jeu est limitée à 256 caractères (même source) ; pour une commande plus longue, utilisez la console.

Les bannissements sont stockés dans banned-players.json et banned-ips.json, dans le dossier du serveur (wiki communautaire, source secondaire), et survivent donc à un redémarrage (DÉDUIT, parce que ce sont des fichiers). Ne les modifiez à la main que serveur arrêté (DÉDUIT).

pardon et pardon-ip lèvent un bannissement. banlist les liste, et banlist players ou banlist ips n’en montre qu’un type.

Dépannage

Ce que vous voyez	Cause probable	Que faire
Le jeu indique que la commande est inconnue ou incomplète	Une faute de frappe, un argument manquant, ou vous n’êtes pas opérateur de niveau 3 ou plus.	Lisez la partie rouge du message. Essayez la même commande dans la console du serveur. Vérifiez votre niveau dans ops.json.
Le jeu indique que le joueur n’existe pas	Le pseudo ne correspond à aucun compte Java : faute de frappe, ou gamertag Bedrock (source secondaire : en mode en ligne, le pseudo doit être celui d’un vrai compte).	Vérifiez l’orthographe exacte du pseudo Java et réessayez.
Le jeu indique que le sélecteur inclut des entités	Vous avez utilisé @e ou @n là où il faut un joueur.	Saisissez le pseudo du joueur.
Le jeu indique que l’adresse IP est invalide ou le joueur inconnu	ban-ip a reçu une adresse IPv4 mal écrite ou un pseudo qui n’est pas en ligne.	Quatre nombres de 0 à 255, sans zéro initial, ou le pseudo d’un joueur en ligne maintenant.
« Expected whitespace to end one argument, but found trailing data » (message de Brigadier, en anglais)	Une adresse IPv6, ou du texte en trop, dans un argument qui prend un seul mot.	L’IPv6 ne peut pas être saisie ici. Pour ban-ip, essayez le pseudo du joueur en ligne (non testé). Si vous avez collé une adresse avec :port, retirez le port.
Le jeu indique que rien n’a changé parce que le joueur est déjà opérateur, banni ou sur la liste blanche	La commande a déjà fait ce que vous demandez.	Rien. Vérifiez avec banlist, whitelist list ou ops.json.
Un message disant que vous n’êtes pas sur la liste blanche	La liste blanche est activée et le compte n’y figure pas.	Voir « Pourquoi ne suis-je pas sur la liste blanche ? » plus haut.
Les modifications de whitelist.json n’ont aucun effet	Le serveur garde l’ancienne liste en mémoire.	Lancez whitelist reload.

Questions fréquentes

Comment ajouter quelqu’un à la liste blanche de mon serveur Minecraft ?

Dans la console du serveur, tapez whitelist add PSEUDO, ou en jeu /whitelist add PSEUDO si vous êtes opérateur de niveau 3 ou plus. Il peut être hors ligne au moment de la commande. Vérifiez avec whitelist list.

Pourquoi ne suis-je pas sur la liste blanche du serveur ?

Sur Java Edition 26.3 (la version vérifiée), un nouveau serveur démarre avec la liste blanche activée : tous ceux qui ne sont ni opérateurs ni dans la liste sont refusés avec un message disant qu’ils ne sont pas sur la liste blanche. Demandez au propriétaire de lancer whitelist add avec votre pseudo exact. Autres causes : un mauvais pseudo, une modification de whitelist.json non rechargée, le mode hors ligne.

Comment désactiver la liste blanche ?

Tapez whitelist off dans la console, ou mettez white-list=false dans server.properties et redémarrez. Désactivée, elle laisse entrer toute personne qui a l’adresse du serveur.

Comment nommer quelqu’un opérateur ?

Tapez op PSEUDO dans la console, ou /op PSEUDO en jeu si vous êtes déjà opérateur. Il reçoit le niveau de op-permission-level, 4 par défaut. Pour retirer le statut, tapez deop PSEUDO.

Comment bannir un joueur, ou bannir une adresse IP ?

ban PSEUDO [raison] bannit le compte et ban-ip ADRESSE [raison] bannit une adresse IPv4, ou celle d’un joueur en ligne si vous donnez un pseudo. On les annule avec pardon PSEUDO et pardon-ip ADRESSE.

Ces commandes fonctionnent-elles sur Bedrock Edition ?

Pas telles qu’écrites ici. Cette page traite de Java Edition. Bedrock utilise /allowlist au lieu de /whitelist, et nous n’avons pas vérifié le reste.

Comment nous avons vérifié

La syntaxe, les types d’arguments, les noms des niveaux de permission et les valeurs par défaut viennent des données que génère le serveur officiel Minecraft Java Edition 26.3 (MESURÉ, 4 octobre 2026) : sa liste de commandes et son server.properties. Nous avons aussi fait un essai de la bibliothèque libre Brigadier. Les autres faits viennent du wiki communautaire, signalé ici comme source secondaire et lu seulement pour vérifier ; nous n’avons copié aucun texte du wiki. Étiquettes utilisées : MESURÉ, VÉRIFIÉ À LA SOURCE PRIMAIRE, DÉDUIT et NON TESTÉ.

Minecraft Wiki, /whitelist (source secondaire) (consulté le 4 octobre 2026)
Minecraft Wiki, niveau de permission (source secondaire) (consulté le 4 octobre 2026)
Minecraft Wiki, pseudos des joueurs (source secondaire) (consulté le 4 octobre 2026)
Minecraft Wiki, serveur : liste blanche, opérateurs, messages de déconnexion (source secondaire) (consulté le 4 octobre 2026)
Minecraft Wiki, /ban et /ban-ip (source secondaire) (consulté le 4 octobre 2026)
Microsoft Learn, /allowlist pour Bedrock (source primaire, Bedrock uniquement) (consulté le 4 octobre 2026)

Outil non officiel, sans lien avec Mojang ni Microsoft et non approuvé par eux. Minecraft est une marque de Mojang.