Un monde Luanti, ce sont des semaines de construction. Ce chapitre t'apprend à le mettre à l'abri, à mettre à jour le moteur et ton jeu sans casse, et il raconte l'histoire vraie d'un serveur TeamKit qui a appris tout ça à ses dépens. Lis-la : elle t'évitera la même journée.
1. L'histoire d'un serveur qui plantait en boucle #
Un matin de novembre, un serveur TeamKit qui tournait sous Mineclonia s'est mis à planter. AMP le relançait, il replantait. 68 plantages dans la journée. La console répétait la même erreur :
Runtime error from mod '??' in callback luaentity_Step():
…/games/mineclonia/mods/ENTITIES/mobs_mc/blaze.lua:96:
attempt to index field 'attack' (a nil value)
Traduction : un monstre du jeu, le blaze, avait un bug dans la version de Mineclonia installée. Dès qu'il cherchait à attaquer, il faisait tomber tout le serveur.
Pour s'en sortir, le propriétaire a supprimé le dossier du jeu et l'a remplacé par une copie trouvée sur GitHub. Les plantages se sont arrêtés… mais cette copie était une version plus ancienne du jeu (0.113, alors que la version officielle en était à 0.124). Au redémarrage, la console a affiché :
NodeResolver: failed to resolve node name 'redstone_pressureplates:pressure_plate_…'
NodeResolver: failed to resolve node name 'redstone_button:button_…'
Les plaques de pression et les boutons de toutes les essences de bois n'existaient pas dans cette version : partout dans la carte, ils étaient devenus des blocs inconnus.
Trois leçons :
- changer la version d'un jeu, vers le haut OU vers le bas, peut abîmer un monde existant ;
- reste sur les versions officielles de ContentDB, pas sur des copies trouvées ailleurs ;
- sauvegarde AVANT chaque changement. Avec une sauvegarde faite le matin, il aurait suffi de la restaurer.
Pour l'anecdote, la version officielle suivante de Mineclonia annonçait justement « Fix a number of crashes involving unknown nodes ». Mettre son jeu à jour a du sens. Le faire sauvegarde en poche, encore plus.
2. Ce qu'il faut sauvegarder #
Le monde tient dans son dossier worlds/<nom>/. Les fichiers indispensables :
| Fichier | Sans lui |
|---|---|
map.sqlite |
plus de carte |
players.sqlite |
plus d'inventaires ni de positions |
auth.sqlite |
plus de comptes, de mots de passe ni de privilèges |
mod_storage.sqlite |
les mods perdent leurs données (zones protégées, maisons…) |
world.mt |
le monde ne sait plus quel jeu ni quels mods charger |
Pour pouvoir reconstruire le serveur à l'identique, il faut aussi minetest.conf, le dossier du jeu
dans games/ et tes mods dans mods/. Bonne nouvelle : une sauvegarde AMP prend tout ça d'un
coup.
3. Sauvegarder avec AMP #
La page Sauvegardes du panel crée une copie complète de ton serveur en un clic. Le tuto AMP, chapitre 05, explique la page en détail. Pour Luanti, un seul point compte :
Une sauvegarde AMP arrête le serveur pendant la copie, et c'est exactement ce qu'il faut. La
documentation de Luanti le dit clairement : copier les bases .sqlite pendant que le serveur écrit
dedans donne une sauvegarde « probablement corrompue ». Elle recommande une sauvegarde « à froid »,
serveur arrêté. Ne coche donc pas l'option pour sauvegarder serveur allumé.
Ce qu'une sauvegarde AMP laisse de côté tout seul : les journaux, les fichiers temporaires et
minetest.conf.example (que la mise à jour réinstalle). Tes fichiers .conf et .lua sont
toujours gardés.
Combien de place ? Un serveur Mineclonia joué un mois et demi, avec un monde de 448 Mo, donnait des sauvegardes d'environ 300 Mo (elles sont compressées). Elles comptent dans ton espace disque : garde les dernières, supprime les vieilles.
Ne touche pas aux réglages de stockage externe (S3) de la page Sauvegardes. Un serveur TeamKit les avait activés sans adresse : chaque sauvegarde se terminait par « Unable to upload backup ».
✅ À retenir Une sauvegarde AMP, serveur arrêté pendant la copie. Avant chaque mise à jour, chaque changement de jeu, chaque nouveau mod important.
4. Sauvegarder automatiquement #
Ton serveur est livré avec deux tâches déjà prêtes dans le Planificateur, mais désactivées :
| Tâche | Ce qu'elle fait |
|---|---|
| Hourly Backup | une sauvegarde toutes les heures, serveur arrêté pendant la copie |
| Daily Update | une mise à jour chaque jour à midi |
Pour un petit serveur, une sauvegarde par jour suffit largement : une toutes les heures arrête ton serveur 24 fois par jour et remplit ton disque. Crée plutôt ta propre tâche à une heure creuse (5 h du matin, par exemple). Le fonctionnement du Planificateur est expliqué dans le tuto AMP, chapitre 06.
Pour la mise à jour quotidienne, lis d'abord la section suivante : elle ne fait pas ce qu'on croit.
5. Mettre à jour le moteur Luanti #
Le bouton Mettre à jour de la page État réinstalle la version de Luanti choisie dans Configuration → Mises à jour → Version du serveur. Rien de plus : il ne va pas chercher tout seul la dernière version sortie. La liste du panel s'arrête pour l'instant à 5.17.0, la valeur par défaut.
Une mise à jour ne touche ni à ton monde, ni à tes mods, ni à ton jeu, ni à ton minetest.conf :
elle remplace seulement le moteur (bin/, builtin/).
Passer à une version plus récente (Luanti 5.18.0 est sortie fin octobre 2026) :
- fais une sauvegarde ;
- dans Configuration → Mises à jour, choisis
--Custom--dans Version du serveur ; - écris
5.18.0dans Version personnalisée du serveur ; - sur État, clique sur Mettre à jour, puis démarre.
Les clients de tes joueurs s'en accommodent : un client plus ancien que le serveur se connecte quand même, il lui manque seulement les nouveautés. Inutile de changer de version à chaque sortie : fais-le quand une nouveauté t'intéresse ou qu'un jeu l'exige.
6. Mettre à jour ton jeu #
C'est le geste le plus délicat, celui de l'histoire du début. La méthode sûre :
- lis les notes de version du jeu sur ContentDB : elles disent si les mondes existants sont concernés ;
- fais une sauvegarde ;
- arrête le serveur ;
- dans Fichiers → games, mets l'ancien dossier du jeu à la Corbeille ;
- télécharge et extrais la nouvelle version officielle, comme au chapitre 03, avec le même nom de dossier ;
- démarre, et lis la console : un
failed to resolve node namesignale des blocs devenus inconnus.
Si le monde est abîmé, arrête tout et restaure la sauvegarde de l'étape 2. Ne construis rien dans un monde rempli de blocs inconnus.
Quand une mise à jour corrige un vrai problème, n'attends pas trop : les notes de Mineclonia 0.124.1 le disaient en toutes lettres, « Server owners may want to update asap » (il corrigeait un problème de duplication d'objets).
✅ À retenir Notes de version → sauvegarde → serveur arrêté → version officielle, même nom de dossier → console.
7. Restaurer une sauvegarde #
Sur la page Sauvegardes, chaque sauvegarde a un bouton pour la restaurer : le serveur est arrêté, les fichiers sont remis tels qu'ils étaient au moment de la sauvegarde. Tout ce qui a été construit depuis est perdu : préviens tes joueurs. Détails dans le tuto AMP, chapitre 05.
✅ Checklist du chapitre #
❓ Si ça ne marche pas #
Le serveur plante en boucle et la console cite un fichier du jeu. C'est un bug du jeu. Regarde sur ContentDB si une version plus récente le corrige, puis suis la section 6. En attendant, demande de l'aide sur le Discord TeamKit avec les dernières lignes de la console.
Des blocs inconnus sont apparus après une mise à jour. Arrête le serveur et restaure la sauvegarde d'avant (section 7). Puis reste sur l'ancienne version, ou crée un nouveau monde pour la nouvelle.
La sauvegarde échoue avec « Unable to upload backup ». Le stockage externe (S3) a été activé sans adresse. Désactive-le dans les réglages des sauvegardes.
Mon disque est presque plein. Supprime les vieilles sauvegardes et vide la corbeille du gestionnaire de fichiers : sur un serveur TeamKit, la corbeille pesait trois fois le monde.
Après Mettre à jour, la version n'a pas changé. C'est la version choisie dans Configuration →
Mises à jour qui est installée. Choisis --Custom-- et la version voulue (section 5).