⛏️ Chapitre 6 · Ton serveur Luanti sur TeamKit

Ajouter des mods sans casser ton serveur

Mis à jour le 14/11/2026 ·

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/ :

  1. Sur la page du mod, clic droit sur Download → Copier l'adresse du lien.
  2. Dans Fichiers, sur la ligne du dossier mods, clique sur ⋮ → Télécharger le fichier ici, colle le lien, OK.
  3. Ouvre mods/. Si le fichier ne finit pas par .zip, renomme-le d'abord en .zip.
  4. Extrais l'archive (⋮ sur le .zip), puis mets le .zip à la Corbeille.
  5. Vérifie le dossier obtenu : il doit contenir directement un fichier init.lua (et en général un mod.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.

  1. Arrête le serveur.
  2. Ouvre Fichiers → worlds → (ton monde) → world.mt.
  3. Ajoute une ligne à la fin :
load_mod_areas = true
  1. 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> = true dans world.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 :

  1. lis la ligne depends = … du mod.conf du mod (ou la section dépendances de sa page ContentDB) ;
  2. installe chacun des mods listés, comme à la section 2 ;
  3. active-les aussi dans world.mt ;
  4. 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).

Une étape qui coince ? Ouvre un ticket sur le site ou demande sur le Discord TeamKit. Le bot Guide connaît ces pages.