Les mods, c'est ce qui rend un serveur Luanti unique : protection de zones, maisons, ascenseurs, nouveaux blocs, petits jeux. Mais c'est aussi la première cause de serveur qui ne démarre plus. Ce chapitre montre la méthode qui marche, et les quatre erreurs vues en vrai sur un serveur TeamKit, pour que tu ne les fasses pas.
La règle d'or, avant tout le reste : un mod à la fois. Installe-le, active-le, redémarre, vérifie que tout va bien. Puis le suivant. Si tu en ajoutes dix d'un coup et que le serveur refuse de démarrer, tu ne sauras pas lequel accuser.
1. Où trouver des mods #
Sur ContentDB, onglet Mods. Avant d'en choisir un, vérifie sur sa page :
- qu'il est compatible avec ton jeu. Un mod écrit pour Minetest Game ne marche pas forcément avec Mineclonia ou VoxeLibre, et inversement : la page indique souvent les jeux pris en charge ;
- ses dépendances : les autres mods dont il a besoin pour fonctionner. Il faudra les installer aussi (section 5) ;
- la date de sa dernière version.
Quelques exemples de mods d'administration réellement utilisés sur un serveur TeamKit : areas
(protection de zones), sethome (une maison où se téléporter), elevator (ascenseurs). Ce sont des
exemples, pas des obligations.
2. Installer un mod #
C'est la même méthode que pour un jeu (chapitre 03), mais dans le dossier mods/ :
- Sur la page du mod, clic droit sur Download → Copier l'adresse du lien.
- Dans Fichiers, sur la ligne du dossier mods, clique sur ⋮ → Télécharger le fichier ici, colle le lien, OK.
- Ouvre
mods/. Si le fichier ne finit pas par.zip, renomme-le d'abord en.zip. - Extrais l'archive (⋮ sur le
.zip), puis mets le.zipà la Corbeille. - Vérifie le dossier obtenu : il doit contenir directement un fichier
init.lua(et en général unmod.conf). Un mod récupéré sur GitHub arrive souvent avec un suffixe (monmod-main,monmod-master) : renomme le dossier pour l'enlever.
Jamais de lien .git. Sur un serveur TeamKit, un lien finissant par .git a fait planter le
téléchargement du gestionnaire de fichiers, et un autre a donné un simple fichier soundchat.git au
lieu d'un mod. Prends toujours un lien vers un .zip.
3. Activer le mod dans le monde #
Voici ce que beaucoup ignorent : un mod déposé dans mods/ est désactivé par défaut, pour tous
les mondes. C'est la documentation officielle qui le dit. Sur ton PC, on coche le mod dans le menu
de Luanti ; sur un serveur, il n'y a pas de menu : on l'active à la main dans le fichier du monde.
- Arrête le serveur.
- Ouvre Fichiers → worlds → (ton monde) →
world.mt. - Ajoute une ligne à la fin :
load_mod_areas = true
- Enregistre, puis Démarre.
Le mot après load_mod_ est le nom du mod, et c'est là que tout se joue (section 4).
Pour désactiver un mod sans le supprimer, remplace true par false (serveur arrêté).
✅ À retenir Déposer un mod ne suffit pas :
load_mod_<nom> = truedansworld.mt, serveur arrêté.
4. Le bon nom, pas celui du dossier #
Le nom à écrire dans world.mt est celui que le mod se donne dans son fichier mod.conf, à la
ligne name = …. Pas forcément le nom du dossier téléchargé.
Erreurs réellement vues sur un serveur TeamKit, dans la console :
The following mods could not be found: "visual-bots"
The following mods could not be found: "minetest-k-recycler"
Le propriétaire avait recopié le nom du dossier GitHub, avec ses tirets. Or un nom de mod
Luanti ne contient ni tiret ni majuscule : c'est le name de mod.conf qu'il fallait écrire.
Pour le trouver : ouvre le dossier du mod, ouvre mod.conf, lis la ligne name. Il ressemble à
ceci (la description et les dépendances changent d'un mod à l'autre) :
name = areas
description = …
depends = …
C'est ce areas qui va dans load_mod_areas = true. Profites-en pour renommer le dossier du même
nom : c'est plus clair pour la suite.
5. Les dépendances : un mod manquant bloque tout #
Si un mod activé réclame un autre mod absent, le serveur entier refuse de démarrer, pas seulement ce mod. La console l'écrit clairement. Exemple réel :
ServerError: Some mods have unsatisfied dependencies:
- pipeworks is missing: fakelib xcompat basic_materials
Traduction : le mod pipeworks a besoin de trois autres mods, fakelib, xcompat et
basic_materials, qui ne sont pas installés. Ce serveur TeamKit est resté bloqué six fois sur ce
genre d'erreur.
La solution :
- lis la ligne
depends = …dumod.confdu mod (ou la section dépendances de sa page ContentDB) ; - installe chacun des mods listés, comme à la section 2 ;
- active-les aussi dans
world.mt; - redémarre.
Les optional_depends, eux, sont facultatifs : le mod marche sans, avec moins de fonctions.
Pense aussi au jeu : un mod qui dépend de default (le cœur de Minetest Game) ne trouvera pas cette
dépendance dans Mineclonia. C'est le signe qu'il n'est pas fait pour ton jeu.
✅ À retenir « unsatisfied dependencies » = des mods à installer ET à activer en plus. La console donne leurs noms.
6. Les modpacks #
Un modpack est un dossier qui regroupe plusieurs mods ; on le reconnaît à son fichier
modpack.conf (ou l'ancien modpack.txt). On ne l'active pas en bloc : on active chacun des mods
qu'il contient.
Exemple réel : un serveur TeamKit avait écrit load_mod_music_modpack = true et la console répétait
« The following mods could not be found: "music_modpack" ». Ce qui marchait, c'était d'activer les
mods du pack un par un :
load_mod_music_api = true
load_mod_music_default = true
Ouvre le dossier du modpack : chaque sous-dossier avec son propre mod.conf est un mod à activer.
7. Les avertissements sans gravité #
Au démarrage, la console peut afficher des centaines de lignes de ce genre :
Mods not having a mod.conf file with the name is deprecated.
depends.txt is deprecated
Field "image" on TileDef is deprecated
« Deprecated » veut dire « façon ancienne d'écrire, qui marche encore ». Ce sont des remarques pour
les auteurs des mods, pas des erreurs. Ton serveur tourne quand même. Les vraies erreurs, elles,
contiennent ServerError, could not be found ou Runtime error, et le serveur s'arrête.
8. Ce que tes joueurs voient #
Rien à faire de leur côté : à la connexion, le serveur leur envoie les textures, sons et modèles des mods. Seule la première connexion après l'ajout d'un gros mod prend un peu plus de temps.
Les packs de textures, eux, se règlent chez le joueur, dans son propre client Luanti : ce n'est pas quelque chose que le serveur impose.
✅ Checklist du chapitre #
❓ Si ça ne marche pas #
« Some mods have unsatisfied dependencies ». Installe et active les mods cités après « is missing ». Section 5.
« The following mods could not be found ». Le nom dans world.mt ne correspond à aucun mod :
nom de dossier au lieu du name de mod.conf, tiret, majuscule, ou modpack activé en bloc.
Sections 4 et 6.
Le mod est installé mais rien ne change en jeu. Il n'est pas activé : ajoute sa ligne
load_mod_… = true dans world.mt, serveur arrêté.
Le serveur plante en boucle depuis un mod. Désactive le dernier mod ajouté (= false dans
world.mt), redémarre, et lis la console : la ligne Runtime error from mod '…' donne le coupable.
Le chapitre 07 raconte un plantage de ce genre.
Le téléchargement échoue. Vérifie que le lien mène à un .zip. Si ça persiste, télécharge le
.zip sur ton PC et envoie-le par le gestionnaire de fichiers ou en SFTP (tuto AMP, chapitre 04).