La plupart des pannes d'un serveur Luanti viennent d'une seule confusion : croire que Luanti est un jeu, comme Minecraft. Ce chapitre est court et sans manipulation. Il pose les quatre briques, dit où chacune vit dans tes fichiers, et explique comment elles se parlent. Une fois que tu as ce schéma en tête, les chapitres suivants deviennent évidents.
1. Les quatre briques #
| Brique | Ce que c'est | Où elle vit (dans Fichiers) |
|---|---|---|
| Le moteur | Luanti lui-même : le réseau, les joueurs, l'affichage des blocs | bin/ et builtin/ |
| Le jeu | Les blocs, les objets, les recettes, les monstres, les règles | games/<nom-du-jeu>/ |
| Les mods | Des ajouts par-dessus le jeu : protection de zones, téléportation, nouveaux blocs… | mods/<nom-du-mod>/ |
| Le monde | Ta carte et tout ce que les joueurs y ont fait | worlds/<nom-du-monde>/ |
Le moteur, AMP l'installe et le met à jour (bouton Mettre à jour). Le jeu et les mods, c'est toi qui les choisis et les déposes. Le monde, Luanti le crée tout seul au premier démarrage.
N'ouvre jamais bin/ ni builtin/ : c'est le moteur, une mise à jour les réécrit.
✅ À retenir Moteur (AMP s'en occupe), jeu et mods (toi), monde (Luanti le crée). Quatre dossiers, quatre rôles.
2. Le jeu, et son identifiant #
Un jeu est un dossier rangé dans games/. Il contient un petit fichier game.conf qui lui donne un
titre, et des dizaines de mods internes qui forment le jeu lui-même.
Le nom du dossier est l'identifiant du jeu. C'est ce nom, et pas le titre affiché, que tu écris dans Configuration → Luanti → Identifiant du jeu. Quelques exemples réels, tels qu'ils arrivent depuis ContentDB :
| Le jeu | Le dossier (= l'identifiant) |
|---|---|
| Mineclonia | mineclonia |
| VoxeLibre | mineclone2 |
| Minetest Game | minetest_game |
Oui, VoxeLibre s'appelle mineclone2 dans les fichiers : c'est son ancien nom, gardé pour que les
vieux mondes continuent de marcher. C'est l'exemple parfait de la différence entre le titre et
l'identifiant.
Un jeu peut aussi imposer ses propres réglages. Mineclonia et VoxeLibre, par exemple, refusent le
générateur de carte v6 : leur game.conf contient la ligne disallowed_mapgens = v6. Si tu
choisis v6 dans le panel, le jeu ne l'acceptera pas.
✅ À retenir L'identifiant du jeu, c'est le nom de son dossier dans
games/, pas son titre.
3. Les mods #
Un mod est un dossier avec un fichier init.lua (son code) et un fichier mod.conf (sa carte
d'identité : son nom, sa description, et surtout ses dépendances, c'est-à-dire les autres mods
dont il a besoin).
Tu en trouveras à trois endroits possibles :
games/<jeu>/mods/: les mods du jeu. Ils font partie du jeu, on n'y touche pas ;mods/: tes mods à toi, disponibles pour n'importe quel monde. C'est là qu'on les met ;worlds/<monde>/worldmods/: des mods attachés à un seul monde, toujours actifs.
Deux pièges à connaître dès maintenant (le chapitre 06 les détaille) :
- un mod déposé dans
mods/est désactivé par défaut. Il faut l'activer dans le fichier du monde,world.mt; - un mod dont une dépendance manque empêche le serveur de démarrer. Pas seulement le mod : tout le serveur.
Un modpack est un dossier qui regroupe plusieurs mods. On ne l'active pas en bloc : on active chacun des mods qu'il contient.
✅ À retenir Tes mods vont dans
mods/, s'activent dansworld.mt, et doivent avoir toutes leurs dépendances.
4. Le monde #
Au premier démarrage, Luanti crée le monde dont le nom est écrit dans Configuration → Luanti →
Nom du monde (world par défaut). Il le range dans worlds/<nom>/. On y trouve :
| Fichier | Ce qu'il garde |
|---|---|
world.mt |
la fiche du monde : son jeu, ses mods activés, ses réglages de base |
map.sqlite |
la carte, bloc par bloc (le plus gros fichier) |
players.sqlite |
les inventaires et les positions des joueurs |
auth.sqlite |
les comptes, les mots de passe (chiffrés) et les privilèges |
mod_storage.sqlite |
ce que les mods enregistrent |
ipban.txt |
la liste des adresses bannies |
Voici à quoi ressemble un world.mt réel, celui d'un serveur Mineclonia :
gameid = mineclonia
world_name = Minestar
backend = sqlite3
auth_backend = sqlite3
player_backend = sqlite3
mod_storage_backend = sqlite3
enable_damage = true
creative_mode = false
load_mod_areas = true
load_mod_sethome = true
Trois choses importantes à en tirer :
- le monde se souvient de son jeu (
gameid = mineclonia). Un monde ne change pas de jeu sans dégâts : des blocs deviennent « inconnus ». Pour essayer un autre jeu, crée un autre monde en changeant le Nom du monde ; - les comptes et les privilèges sont dans le monde, pas dans le panel. Un nouveau monde, ce sont de nouveaux comptes ;
- les lignes
load_mod_… = truesont la liste des mods activés. On y revient au chapitre 06.
✅ À retenir Un monde = un jeu + ses mods + ses comptes. Changer de jeu, c'est changer de monde.
5. Ce que tes joueurs installent (presque rien) #
Bonne nouvelle pour tes joueurs : ils n'ont rien à installer à part le client Luanti, gratuit sur PC et sur Android. Ni le jeu, ni les mods. À la connexion, ton serveur leur envoie automatiquement tout ce qu'il faut afficher : textures, sons, modèles. Le code des mods, lui, reste sur le serveur.
C'est aussi pour ça que la première connexion à un serveur chargé de mods prend quelques secondes de plus : le client télécharge les médias, puis les garde en cache pour les fois suivantes.
✅ À retenir Tes joueurs installent Luanti, c'est tout. Ton serveur leur envoie le reste.
✅ Checklist du chapitre #
❓ Si ça ne marche pas #
Je ne vois pas de dossier worlds/. Il n'apparaît qu'après le premier démarrage réussi, avec un
jeu installé. Commence par le chapitre 03.
Le serveur refuse mon générateur de carte. Ton jeu l'interdit sans doute (disallowed_mapgens
dans son game.conf). Choisis-en un autre, v7 par exemple, et crée un nouveau monde.
J'ai changé l'Identifiant du jeu et mon monde est rempli de blocs inconnus. Arrête le serveur, remets l'ancien identifiant et redémarre, sans rien construire entre-temps. Si des blocs restent abîmés, restaure la sauvegarde d'avant le changement (chapitre 07). Pour essayer un autre jeu, change plutôt le Nom du monde.
Je veux tout recommencer à zéro. Change le Nom du monde (par exemple monde2) et redémarre :
Luanti crée un monde neuf et garde l'ancien dans worlds/, au cas où.