ops.json, banned-players.json et autres listes

Fichiers JSON de service du serveur : opérateurs, bans, whitelist et cache de pseudos — ce qu'ils contiennent et quand les modifier à la main.

Mis à jour le 13 août 2026

Le serveur stocke les listes de joueurs dans des fichiers JSON à la racine. Elles se gèrent généralement par commandes, mais il est parfois plus rapide d'ouvrir le fichier.

Fichier	Contenu
`ops.json`	Opérateurs, niveau d'accès, `bypassesPlayerLimit`
`whitelist.json`	Liste blanche
`banned-players.json`	Bannissements par pseudo et UUID
`banned-ips.json`	Bannissements par IP
`usercache.json`	Cache de la correspondance pseudo → UUID

Exemple ops.json

[
  {
    "uuid": "8a1b...",
    "name": "Steve",
    "level": 4,
    "bypassesPlayerLimit": true
  }
]

Règles d'édition

Uniquement serveur arrêté. Un serveur en cours d'exécution garde les listes en mémoire et écrasera le fichier à l'arrêt — vos modifications seront perdues.
Le format est strict : une virgule en trop casse tout le fichier, et le serveur démarre avec une liste d'opérateurs vide.
L'UUID doit correspondre au pseudo. Sur un serveur premium, l'UUID est permanent ; sur un serveur avec connexion par pseudo, il est calculé à partir du pseudo — lorsque vous changez online-mode, toutes les listes cessent de correspondre.

Changer online-mode

C'est la cause la plus fréquente du « tous les opérateurs et les claims ont disparu » : les UUID des joueurs changent et les anciennes entrées ne renvoient plus à personne. Pour plus de détails, consultez Connexion par pseudo.

Plugins

Les plugins de permissions et de bannissement stockent leurs données séparément (fichiers ou MySQL) et ignorent les listes vanilla — LuckPerms, Bannissements et mutes.

Hébergement MinecraftVotre serveur tourne même hors ligneCréer le serveur