Table des matières

Le service est en court de refonte et n'est plus accessible pour le moment. La documentation est aussi en cours de remaniements.

Service minetest.chapril.org

Minetest, initialement basé sur le jeu non libre Minecraft, a évolué et permet non seuleument des modification mais de créer des jeux à part entière. Maintenant le moteur de jeu se nomme Luanti et le jeu Minetest a évolué dans plusieurs projets qui ont pris des directions différentes: Minetest/MTG qui est le jeu original mais ne recoit qu'une maintenance minimale, Mineclonia qui prend le relay et Voxelibre qui veut rester proche mais tout en s'autorisant des innovations.

Les instances existantes au sein du Chapril sont :

Installation façon Chapril

VM

Création de la VM ludo avec la procédure Création d'une machine virtuelle « bling ».

Service de base Luanti

Luanti a été empaqueté dans Debian unstable mais n'est pas encore disponible en version stable; un backport est prévu mais il n'est pas encore prêt. L'un des mainteneur du paquet a créé une branche de travail sur Salsa et le paquet fonctionne déjà bien donc nous allons l'utiliser: https://salsa.debian.org/twrightsman/minetest/-/tree/debian/bookworm-backports?ref_type=heads Si on clique sur le CI et dans l'étape “build” on peut télécharger un zip et les packages donc on a besoin. Malheureusement le jeu minetest originel est une dépendance forte pour le moment et doit être installé même si nous n'allons pas l'utiliser. Ce paquet est en cours d'acceptation dans Debian et doit aussi être installé via Salsa comme le précédant en utilisant l'URL suivante: https://salsa.debian.org/games-team/luanti-game-minetest On peut ensuite installer les paquets nécessaires, ce qui va causer une erreur, attendue, car des dépendances manquent mais nous pouvons demander au gestionnaire de paquet de les installer pour nous:

cd debian/output
dpkg -i luanti-server_*.deb luanti-data_*.deb luanti-game-minetest_*.deb
apt -f install

Créons l'espace pour les données des différents jeux (on utilise /srv au Chapril, ce qui simplifie les sauvegardes):

mkdir -p /srv/minetest.chapril.org/{instances,mods}

Le paquet luanti permet déjà de lancer de multiple jeux grâce a systemd. Le jeu configuré par defaut n'étant pas utilisé nous allons le désactiver:

systemctl stop minetest-server.service
systemctl disable minetest-server.service

Nous avons besoin de créer un utilisateur pour lancer le service:

adduser --disabled-password --system --home /srv/minetest.chapril.org/home --gecos "Minetest dedicated server" --ingroup games --force-badname Debian-minetest

Dans le paquet de Luanti chaque instance est lancée avec un utilisateur dynamique; c'est bien pour la sécurité mais celui nous empêche de stoker les données dans /srv comme c'est l'usage au Chapril. C'est pour cela que l'utilisateur crée précédemment sera utilisé mais nous allons malgré tout activer des mesures de sécurité pour compenser. Pour cela nous allons modifier la configuration systemd du service. Créons un répertoire pour mettre cette configuration:

mkdir /etc/systemd/system/luanti-server@.service.d

Et créons le fichier /etc/systemd/system/luanti-server@.service.d/chapril.conf:

[Service]
DynamicUser=no
User=Debian-minetest
Group=games
SupplementaryGroups=minetest
RemoveIPC=yes
PrivateTmp=yes
NoNewPrivileges=yes
RestrictSUIDSGID=yes
ProtectSystem=strict
PrivateDevices=yes
ReadWritePaths=/srv/minetest.chapril.org/instances/%i
Environment=
Environment=MINETEST_USER_PATH=/srv/minetest.chapril.org/instances/%i
Environment=MINETEST_MOD_PATH=/srv/minetest.chapril.org/mods
Environment=LUANTI_GAMEID=instancegame

Puis activons ces changements:

systemctl daemon-reload

Créons un base de donnée pour authentifier les utilisateurs (elle sera mise en commun pour tous les jeux):

su -l postgres -c "createdb -O minetest luanti-shared-auth"

Organisation des sous-services

Chaque jeu est en fait un sous-service indépendant mais ils partagent quelques éléments en commun:

Pour chaque jeu nous avons décidé de l'organisation suivante (avec <port> le numéro de port réseau et <jeu> le nom du jeu en minuscule, à remplacer par les bonnes valeurs) :

On crée le fichier de configuration /etc/luanti/<port>-<jeu>.conf (en remplacant les valeurs, et avec <jeu-desc> le nom du jeu avec sa capitalisation usuelle):

server_name = Chapril - <jeu-desc>
server_description = Instance Luanti / <jeu-desc> du Chapril
motd = Bienvenu à tous !
 
server_url = https://www.chapril.org/cgu.html
server_announce = false
ipv6_server = false
port = <port>
prometheus_listener_address = 127.0.0.1:<port>
 
# superadmin
name = Duck

On crée les bases de données:

su - postgres
createdb -O minetest luanti-world-<jeu>
createdb -O minetest luanti-users-<jeu>
createdb -O minetest luanti-mods-<jeu>

On crée les répertoires pour l'instance et on donne les droits d'écriture au service dans certains répertoires:

mkdir -p /srv/minetest.chapril.org/instances/<port>-<jeu>/data/games
mkdir -p /srv/minetest.chapril.org/instances/<port>-<jeu>/data/worlds/world
chown Debian-minetest: /srv/minetest.chapril.org/instances/<port>-<jeu>
chown Debian-minetest: /srv/minetest.chapril.org/instances/<port>-<jeu>/data/worlds/world

On va sur le site ContentDB de Luanti qui contient la liste des jeux disponibles, on va sur la page de description du jeu, puis on clique sur le lien intitulé Source pour aller chercher le code du jeu. Sur le nouveau site il nous faut trouver le lien avec le dépôt git que l'on nommera <git-url>, puis on installera le jeu ainsi:

cd /srv/minetest.chapril.org/instances/<port>-<jeu>/data/games
git clone <git-url> instancegame
cd instancegame
git checkout <git-version>
git submodule init
git submodule update

<git-version> est la version du jeu a installer. Vous pouvez lister les versions disponibles avec git tag -ln.

On va ensuite créer la configuration du monde /srv/minetest.chapril.org/instances/<port>-<jeu>/worlds/world/world.mt (en remplacant les valeurs, avec <db-password> le mot de passe pour la base de donnée que l'on trouvera dans le fichier /etc/luanti/secrets et <map-generator> qui est le nom du générateur de carte qui dépend des possibilités du jeu et du choix des animateurs):

world_name = world
gameid = instancegame
 
backend = postgresql
pgsql_connection = host=127.0.0.1 port=5432 user=minetest password=<db-password> dbname=luanti-world-<jeu>
 
player_backend = postgresql
pgsql_player_connection = host=127.0.0.1 port=5432 user=minetest password=<db-password> dbname=luanti-users-<jeu>
 
mod_storage_backend = postgresql
pgsql_mod_storage_connection = host=127.0.0.1 port=5432 user=minetest password=<db-password> dbname=luanti-mods-<jeu>
 
auth_backend = postgresql
pgsql_auth_connection = host=127.0.0.1 port=5432 user=minetest password=<db-password> dbname=luanti-shared-auth
 
mg_name = <map-generator>
creative_mode = false
enable_damage = true
enable_pvp = false
disable_fire = false
enable_tnt = true
 
load_mod_lib_chatcmdbuilder = true
load_mod_whitelist = true
load_mod_xban2 = true
load_mod_filterpp_lib = true
load_mod_warn = true
load_mod_filterpp = true

Certains mods sont activé par défaut car utiles à la bonne gestion du serveur et leur utilité et installation est expliqué plus loin sur cette page.

La configuration générale du jeu, celle du monde, ainsi que la liste des mods pourront donner lieu à des ajustements selon les jeux, les désirs des joueurs et les décisions des animateurs.

On lance finalement le service:

systemctl start luanti-server@<port>-<jeu>.service

Installation des mods

On va sur le site ContentDB de Luanti qui contient la liste des mods disponibles, on va sur la page de description du mod, on vérifie qu'il est compatible avec les jeux avec lesquels on aimerait l'utiliser, puis on clique sur le lien intitulé Source pour aller chercher le code du mod. Sur le nouveau site il nous faut trouver le lien avec le dépôt git que l'on nommera <git-url>, puis on installera le jeu ainsi:

cd /srv/minetest.chapril.org/instances/<port>-<jeu>/mods
git clone <git-url>

Souvent les mods n'ont pas de version définie mais si c'est le cas on peut vérifier la liste des version (git tag -ln) puis la sélectionner (git checkout <git-version>).

Attention, un mod peux avoir des dépendances listée sur sa page de description et dans ce cas il est nécessaire d'installer ces dépendances de la même facon.

Ensuite il est nécessaire d'activer le mod et ses dépendances. Le nom d'un mod ne correspond pas forcément au nom du répertoire de l'installation. Le plus simple est tout simplement de relancer le service, ce qui va ajouter les bonnes entrée dans la configuration qu'il nous suffira d'activer.

On relance le services:

systemctl restart luanti-server@<port>-<jeu>.service

Puis on modifie le fichier /srv/minetest.chapril.org/instances/<port>-<jeu>/worlds/world/world.mt ou l'on trouvera des entrées du type load_mod_<mod-name> = false; on changera false en true pour le mod et ses dépendances, puis on relance a nouveau le service pour prendre en compte l'activation:

systemctl restart luanti-server@<port>-<jeu>.service

Mods installés par défaut

Certains mods seront installés et activés pour tous les jeux car ils sont importants pour la bonne gestion du services:

La liste des mots interdits pour le mod filter est vides. L'ancienne doc sur ce wiki faisait mention d'une lite de mots dans le fichier mod_storage/words.txt mais elle n'a pas été trouvée. Il faudra donc chercher une liste de mot et l'installer au bon format pour que le mod puisse l'utiliser.

Le mod Areas n'a pas encore été testé mais semble prometteur. La configuration de la zone est un peu complexe en ligne de commande et c'est pour cela que le mod Markers a été ajouter pour simplifier la configuration de façon plus visuelle

Procédures diverses

Gestion administrateur générale

Pour comprendre les privilèges : https://docs.luanti.org/for-players/privileges/

Pour comprendre les commandes serveur : https://docs.luanti.org/for-players/server-commands/

Donner un privilège

/grant <player> <privilege>

Révoquer un privilège

/revoke <player> <privilege>

Exclure un compte (ie le déconnecter du serveur, la personne peut revenir)

/kick <player> [reason]

Bannissement

La documentation est disponible ici : https://content.minetest.net/packages/kaeza/xban2/

Bannir un compte définitivement

/xban <player_or_ip> <reason>

Bannir un compte temporairement :

/xtempban <player_or_ip> <time> <reason>

Le temps peut être exprimé en secondes, minutes, heures, jours, semaines, mois, années et les valeurs sont combinables, par exemple “1Y3M3D7h” pour bannir 1 an, 3 mois, 3 jours et 7 heures.

Lister l'historique de bannissement pour un compte

/xban_record <player_or_ip>

Dé-bannir un compte

/xunban <player_or_ip>

Effacer un monde

L'idée est de supprimer toutes les données pour recommencer une partie de zéro. Ou nettoyer un serveur de test :)

Supervision

Plusieurs sondes ont été mises en place pour surveiller le service Minetest. Les scripts personnalisés sont situés dans le répertoire /srv/minetest.chapril.org/tools/monitoring/, un lien dans /usr/local/lib/nagios/plugins/ permet de les rendre accessibles à nagios.

Sauvegarde

La sauvegarde globale des VMs permet de sauvegarder les données clés à savoir :