⛏️ Chapitre 3 · Ton serveur Luanti sur TeamKit

Choisir et installer ton jeu depuis ContentDB

Mis à jour le 14/11/2026 ·

Ton serveur a son moteur, il lui manque son jeu. Dans ce chapitre, tu vas en choisir un sur ContentDB, le télécharger directement sur ton serveur sans passer par ton PC, le déclarer dans le panel, et lancer ton premier monde. Compte dix minutes, la première fois.

Avant de commencer, vérifie que tu as bien fait Mettre à jour (chapitre 01, geste 1) : dans Fichiers, tu dois voir le dossier games/.


1. Choisir ton jeu #

ContentDB, à l'adresse content.luanti.org, est la bibliothèque officielle de Luanti : jeux, mods et packs de textures, tous gratuits. Clique sur Games pour ne voir que les jeux.

Trois exemples parmi les plus joués, pour t'aider à choisir :

Le jeu Pour qui Identifiant du jeu (à écrire dans le panel) Sa page sur ContentDB
Mineclonia Tu veux une survie dans l'esprit de Minecraft, qui marche bien en multijoueur mineclonia ryvnf/mineclonia
VoxeLibre Même esprit, le projet historique dont Mineclonia est issu mineclone2 Wuzzy/mineclone2
Minetest Game Tu veux une base simple, sans monstres, à enrichir avec tes propres mods minetest_game Luanti/minetest_game

⚠️ Attention ryvnf/mineclonia est l'adresse de la page sur ContentDB, pas l'identifiant du jeu. Écrit dans le panel, il donne l'erreur Game "ryvnf/mineclonia" not found et le serveur ne démarre pas. L'identifiant, c'est seulement mineclonia, sans rien devant.

Ce ne sont que des exemples : Repixture, NodeCore, Asuna et bien d'autres valent le détour. Sur la liste publique des serveurs Luanti, les jeux de type Minecraft (Mineclonia, VoxeLibre) et Minetest Game sont de loin les plus présents.

Sur la page d'un jeu, regarde deux choses :

  • la version minimale de Luanti qu'il demande. Mineclonia et VoxeLibre veulent au moins la 5.10. Ton serveur est en 5.17 par défaut : tout va bien ;
  • la date de la dernière version : un jeu mis à jour récemment est un jeu suivi.

✅ À retenir Choisis ton jeu AVANT d'inviter du monde. En changer plus tard, c'est recommencer un monde.


2. Récupérer le lien de téléchargement #

Sur la page du jeu, il y a un gros bouton Download (ou Télécharger si le site s'affiche en français). Ne clique pas dessus : fais un clic droit → Copier l'adresse du lien.

Tu obtiens une adresse de ce genre :

https://content.luanti.org/packages/ryvnf/mineclonia/releases/<numéro>/download/

C'est un lien direct vers le fichier .zip de la dernière version. C'est exactement ce que le panel sait télécharger.

Pas de lien en .git. Si tu trouves un jeu ailleurs, sur GitHub par exemple, prends toujours le lien d'un fichier .zip, jamais une adresse qui finit par .git : le panel ne sait pas les télécharger et s'arrête sur une erreur.


3. Le télécharger sur ton serveur #

Le gestionnaire de fichiers d'AMP sait télécharger un fichier depuis Internet directement dans ton serveur. Pas besoin de le récupérer sur ton PC puis de le renvoyer.

  1. Ouvre Fichiers.
  2. Sur la ligne du dossier games, clique sur les trois points ⋮ à droite.
  3. Choisis Télécharger le fichier ici.
  4. Une fenêtre s'ouvre, en anglais : « Download file from URL ». Colle le lien copié à l'étape 2.
  5. Clique sur OK et attends : Mineclonia pèse environ 30 Mo, VoxeLibre environ 85 Mo.

Ouvre ensuite le dossier games/ : le fichier téléchargé y est.

Si son nom ne finit pas par .zip (le panel le nomme parfois d'après la fin de l'adresse, comme download), renomme-le d'abord : ⋮ → Renommer, et appelle-le jeu.zip.


4. L'extraire, puis vérifier le nom du dossier #

  1. Sur la ligne du fichier .zip, clique sur ⋮ et choisis l'action qui extrait l'archive.
  2. Attends la fin : un dossier apparaît à côté du .zip.
  3. Mets le .zip à la Corbeille (⋮ → Corbeille) : il ne sert plus à rien.

Regarde maintenant le nom du dossier créé. Un jeu téléchargé depuis ContentDB arrive déjà au bon nom : un seul dossier, mineclonia, mineclone2 ou minetest_game. Tu n'as rien à renommer.

Un jeu téléchargé depuis GitHub, lui, arrive souvent avec un suffixe : mineclonia-main ou monjeu-master. Renomme alors le dossier (⋮ → Renommer) pour enlever -main ou -master.

Pour être sûr de toi, ouvre le dossier : tu dois y voir un fichier game.conf et un dossier mods/. Si tu vois à la place un seul sous-dossier, c'est qu'il y a un niveau de trop : c'est ce sous-dossier qu'il faut placer directement dans games/.

Résultat attendu, pour Mineclonia :

games/
└── mineclonia/
    ├── game.conf
    ├── mods/
    └── …

✅ À retenir Dans games/, un dossier par jeu, au nom exact de l'identifiant, avec son game.conf dedans.


5. Déclarer le jeu dans le panel #

  1. Ouvre Configuration → Luanti, onglet Serveur.
  2. Dans Identifiant du jeu (le champ encadré en rouge), écris le nom exact du dossier : mineclonia, mineclone2, minetest_game… en minuscules, sans espace, sans faute.
  3. Profites-en pour remplir Nom de l'administrateur avec ton pseudo Luanti (chapitre 04).

Le panel enregistre tout seul. Le réglage est pris en compte au prochain démarrage du serveur.

Si tu veux choisir le générateur de carte ou une graine précise, c'est maintenant, avant le premier démarrage : onglet Monde (chapitre 05). Ces réglages ne servent qu'à la création du monde. Rappel : Mineclonia et VoxeLibre refusent le générateur v6. Laisse V7 (par défaut) si tu ne sais pas.


6. Premier démarrage #

  1. Sur État, clique sur Démarrer (ou redémarre, si le serveur tournait déjà).
  2. Ouvre la Console et attends. Le premier démarrage avec un gros jeu prend quelques dizaines de secondes : Luanti charge des centaines de mods internes.
  3. Le serveur est prêt quand tu lis une ligne comme celle-ci :
ACTION[Main]: Server for gameid="mineclonia" listening on 0.0.0.0:30000.

Au-dessus, tu verras peut-être des centaines d'avertissements du genre « depends.txt is deprecated » ou « Field "image" on TileDef is deprecated ». Ils sont sans gravité : ce sont des façons d'écrire que les auteurs du jeu doivent moderniser un jour. Le serveur tourne quand même.

Le monde est créé à ce moment-là, dans worlds/world/ (ou au nom que tu as mis dans Nom du monde).

  1. Lance ton client Luanti, entre l'adresse et le port affichés sur la page État, ton pseudo d'administrateur, et un mot de passe. Bienvenue dans ton monde !

✅ À retenir La ligne « listening on » dans la console = ton serveur est prêt. Les avertissements « deprecated » ne comptent pas.


7. Et si je veux changer de jeu plus tard ? #

Tu peux avoir plusieurs jeux dans games/ : le serveur ne lance que celui de l'Identifiant du jeu. Mais un monde garde le jeu avec lequel il a été créé (chapitre 02). Pour passer à un autre jeu proprement :

  1. fais une sauvegarde (chapitre 07) ;
  2. installe le nouveau jeu dans games/ comme plus haut ;
  3. change Identifiant du jeu ET Nom du monde (par exemple monde-voxelibre) ;
  4. redémarre : un monde neuf est créé, l'ancien reste intact dans worlds/.

Ne change jamais seulement l'identifiant en gardant le même monde. Un serveur TeamKit l'a appris à ses dépens : en remplaçant son jeu par une autre version, il s'est retrouvé avec des plaques de pression et des boutons devenus « inconnus » partout dans sa carte. L'histoire complète est au chapitre 07.


✅ Checklist du chapitre #

❓ Si ça ne marche pas #

Le téléchargement s'arrête sur une erreur. Vérifie que ton lien mène à un fichier .zip et ne finit pas par .git. Recopie le lien du bouton Download de ContentDB.

Le serveur s'arrête juste après Démarrer. Lis les dernières lignes de la console. Le plus souvent, l'Identifiant du jeu ne correspond à aucun dossier de games/ : une majuscule, un -main oublié, une faute de frappe. Compare lettre par lettre.

La console parle de « unsatisfied dependencies ». Ce n'est pas ton jeu qui manque, c'est un mod que tu as ajouté qui réclame un autre mod. Chapitre 06, section dépendances.

Le dossier du jeu contient un seul sous-dossier. Il y a un niveau de trop. Déplace (ou coupe et colle) ce sous-dossier directement dans games/, puis supprime le dossier vide.

Le générateur de carte est refusé. Ton jeu interdit celui que tu as choisi. Remets V7 (par défaut), change le Nom du monde et redémarre.

Mon disque se remplit. Les .zip mis à la corbeille y restent et comptent dans ton espace disque. Vide la corbeille de temps en temps (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.