Comment configurer une whitelist et bannir des joueurs sur votre serveur Minecraft

Une whitelist rend votre serveur privé : seuls les joueurs que vous listez peuvent se connecter. Un bannissement fait l’inverse et tient un joueur ou une adresse à l’écart. Les deux se gèrent depuis le panel, et ce guide couvre d’abord Java Edition et Bedrock à la fin. Bedrock a deux types de serveur, Bedrock et Pocketmine, et ils diffèrent.

Activer la whitelist (Java)

1. Ouvrez votre serveur dans le panel et cliquez sur Paramètres, puis Server Properties (Java).
2. Activez Whitelist. Si vous voulez que les joueurs en ligne qui ne sont pas listés soient expulsés, activez aussi Imposer la whitelist. Le jeu les expulse après que le serveur a rechargé la whitelist (whitelist reload), et la whitelist est aussi relue au démarrage du serveur.
3. Cliquez sur Enregistrer et redémarrer. Voir Les propriétés du serveur Minecraft expliquées.

Certaines versions récentes de Minecraft activent la whitelist par défaut : un nouveau serveur est donc peut-être déjà privé. Vérifiez l’interrupteur avant de demander à vos amis de se connecter, et ajoutez-vous d’abord, vous et eux.

Ajouter et retirer des joueurs

Avec le serveur En ligne, ouvrez l’onglet Console et tapez ces commandes. Ne tapez pas de slash.

Utilisez le pseudo exactement comme il apparaît dans le jeu. Avec le Mode en ligne activé, le serveur vérifie le pseudo auprès de Mojang : un pseudo mal tapé est donc refusé.

La liste est stockée dans whitelist.json dans le dossier principal du serveur, que vous pouvez ouvrir depuis Files. Pour la modifier à la main, arrêtez d’abord le serveur, ou exécutez whitelist reload ensuite. Les joueurs que vous ajoutez avec la commande sont enregistrés dans ce fichier tout de suite. Utilisez l’interrupteur Whitelist de la page de paramètres pour vérifier si elle est activée, car le panel l’y affiche et l’y enregistre.

Gardez le Mode en ligne activé. S’il est désactivé, la whitelist ne peut pas distinguer deux personnes qui tapent le même pseudo. Voir Comment rejoindre votre serveur Minecraft.

Expulser et bannir depuis la page Aperçu

Sur la page Aperçu d’un serveur Java, vous pouvez voir une carte Joueurs actifs avec les pseudos des joueurs en ligne, quand le serveur les publie. La carte est proposée sur la plupart des types Java : Vanilla, Paper, Purpur, Spigot, Folia, Fabric, Quilt, Forge, NeoForge, Magma, Ketting, Mohist et les serveurs de modpack. Les proxys, Sponge et les serveurs Custom Jar ne l’ont pas : utilisez la Console dans ce cas. Si vous avez accès à la console, chaque pseudo a un menu avec Copier le nom, Expulser et Bannir. Un joueur expulsé peut se reconnecter tout de suite. Un joueur banni ne peut pas se reconnecter tant que vous ne le débannissez pas dans la console. La carte envoie les mêmes commandes que ci-dessous, et un pseudo avec des caractères inhabituels n’est pas proposé : utilisez la Console pour ceux-là.

Bannir et débannir avec la Console

Les bannissements sont stockés dans banned-players.json et banned-ips.json dans le dossier principal du serveur. Un joueur banni voit qu’il est banni quand il essaie de se connecter.

Un bannissement d’adresse bloque aussi tous ceux qui partagent cette adresse, comme les personnes d’un même foyer : utilisez-le avec prudence.

Seuls les opérateurs peuvent les exécuter dans le jeu

Dans le jeu, ces commandes se tapent avec un slash et demandent le niveau d’opérateur 3 ou plus. La Console n’en demande aucun. Voir Comment vous donner le statut d’op et gérer les permissions.

Bedrock Edition

Ces étapes valent pour le type de serveur Bedrock, pas Pocketmine. Bedrock appelle la whitelist une allow list. Elle vérifie les joueurs par leur gamertag Xbox.

1. Ouvrez Paramètres, puis Server Properties (Bedrock), activez Whitelist et redémarrez.
2. Dans la Console, tapez allowlist add Gamertag. Si le gamertag contient une espace, mettez-le entre guillemets : allowlist add "Gamer Tag".
3. Utilisez allowlist remove Gamertag pour retirer quelqu’un et allowlist reload après avoir modifié allowlist.json à la main.

Le guide serveur de Microsoft décrit l’allow list comme le moyen de choisir qui peut se connecter et ne décrit pas de liste de bannissement : utilisez donc l’allow list pour tenir des gens à l’écart d’un serveur Bedrock.

Sur un serveur Pocketmine, l’interrupteur s’appelle Whitelist et se trouve sous Paramètres, puis Server Properties (PocketMine). Les commandes propres à PocketMine diffèrent de celles ci-dessus : tapez donc help dans la Console pour voir les commandes que connaît votre serveur, et voir Comment faire tourner un serveur Minecraft Bedrock.

Si une commande ne fait rien dans la Console, ouvrez un ticket. Voir Comment ouvrir un ticket de support.

À lire aussi

• Commandes Minecraft pour les propriétaires de serveur
• Comment inviter des amis et leur donner accès couvre l’accès au panel lui-même, pas au jeu.