---
title: "Comment se mettre op et activer la whitelist sur son serveur Minecraft ?"
description: "Mettez-vous op depuis la Console du panel Winheberg, réglez le niveau des opérateurs et activez la whitelist de votre serveur Minecraft Java, mode crack compris."
category: jeux
subcategory: minecraft-java
icon: tabler:file-text
date: 2026-11-01
author: Winheberg
slug: "op-whitelist-serveur-minecraft"
order: 106
image: /statics/images/docs/fr/gaming/minecraft-java/op-whitelist-serveur-minecraft.webp
tags: [minecraft, op, whitelist, administration, panel gaming]
keywords: [op minecraft, whitelist minecraft, commande op, op-permission-level, enforce-whitelist, ops.json, whitelist.json, serveur minecraft java]
link_en: "/en/docs/minecraft-java/op-whitelist-minecraft-server"
---

## Contexte

Sur un serveur Minecraft Java, le statut d'opérateur (op) donne accès aux commandes d'administration, comme changer de mode de jeu, expulser un joueur ou arrêter le serveur. La whitelist, elle, réserve l'accès du serveur à une liste de joueurs autorisés, pratique pour un serveur entre amis ou une phase de test avant ouverture.

Ce guide vous montre comment vous mettre op depuis la Console du panel gaming Winheberg, régler le niveau des opérateurs, puis activer et gérer la whitelist. Il couvre aussi les fichiers `ops.json` et `whitelist.json`, ainsi que le cas particulier des serveurs en mode crack.

Lorsqu'un joueur absent de la whitelist tente de se connecter, il reçoit ce message.

```text
You are not white-listed on this server!
```

## Prérequis

- Un [serveur Minecraft Java](https://winheberg.com/gaming/minecraft) actif chez Winheberg
- Un accès au panel gaming `https://panel.winheberg.com/`
- Le pseudo exact des joueurs concernés, en respectant les majuscules et minuscules

> [!NOTE]
> Les commandes de ce guide sont celles du Minecraft vanilla. Elles fonctionnent de la même façon sur Spigot, Paper ou Purpur, mais un plugin de permissions peut ajouter ses propres règles par-dessus le statut d'op.

## 1. Se mettre op depuis la Console

Connectez-vous au panel gaming, sélectionnez votre serveur puis ouvrez l'onglet **Console**. Le serveur doit être démarré.

Dans le champ de saisie en bas de la Console, tapez la commande suivante en remplaçant `Steve` par votre pseudo, puis validez avec <kbd>Entrée</kbd>.

```bash
op Steve
```

> [!IMPORTANT]
> Dans la Console du panel, les commandes s'écrivent sans le `/` devant. En jeu, dans le chat, la même commande s'écrit `/op Steve`.

Si tout s'est bien passé, la Console affiche la confirmation suivante.

```text
System chat: Made Steve a server operator
```

> [!NOTE]
> Sur un serveur Paper, la Console préfixe les réponses des commandes par `System chat:`.

Le joueur n'a pas besoin d'être connecté au moment de la commande. Une fois op, vous pouvez utiliser les commandes d'administration directement en jeu, avec le `/`.

## 2. Retirer le statut d'op

Pour retirer les droits d'opérateur à un joueur, utilisez la commande `deop` depuis la Console.

```bash
deop Steve
```

La Console confirme le retrait.

```text
System chat: Made Steve no longer a server operator
```

## 3. Régler le niveau des opérateurs

Chaque op dispose d'un niveau de permission, de 1 à 4. Plus le niveau est élevé, plus le joueur a accès à des commandes sensibles.

| Niveau | Nom | Accès principal | Exemples de commandes |
|---|---|---|---|
| 1 | Moderator | Contourner la protection du spawn | Aucune en particulier |
| 2 | Gamemaster | Commandes de jeu et blocs de commande | `gamemode`, `tp`, `give`, `time`, `weather`, `difficulty` |
| 3 | Admin | Gestion des joueurs | `kick`, `ban`, `op`, `deop`, `whitelist` |
| 4 | Owner | Toutes les commandes, gestion du serveur | `stop`, `save-all` |

Le niveau attribué par la commande `op` est défini par la propriété `op-permission-level` du fichier `server.properties`. Sa valeur par défaut est `4`, soit le niveau maximal.

Pour la modifier, arrêtez le serveur, ouvrez l'onglet **Files**, puis cliquez sur `server.properties`. Repérez la ligne correspondante et indiquez le niveau souhaité.

```properties
op-permission-level=4
```

<img src="/statics/images/docs/fr/gaming/minecraft-java/op-whitelist-serveur-minecraft-1793566229552-636a86cf6108028d7d93b6c0.webp" alt="Ligne op-permission-level=4 encadrée dans le fichier server.properties ouvert depuis l'onglet Files du panel gaming Winheberg" width="630" />

Enregistrez le fichier avec le bouton **Save Content** puis redémarrez le serveur.

> [!NOTE]
> `op-permission-level` ne s'applique qu'aux joueurs mis op après la modification. Les opérateurs déjà présents conservent le niveau inscrit dans `ops.json`. Pour changer leur niveau, faites un `deop` puis un nouvel `op`, ou modifiez le champ `level` du fichier comme expliqué plus bas.

## 4. Activer et gérer la whitelist

Toutes les commandes de whitelist se tapent dans l'onglet **Console**, sans `/`. Elles demandent le niveau d'op 3 lorsqu'elles sont utilisées en jeu.

Commencez par ajouter les joueurs autorisés, en particulier vous-même, puis activez la whitelist.

```bash
whitelist add Steve
whitelist add Alex
whitelist on
```

Le tableau ci-dessous récapitule les commandes disponibles et le message renvoyé par la Console, sans le préfixe `System chat:` ajouté par Paper.

| Commande | Effet | Message de confirmation |
|---|---|---|
| `whitelist on` | Active la whitelist | `Whitelist is now turned on` |
| `whitelist off` | Désactive la whitelist | `Whitelist is now turned off` |
| `whitelist add <pseudo>` | Ajoute un joueur | `Added <pseudo> to the whitelist` |
| `whitelist remove <pseudo>` | Retire un joueur | `Removed <pseudo> from the whitelist` |
| `whitelist list` | Affiche les joueurs autorisés | `There are X whitelisted player(s)` suivi des pseudos |
| `whitelist reload` | Relit le fichier `whitelist.json` | `Reloaded the whitelist` |

Voici le résultat dans la Console après `op Steve`, `whitelist add Steve` et `whitelist list`.

<img src="/statics/images/docs/fr/gaming/minecraft-java/op-whitelist-serveur-minecraft-1793566163303-eb22776ecb3407383ec91b69.webp" alt="Commandes op Steve, whitelist add Steve et whitelist list dans la Console du panel gaming Winheberg avec leurs messages System chat" width="605" />

Si la whitelist est déjà active, `whitelist on` ne change rien et la Console répond `System chat: Whitelist is already turned on`.

Comme pour `op`, les joueurs n'ont pas besoin d'être connectés pour être ajoutés ou retirés.

> [!TIP]
> Les opérateurs peuvent toujours rejoindre le serveur quand la whitelist est active, même s'ils n'y figurent pas.

L'état de la whitelist est enregistré dans `server.properties`, sur la ligne `white-list`. La commande `whitelist on` passe cette valeur à `true` pour vous.

```properties
white-list=true
```

<img src="/statics/images/docs/fr/gaming/minecraft-java/op-whitelist-serveur-minecraft-1793566229981-df0413982389c5c189fa0aa7.webp" alt="Ligne white-list=true encadrée dans le fichier server.properties d'un serveur Minecraft 26.3" width="630" />

> [!NOTE]
> Sur la version 26.3, le fichier `server.properties` généré à la création du serveur contient `white-list=true` par défaut. Un serveur créé de zéro sur cette version démarre donc avec la whitelist active, ajoutez-y vos joueurs avant de les inviter. Un serveur mis à jour conserve la valeur déjà présente dans son fichier. Les nouveautés de cette version sont détaillées dans notre article [« Minecraft Wilderness Bound (26.3), tout ce que change la mise à jour »](https://winheberg.com/blog/wilderness-bound-minecraft-26-3).

## 5. Expulser les joueurs retirés avec enforce-whitelist

Par défaut, retirer un joueur de la whitelist ne l'expulse pas s'il est déjà connecté. Il ne sera bloqué qu'à sa prochaine connexion.

Pour que les joueurs absents de la whitelist soient expulsés immédiatement, arrêtez le serveur, ouvrez `server.properties` dans **Files** et passez la ligne suivante à `true`.

```properties
enforce-whitelist=true
```

Après redémarrage, lorsque la whitelist est active et rechargée, par exemple avec `whitelist reload`, les joueurs connectés qui n'y figurent pas sont expulsés.

## 6. Comprendre ops.json et whitelist.json

Les commandes `op` et `whitelist` enregistrent leurs données dans deux fichiers situés à la racine du serveur, visibles dans l'onglet **Files**.

Le fichier `ops.json` contient la liste des opérateurs.

```json
[
  {
    "uuid": "00000000-0000-0000-0000-000000000000",
    "name": "Steve",
    "level": 4,
    "bypassesPlayerLimit": false
  }
]
```

| Champ | Rôle |
|---|---|
| `uuid` | Identifiant unique du joueur |
| `name` | Pseudo du joueur |
| `level` | Niveau d'op, de 1 à 4 |
| `bypassesPlayerLimit` | Avec `true`, le joueur peut se connecter même quand le serveur est plein |

Le fichier `whitelist.json` reprend le même principe avec uniquement les champs `uuid` et `name`.

```json
[
  {
    "uuid": "00000000-0000-0000-0000-000000000000",
    "name": "Alex"
  }
]
```

> [!WARNING]
> Préférez les commandes à l'édition manuelle. Elles récupèrent automatiquement le bon UUID du joueur, alors qu'une faute de frappe dans un fichier JSON peut empêcher sa lecture. Si vous modifiez `whitelist.json` à la main pendant que le serveur tourne, tapez `whitelist reload` pour appliquer les changements. Pour `ops.json`, arrêtez le serveur avant de l'éditer puis redémarrez-le.

## 7. Cas des serveurs en mode crack (online-mode=false)

Les deux fichiers identifient les joueurs par leur UUID, et non par leur seul pseudo. Or l'UUID d'un joueur n'est pas le même selon le mode du serveur. En mode officiel (`online-mode=true`), il est fourni par Mojang. En mode crack (`online-mode=false`), il est calculé localement à partir du pseudo.

Si vous passez un serveur existant en mode crack, les entrées déjà présentes dans `ops.json` et `whitelist.json` ne correspondent plus aux joueurs. Refaites alors un `op` et un `whitelist add` pour chaque joueur concerné, une fois le serveur relancé en mode crack, afin d'enregistrer leur nouvel UUID.

> [!CAUTION]
> En mode crack, n'importe qui peut se connecter avec le pseudo de son choix, y compris celui d'un opérateur. La whitelist seule ne protège donc pas vos accès administrateurs. Installez une authentification locale comme décrit dans notre guide [« Comment autoriser les cracks sur un serveur Minecraft ? »](https://winheberg.com/docs/minecraft-java/autoriser-crack-serveur-minecraft).

## En cas de problème

### ❌ « You are not white-listed on this server! » à la connexion

- Vérifiez avec `whitelist list` que le pseudo du joueur figure bien dans la liste
- Contrôlez l'orthographe exacte du pseudo, majuscules comprises
- Si le serveur est passé en mode crack après l'ajout, retirez puis ajoutez de nouveau le joueur pour enregistrer son nouvel UUID
- Si vous avez modifié `whitelist.json` à la main, tapez `whitelist reload` dans la Console

### ❌ « That player does not exist »

- Le pseudo saisi ne correspond à aucun compte Minecraft, vérifiez son orthographe
- En mode officiel, le joueur doit posséder un compte Minecraft Java valide pour être ajouté

### ❌ « Nothing changed. The player already is an operator »

- Le joueur est déjà op, aucune action n'est nécessaire
- Pour modifier son niveau, faites un `deop` puis un nouvel `op` après avoir changé `op-permission-level`, ou éditez le champ `level` dans `ops.json` serveur arrêté

### ❌ « Unknown or incomplete command. See below for error »

Ce message est suivi de la commande saisie, avec un repère `<--[HERE]` à l'endroit où le serveur ne la comprend plus.

- Vérifiez l'orthographe de la commande et de ses arguments, une faute de frappe suffit à déclencher ce message
- Dans la Console, tapez la commande sans le `/` devant
- En jeu, si vous êtes op, votre niveau peut être trop bas pour cette commande, consultez le tableau des niveaux plus haut et le champ `level` du fichier `ops.json`

### ❌ Un joueur retiré de la whitelist reste connecté

- C'est le comportement par défaut tant que `enforce-whitelist` vaut `false`
- Passez `enforce-whitelist=true` dans `server.properties`, redémarrez, puis tapez `whitelist reload`
- Vous pouvez aussi l'expulser directement avec `kick <pseudo>` depuis la Console

## Bonnes pratiques

- Ajoutez-vous à la whitelist ou mettez-vous op avant de taper `whitelist on`, pour ne pas vous bloquer l'accès
- Réservez le niveau 4 aux personnes de confiance, un niveau 2 suffit souvent pour un animateur ou un constructeur
- Retirez le statut d'op des joueurs qui n'en ont plus besoin avec `deop`
- Faites un `whitelist list` régulièrement pour vérifier qui a encore accès au serveur
- Sur un serveur en mode crack, ne comptez pas sur la whitelist seule et installez une authentification locale

## Besoin d'aide ?

Si une commande ne répond pas comme prévu ou si un joueur reste bloqué malgré la whitelist, notre équipe est là. Ouvrez un ticket dans le département **Technique** depuis votre espace client, renseignez le champ **Produit lié** avec le serveur concerné, et précisez la commande utilisée ainsi que le message affiché dans la Console.

Votre serveur Minecraft est maintenant administré et réservé aux joueurs que vous avez choisis 🎮

