Ton serveur Minecraft plante au démarrage avec « Exception in server tick loop » ? Dans 90% des cas, un fichier JSON corrompu est en cause. Besoin de stabilité ? Découvre notre hébergement Minecraft optimisé.
Prérequis
- Accès au panel Oxygenserv (ton login et mot de passe)
- Accès FTP/SFTP (ex: FileZilla) pour sauvegarder/éditer des fichiers
- Nom exact de ton serveur et droits d’administration
- 5 à 10 minutes de downtime prévu
- Un éditeur de texte propre (Notepad++, VS Code), pas Word
Étapes détaillées
-
Arrête proprement le serveur
Connecte-toi au panel Oxygenserv et ouvre l’onglet « Console ». Clique sur le bouton rouge « Arrêter » et attends le message « Server stopped » dans les logs. Si le serveur reste bloqué plus de 60 secondes, utilise « Forcer l’arrêt » une seule fois. Ne passe pas à la suite tant que tu ne vois pas que le processus est bien stoppé. -
Sauvegarde les JSON sensibles
Va dans l’onglet « Fichiers » et repèreops.json,usercache.jsonetwhitelist.json(ouallowlist.jsonsur les versions récentes). Télécharge ces fichiers sur ton PC pour garder une copie de secours. Astuce: crée un dossier local « backup-json » avec la date du jour. Cette sauvegarde te permettra de récupérer des pseudos si besoin. -
Supprime les fichiers JSON corrompus
Dans « Fichiers », cocheops.json,usercache.jsonetwhitelist.json/allowlist.json, puis clique sur « Supprimer ». Confirme l’action quand le panel te le demande. Ne supprime rien d’autre. Si tu reçois une erreur de permission, reconnecte-toi en FTP/SFTP et supprime-les depuis ton client (clic droit > Supprimer). -
Redémarre pour regénérer automatiquement
Retourne dans « Console » et clique sur le bouton vert « Démarrer ». Tu verras les fichiersops.json,usercache.jsonetallowlist.json/whitelist.jsonse recréer tout seuls pendant le boot. Attends la ligne « Done » avec le temps de démarrage. Si le crash persiste, passe à l’étape suivante pour un diagnostic rapide. -
Restaure tes droits OP et ta allowlist
Ajoute-toi OP depuis la console (sans slash) avecop TonPseudo. Active et remplis l’allowlist selon ta version: a) 1.19+ :allowlist onpuisallowlist add TonPseudo. b) Versions anciennes :whitelist onpuiswhitelist add TonPseudo. En jeu, les mêmes commandes s’écrivent avec un slash:/op TonPseudo,/allowlist add TonPseudoou/whitelist add TonPseudo. -
Si ça crash encore, traque l’erreur JSON exacte
Ouvrelogs/latest.loget cherche des mentions de.jsonavec des mots-clés comme « Expected », « malformed », « syntax ». Un JSON valide ne doit pas contenir de virgule finale, ni de guillemets manquants. Exemple minimal valide d’un fichier vide:[]. Si un plugin/mod utilise unconfig.json, vérifie-le aussi, surtout après une coupure brutale.
Astuces & optimisation
– Évite d’éditer les JSON à la main. Passe par les commandes (ex: op, allowlist add) pour garantir un format correct.
– Si tu dois éditer un JSON, utilise un validateur en ligne et enregistre en UTF-8 sans BOM. Un simple [] remet un fichier à zéro proprement.
– Programme des sauvegardes automatiques quotidiennes et avant chaque mise à jour. Garde au moins 3 versions en rotation.
– Sur 1.19+, préfère l’allowlist: mets allowlist on et gère les joueurs avec allowlist add/remove. C’est plus sûr contre les griefs.
– Un arrêt brutal corrompt souvent les JSON. Toujours arrêter via le panel et attendre « Server stopped » avant d’agir.
FAQ
Supprimer ces fichiers va-t-il effacer mes mondes ou inventaires ?
Non. ops.json, usercache.json et whitelist.json/allowlist.json ne contiennent pas les données des mondes. Ils stockent les opérateurs, le cache joueurs et la liste des joueurs autorisés. Tes mondes (world, world_nether, etc.) et inventaires restent intacts.
Je ne vois pas whitelist.json mais allowlist.json, normal ?
Oui. Depuis les versions récentes, Mojang a renommé whitelist.json en allowlist.json et les commandes associées en allowlist. Utilise allowlist on, allowlist add Pseudo et allowlist remove Pseudo.
La console refuse les commandes avec un slash, pourquoi ?
Dans la console du panel, tape les commandes sans slash: op Pseudo, allowlist add Pseudo ou whitelist add Pseudo. Les versions avec slash (/op, /allowlist) sont réservées au chat en jeu.
Respire, tu y es presque. Suis les étapes, redémarre proprement et ton serveur repartira sans ce crash JSON. Besoin d’un coup de main ? On est là.