Différences

Ci-dessous, les différences entre deux révisions de la page.

--- admin:services:minetest:mineclone2 [2022/04/23 11:33] – créée pitchum
+++ admin:services:minetest:mineclone2 [2024/12/27 16:03] (Version actuelle) – ↷ Liens modifiés en raison d'un déplacement. 35.160.27.221
@@ Ligne 1: / Ligne 1: @@
-====== Mineclone2 ======
+====== VoxelLibre ======
 {{ :admin:services:minetest:mineclone2-logo.png?400|}}
 [[https://git.minetest.land/MineClone2/MineClone2|Mineclone2]] est clone de Minecraft.
+<note important>Le jeu a changé de nom en mai 2024 : VoxeLibre. Cf. [[https://git.minetest.land/VoxeLibre/VoxeLibre/issues/4235]]</note>
 C'est un jeu sous licence GPLv3, développé à partir du le moteur de jeu [[https://www.minetest.net/|Minetest]], sous licence LGPL 2.1.
+Avant d'installer cette instance, il est nécessaire d'installer [[admin:services:minetest.chapril.org|minetest]].
+====== Installation ======
+===== Configuration du service =====
+  * port TCP dédié : 30009 (on rejoint le serveur sur minetest.chapril.org:30009)
+  * configuration systemd dans ''/etc/minetest/30009-mineclone2.conf'' (on utilise le service ''minetest-server@30009-mineclone.service'')
+  * instance située dans ''/srv/minetest.chapril.org/instances/30009-mineclone2''
+  * 2 bases de données postgresql : ''minetest-users-mineclone2'' et ''minetest-world-mineclone2''
+===== Jeu =====
+Le jeu est disponible sur [[https://content.luanti.org/packages/Wuzzy/mineclone2/|contentDB]].
+On l'installe via git dans le répertoire ''/srv/minetest.chapril.org/home/.minetest/games/''.
+<code bash>
+cd /srv/minetest.chapril.org/home/.minetest/games/
+git clone https://git.minetest.land/MineClone2/MineClone2.git
+mv MineClone2 mineclone2 && cd mineclone2
+git checkout -b chapril-ludo
+</code>
+<note>Modification de la route git suite au changement de nom :</note>
+<code bash>
+cd /srv/minetest.chapril.org/home/.minetest/games/mineclone2
+git remote set-url "origin" https://git.minetest.land/VoxeLibre/VoxeLibre/
+</code>
+La création de la branche ''chapril-ludo'' servira pour la mise à jour du jeu, voir la section dédiée plus bas.
+===== Mods =====
+Un travail de recherche et de comparaison a été fait et est consultable sur https://wiki.april.org/w/Chapril:services:minetest:revue_mods
+==== Pour la gestion du serveur ====
+=== eXtended Ban 2 ===
+Ce mod étend les possibilités d'exclusions du serveur, facilite les actions de modération et enregistre les actions pour une meilleure communication entre les membres de la modération. Plus d'informations sur la page [[https://content.minetest.net/packages/kaeza/xban2/|contentDB]].
+<code bash>
+cd /srv/minetest.chapril.org/home/.minetest/mods
+git clone https://github.com/minetest-mods/xban2.git
+</code>
+=== Filter ===
+Ce mod permet plusieurs actions automatiques en réponse à une tenue de propos injurieux sur le chat. Plus d'informations sur la page [[https://content.minetest.net/packages/sofar/filter/|contentDB]].
+<code bash>
+cd /srv/minetest.chapril.org/home/.minetest/mods
+git clone https://github.com/minetest-mods/filter.git
+</code>
+On définit une liste des mots soumis à action automatique :
+Ce mod filtera automatique chaque message contenant ces mots.
+La politique est :
+  - 3 avertissements
+  - mute temporaire de 5 minutes (le joueur ou la joueuse ne peut plus poster de messages dans le chat)
+  - 3 avertissements
+  - mute temporaire de 1h
+L'équipe de modération ayant accès à l'historique des actions pourra prendre des mesures d'exclusion temporaire ou définitive du joueur ou de la joueuse si
+=== Mod Antigrief ===
+Le principe d'un mod antigrief est de permettre aux joueuses et joueurs de protéger leurs création contre un potentiel vendalisme.
+Le jeu Mineclone2 propose dans son installation le mod "ProtectorAera".
+==== Pour le gameplay du serveur ====
+Pour le moment, on se contente du jeu originel, on pourra ajouter des mods en fonction des demandes.
+===== Configuration du monde =====
+Il s'agit du fichier ''world.mt'' placé dans le répertoire de l'instance :
+<file /srv/minetest.chapril.org/instances/30009-mineclone2/world.mt>
+gameid = mineclone2
+backend = postgresql
+pgsql_connection = host=127.0.0.1 port=5432 user=minetest password=common-outrank-cruelly dbname=minetest-world-mineclone2
+auth_backend = postgresql
+pgsql_auth_connection = host=127.0.0.1 port=5432 user=minetest password=common-outrank-cruelly dbname=minetest-auth
+player_backend = postgresql
+pgsql_player_connection = host=127.0.0.1 port=5432 user=minetest password=common-outrank-cruelly dbname=minetest-users-mineclone2
+# Not supported yet, we have to wait for minetest 5.7.0
+#mod_storage_backend = postgresql
+#pgsql_mod_storage_connection = host=127.0.0.1 port=5432 user=minetest password=common-outrank-cruelly dbname=minetest-mod-storage-mineclone2
+mod_storage_backend = sqlite3
+load_mod_xban2 = true
+load_mod_filter = true
+load_mod_whitelist = false
+</file>
+On crée les bases de données postgres :
+<code bash>
+su - postgres
+psql
+CREATE DATABASE "minetest-users-mineclone2" WITH OWNER minetest;
+CREATE DATABASE "minetest-world-mineclone2" WITH OWNER minetest;
+</code>
+===== Vérification par principe =====
+<code bash>
+chown -R Debian-minetest:minetest /srv/minetest.chapril.org/home/.minetest
+chown -R Debian-minetest:games /srv/minetest.chapril.org/instances/30009-mineclone2
+</code>
+===== Démarrage du service =====
+<code bash>
+systemctl start minetest-server@30009-mineclone2.service
+</code>
+===== Création du rapport d'activité =====
+Le script pour créer le rapport d'activité est situé dans : ''/srv/minetest.chapril.org/tools/rapport_activite/rapport_activite_mineclone2.sh''. Il est exécuté chaque mois par une tâche cron dont une copie se trouve dans le même répertoire.
+Les logs sont situés dans le répertoire ''/srv/minetest.chapril.org/exploitation''.
+Le script ''/srv/minetest.chapril.org/tools/rapport_activite/update_redmine_script.sh'' permet de nourrir le ticket "Tâche récurrente" n°6220 pour diffuser publiquement les statistiques de l'instance.
+====== Maintenance ======
+===== Mise à jour du jeu =====
+On suit les releases du jeu, à chaque release un tag est créé sur le dépôt git, on peut suivre ça sur la [[https://git.minetest.land/VoxeLibre/VoxeLibre/tags|forge de Minetest]].
+<note important>Il peut arriver qu'une version plus récente de Mineclone2 exige également une mise à jour de Minetest. Puisque on utilise les paquets Debian, ce n'est pas toujours une chose possible, donc il faut prévoir la possibilité de revenir en arrière si besoin. Pour permettre cela, nous utilisons la branche //git// locale nommée ''chapril-ludo'' et on créé localement un //tag// sur la révision //git// actuelle avant chaque tentative de mise à jour.</note>
+Le projet étant toujours en développement sur la branche //master//, on suit les releases via les tags. Quand une nouvelle release sort, on va sur le dépôt gitea pour récupérer le commit de la release. On s'en servira pour la mise à jour de notre instance.
+<code bash>
+cd /srv/minetest.chapril.org/home/.minetest/games/mineclone2/
+git tag chapril-ok-$(date +%F) # pour un éventuel retour en arrière
+git fetch --all
+git merge <sha1 commit du dernier tag>
+systemctl restart minetest-server@30009-mineclone2.service
+</code>
+En cas de conflit pendant le merge, résoudre manuellement les différentes en se basant au maximum sur la release puis :
+<code bash>
+git add <les fichiers édités>
+git commit -m "fix merge with commit from 0.83.1 tag"
+</code>
+On peut ensuite redémarrer le service.
+Il faut maintenant tester un minimum.
+Si jamais un bug bloquant survient, on peut revenir à la version précédente grâce au ''tag'' qu'on avait créé.
+<note tip>La procédure décrite çi-après est "sale", mais elle fonctionne. Si quelqu'un connait une façon plus propre de procéder, ça m'intéresse :)</note>
+<code bash>
+cd /srv/minetest.chapril.org/home/.minetest/games/mineclone2/ # si jamais vous étiez parti ailleurs :)
+git tag | grep chapril # pour retrouver votre tag, par exemple "chapril-ok-2023-01-15" ici
+git checkout chapril-ok-2023-01-15 # on se retrouve alors dans un état temporaire "HEAD detached at chapril-ok-2023-01-15"
+git branch -m chapril-ludo chapril-ludo-broken # on met de côté l'ancienne branche
+git switch -c chapril-ludo # on recréé la branche
+git branch -D chapril-ludo-broken # on jette l'ancienne
+systemctl restart minetest-server@30009-mineclone2.service
+</code>
+===== Mise à jour des mods =====