Aller au contenu

Wiki

Révision #818

Enregistrée le 15 août 2026 à 7:11

Auteur: vyrriox Type: Création « Creation de la page Mettre a jour son serveur: contenu reel de l archive verifie, regle de suppression plutot que fusion appuyee sur le diff 2.0.20 vers 2.0.27 (14 retires, 18 ajoutes), fichiers a conserver, piege du fichier de RAM livre avec le pack, changement de version NeoForge, tableau de de... »
Cette révision #818

Mettre à jour son serveur

Le pack sort de nouvelles versions régulièrement. Mettre son serveur à jour n'est pas compliqué, mais une seule erreur suffit à empêcher le démarrage ou à faire disparaître des réglages. Cette page explique quoi remplacer, quoi garder, et pourquoi la méthode qui paraît la plus prudente est justement la plus dangereuse.

Ce que l'archive contient, et ce qu'elle ne contient pas

Bonne nouvelle avant tout: l'archive du serveur ne contient aucune donnée de jeu. Ni monde, ni joueurs, ni réglages de serveur. Tout cela est créé au premier lancement et n'est jamais écrasé par une mise à jour.

Dans l'archiveCréé par le serveur, jamais dans l'archive
mods, config, kubejsworld et les autres dimensions
libraries, l'installeur NeoForgeserver.properties
unix_args.txt, les scripts de lancementops.json, whitelist.json, les bannis
user_jvm_args.txt, emoteseula.txt, usercache.json, les journaux

La règle d'or: remplacer, jamais fusionner

Ne copie jamais les nouveaux mods par dessus les anciens
Le réflexe naturel est de glisser le contenu de la nouvelle archive dans le dossier existant en acceptant de remplacer. C'est exactement ce qu'il ne faut pas faire. Entre deux versions, des mods sont retirés et beaucoup changent de numéro de version, donc de nom de fichier. Une fusion laisse les anciens fichiers en place et tu te retrouves avec le même mod chargé deux fois, ce qui empêche le serveur de démarrer.

Pour donner une idée de l'ampleur, entre deux versions séparées de quelques semaines, 14 fichiers de mods ont disparu et 18 sont apparus. Plusieurs correspondaient au même mod à une version différente: une bibliothèque partagée passée de v2.13.38 à v2.13.41, une autre de v21.1.39 à v21.1.52. Fusionner aurait chargé les deux à chaque fois.

La bonne méthode est donc de supprimer entièrement les dossiers concernés avant de déposer les nouveaux.

Ce qu'on supprime et remplace

Dossier ou fichierPourquoi
modsLe cœur du problème, à vider complètement
librariesContient NeoForge, doit correspondre à la version du pack
kubejsToutes les recettes du serveur, à reprendre en bloc
L'installeur NeoForge et unix_args.txtIls vont de pair avec libraries
emotesSans conséquence, mais autant rester à jour

Ce qu'on garde absolument

  • Le dossier du monde et toutes les dimensions. C'est ta partie, rien dans l'archive ne le touche.
  • server.properties, sinon tu perds le nom du serveur, le port, la difficulté et la distance d'affichage.
  • ops.json, whitelist.json et les listes de bannis, sinon tu perds tes droits d'administrateur et ta modération.
  • eula.txt, déjà accepté.
Le fichier de mémoire est dans l'archive
user_jvm_args.txt contient l'allocation de RAM, et il est livré avec le pack. Si tu le remplaces sans y penser, ton serveur repart sur la valeur par défaut, qui n'est probablement pas celle de ta machine. Note ta valeur avant, ou mets ce fichier de côté. Les repères sont sur Arguments JVM et RAM.

Le cas du dossier config

config est le seul dossier où il faut réfléchir. Il contient à la fois les réglages livrés avec le pack et ceux que tu as pu ajuster toi même.

  • Si tu n'as rien modifié, remplace le dossier entier, c'est le plus sûr.
  • Si tu as modifié des fichiers, note lesquels avant de remplacer, puis réapplique tes changements après. Garder l'ancien dossier entier fait rater les nouveaux réglages des mods ajoutés.

Attention au changement de NeoForge

La version de NeoForge ne change pas à chaque mise à jour du pack, mais elle change parfois. Sur une période récente, elle est passée de 21.1.221 à 21.1.232 entre deux versions du pack.

Quand c'est le cas, libraries, l'installeur et unix_args.txt doivent être remplacés ensemble. Un mélange entre l'ancien et le nouveau donne une erreur au démarrage, avant même le chargement des mods.

La procédure complète

  1. 1
    Arrête le serveur proprement et attends qu'il ait fini de sauvegarder.
  2. 2
    Fais une sauvegarde complète du dossier, monde compris. C'est la seule étape non négociable.
  3. 3
    Note ton allocation de RAM et la liste des fichiers de config que tu as modifiés.
  4. 4
    Supprime mods, libraries, kubejs, l'installeur NeoForge et unix_args.txt.
  5. 5
    Décompresse la nouvelle archive dans le dossier du serveur.
  6. 6
    Réapplique ta RAM et tes réglages, puis relance et surveille le démarrage.
Le premier démarrage après une mise à jour est plus long que d'habitude: les mods reconstruisent leurs caches et les nouvelles recettes se chargent. Laisse le finir avant de conclure qu'il est bloqué.

Si le serveur ne démarre plus

SymptômeCause la plus probable
Erreur citant deux fois le même modFusion au lieu de suppression, un ancien fichier est resté
Erreur avant le chargement des modslibraries et l'installeur ne correspondent pas
Le serveur démarre mais tourne malAllocation de mémoire revenue à la valeur par défaut
Des objets ont disparu de l'inventaire des joueursUn mod retiré dans la nouvelle version, c'est normal
Le monde refuse de chargerRestaure la sauvegarde, puis va voir Réparer un monde corrompu

Dans tous les cas, le journal de démarrage nomme le mod fautif. La lecture des journaux et les autres pannes courantes sont traitées sur Dépanner son serveur.

Où continuer

Pour l'installation initiale, va voir Installer son serveur, et pour l'entretien courant Maintenir son serveur. Les réglages de démarrage sont détaillés sur Arguments JVM et RAM, et les recettes que tu retrouveras dans kubejs sont expliquées sur Comprendre KubeJS.

Version actuelle

Mettre à jour son serveur

Le pack sort de nouvelles versions régulièrement. Mettre son serveur à jour n'est pas compliqué, mais une seule erreur suffit à empêcher le démarrage ou à faire disparaître des réglages. Cette page explique quoi remplacer, quoi garder, et pourquoi la méthode qui paraît la plus prudente est justement la plus dangereuse.

Ce que l'archive contient, et ce qu'elle ne contient pas

Bonne nouvelle avant tout: l'archive du serveur ne contient aucune donnée de jeu. Ni monde, ni joueurs, ni réglages de serveur. Tout cela est créé au premier lancement et n'est jamais écrasé par une mise à jour.

Dans l'archiveCréé par le serveur, jamais dans l'archive
mods, config, kubejsworld et les autres dimensions
libraries, l'installeur NeoForgeserver.properties
unix_args.txt, les scripts de lancementops.json, whitelist.json, les bannis
user_jvm_args.txt, emoteseula.txt, usercache.json, les journaux

La règle d'or: remplacer, jamais fusionner

Ne copie jamais les nouveaux mods par dessus les anciens
Le réflexe naturel est de glisser le contenu de la nouvelle archive dans le dossier existant en acceptant de remplacer. C'est exactement ce qu'il ne faut pas faire. Entre deux versions, des mods sont retirés et beaucoup changent de numéro de version, donc de nom de fichier. Une fusion laisse les anciens fichiers en place et tu te retrouves avec le même mod chargé deux fois, ce qui empêche le serveur de démarrer.

Pour donner une idée de l'ampleur, entre deux versions séparées de quelques semaines, 14 fichiers de mods ont disparu et 18 sont apparus. Plusieurs correspondaient au même mod à une version différente: une bibliothèque partagée passée de v2.13.38 à v2.13.41, une autre de v21.1.39 à v21.1.52. Fusionner aurait chargé les deux à chaque fois.

La bonne méthode est donc de supprimer entièrement les dossiers concernés avant de déposer les nouveaux.

Ce qu'on supprime et remplace

Dossier ou fichierPourquoi
modsLe cœur du problème, à vider complètement
librariesContient NeoForge, doit correspondre à la version du pack
kubejsToutes les recettes du serveur, à reprendre en bloc
L'installeur NeoForge et unix_args.txtIls vont de pair avec libraries
emotesSans conséquence, mais autant rester à jour

Ce qu'on garde absolument

  • Le dossier du monde et toutes les dimensions. C'est ta partie, rien dans l'archive ne le touche.
  • server.properties, sinon tu perds le nom du serveur, le port, la difficulté et la distance d'affichage.
  • ops.json, whitelist.json et les listes de bannis, sinon tu perds tes droits d'administrateur et ta modération.
  • eula.txt, déjà accepté.
Le fichier de mémoire est dans l'archive
user_jvm_args.txt contient l'allocation de RAM, et il est livré avec le pack. Si tu le remplaces sans y penser, ton serveur repart sur la valeur par défaut, qui n'est probablement pas celle de ta machine. Note ta valeur avant, ou mets ce fichier de côté. Les repères sont sur Arguments JVM et RAM.

Le cas du dossier config

config est le seul dossier où il faut réfléchir. Il contient à la fois les réglages livrés avec le pack et ceux que tu as pu ajuster toi même.

  • Si tu n'as rien modifié, remplace le dossier entier, c'est le plus sûr.
  • Si tu as modifié des fichiers, note lesquels avant de remplacer, puis réapplique tes changements après. Garder l'ancien dossier entier fait rater les nouveaux réglages des mods ajoutés.

Attention au changement de NeoForge

La version de NeoForge ne change pas à chaque mise à jour du pack, mais elle change parfois. Sur une période récente, elle est passée de 21.1.221 à 21.1.232 entre deux versions du pack.

Quand c'est le cas, libraries, l'installeur et unix_args.txt doivent être remplacés ensemble. Un mélange entre l'ancien et le nouveau donne une erreur au démarrage, avant même le chargement des mods.

La procédure complète

  1. 1
    Arrête le serveur proprement et attends qu'il ait fini de sauvegarder.
  2. 2
    Fais une sauvegarde complète du dossier, monde compris. C'est la seule étape non négociable.
  3. 3
    Note ton allocation de RAM et la liste des fichiers de config que tu as modifiés.
  4. 4
    Supprime mods, libraries, kubejs, l'installeur NeoForge et unix_args.txt.
  5. 5
    Décompresse la nouvelle archive dans le dossier du serveur.
  6. 6
    Réapplique ta RAM et tes réglages, puis relance et surveille le démarrage.
Le premier démarrage après une mise à jour est plus long que d'habitude: les mods reconstruisent leurs caches et les nouvelles recettes se chargent. Laisse le finir avant de conclure qu'il est bloqué.

Si le serveur ne démarre plus

SymptômeCause la plus probable
Erreur citant deux fois le même modFusion au lieu de suppression, un ancien fichier est resté
Erreur avant le chargement des modslibraries et l'installeur ne correspondent pas
Le serveur démarre mais tourne malAllocation de mémoire revenue à la valeur par défaut
Des objets ont disparu de l'inventaire des joueursUn mod retiré dans la nouvelle version, c'est normal
Le monde refuse de chargerRestaure la sauvegarde, puis va voir Réparer un monde corrompu

Dans tous les cas, le journal de démarrage nomme le mod fautif. La lecture des journaux et les autres pannes courantes sont traitées sur Dépanner son serveur.

Où continuer

Pour l'installation initiale, va voir Installer son serveur, et pour l'entretien courant Maintenir son serveur. Les réglages de démarrage sont détaillés sur Arguments JVM et RAM, et les recettes que tu retrouveras dans kubejs sont expliquées sur Comprendre KubeJS.

Retour