First version.
This commit is contained in:
parent
ecbe404695
commit
dd1ecde90c
310
README.md
310
README.md
|
|
@ -4,3 +4,313 @@ Service de mondes virtuels en 3D du candidat chaton de Libre en communs.
|
|||
|
||||
Responsable: Christian Momon (@cpm)
|
||||
|
||||
La première version de ce document est librement adaptée d'une fiche de Devinsy.
|
||||
|
||||
/!\/!\/!\/!\/!\/!\/!\/!\/!\
|
||||
|
||||
Rédaction en cours
|
||||
|
||||
/!\/!\/!\/!\/!\/!\/!\/!\/!\
|
||||
|
||||
# Site web
|
||||
|
||||
Pour l'instant n'utilise pas de flux web. Cela n'empêchera pas les gens d'essayer d'aller sur la page web https://libreverse.chalec.org/.
|
||||
|
||||
Donc une page d'information permet d'apporter une réponse à ce cas, par exemple en donnant des informations sur comment se connecter, comment configurer son client, où trouver un client…
|
||||
|
||||
Il s'agit d'une simle page XHTML faite à la main et placée dans `/var/www/libreverse.chalec.org/`.
|
||||
|
||||
## Installation basique
|
||||
Installation d'un service nginx pour :
|
||||
- l'installation d'une page d'information sur comment se connecter à Libreverse ;
|
||||
- une redirection vers la page du service sur le site https://www.chalec.org/ ;
|
||||
- l'éventuel déploiement de StatoolInfos ;
|
||||
- …
|
||||
|
||||
Installer les paquets :
|
||||
```
|
||||
apt-get install nginx python3-certbot-nginx
|
||||
```
|
||||
|
||||
Ouvrir les ports http (80) et https (443) :
|
||||
```
|
||||
ufw allow 'Nginx HTTP'
|
||||
ufw allow 'Nginx HTTPS'
|
||||
```
|
||||
|
||||
Configurer a minima le site web dans `/etc/nginx/sites-available/libreverse.chalec.org` :
|
||||
```
|
||||
server
|
||||
{
|
||||
listen 80;
|
||||
listen [::]:80;
|
||||
|
||||
server_name libreverse.chalec.org;
|
||||
|
||||
access_log /var/log/nginx/libreverse.chalec.org-access.log;
|
||||
error_log /var/log/nginx/libreverse.chalec.org-error.log;
|
||||
}
|
||||
```
|
||||
|
||||
Activer la configuration :
|
||||
```
|
||||
cd /etc/nginx/sites-enabled/
|
||||
ln -s ../sites-available/libreverse.chalec.org
|
||||
```
|
||||
|
||||
Vérifier que c'est bon et recharger :
|
||||
```
|
||||
nginx -t && systemctl reload nginx
|
||||
```
|
||||
|
||||
Configurer le certificat SSl :
|
||||
```
|
||||
certbot --nginx
|
||||
```
|
||||
|
||||
Mettre beau le fichier `/etc/nginx/sites-enabled/libreverse.chalec.org` :
|
||||
```
|
||||
server
|
||||
{
|
||||
listen 80;
|
||||
listen [::]:80;
|
||||
|
||||
server_name libreverse.chalec.org;
|
||||
|
||||
access_log /var/log/nginx/libreverse.chalec.org-access.log;
|
||||
error_log /var/log/nginx/libreverse.chalec.org-error.log;
|
||||
|
||||
#return 302 https://$host$request_uri;
|
||||
return 302 https://libreverse.chalec.org$request_uri;
|
||||
}
|
||||
|
||||
server
|
||||
{
|
||||
set_real_ip_from 192.169.1.1;
|
||||
real_ip_header proxy_protocol;
|
||||
listen [::]:443 ssl ipv6only=on;
|
||||
listen 443 ssl;
|
||||
|
||||
server_name libreverse.chalec.org;
|
||||
|
||||
access_log /var/log/nginx/libreverse.chalec.org-access.log;
|
||||
error_log /var/log/nginx/libreverse.chalec.org-error.log;
|
||||
|
||||
ssl_certificate /etc/letsencrypt/live/libreverse.chalec.org/fullchain.pem; # managed by Certbot
|
||||
ssl_certificate_key /etc/letsencrypt/live/libreverse.chalec.org/privkey.pem; # managed by Certbot
|
||||
include /etc/letsencrypt/options-ssl-nginx.conf; # managed by Certbot
|
||||
ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem; # managed by Certbot
|
||||
|
||||
root /var/www/libreverse.chalec.org;
|
||||
location = /
|
||||
{
|
||||
index index.xhtml;
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Vérifier que c'est bon et recharger :
|
||||
```
|
||||
nginx -t && systemctl reload nginx
|
||||
```
|
||||
|
||||
# Installation de Minetest
|
||||
|
||||
Ouvrir le port par défaut :
|
||||
```
|
||||
ufw allow 30000/udp
|
||||
```
|
||||
|
||||
Installer le serveur Minetest :
|
||||
```
|
||||
apt-get install minetest-server minetestmapper
|
||||
```
|
||||
|
||||
Pour privilégier le nommage des mondes, désactiver le monde par défaut :
|
||||
```
|
||||
systemctl stop minetest-server
|
||||
systemctl disabled minetest-server
|
||||
systemctl disabled minetest-server@minetest
|
||||
```
|
||||
|
||||
Optimiser la configuration de Postgresql :
|
||||
- avoir au moins 512MB de mémoire disponible pour Minetest hors Postgresql ;
|
||||
- modifier `/etc/postgresql/13/main/postgresql.conf` :
|
||||
```
|
||||
-shared_buffers = 128MB # min 128kB
|
||||
+shared_buffers = 512MB # min 128kB
|
||||
```
|
||||
|
||||
# Mineclone2
|
||||
|
||||
## Install
|
||||
Récupérer le zip :
|
||||
* https://content.minetest.net/packages/Wuzzy/mineclone2/
|
||||
* cliquer sur le bouton `Download`
|
||||
|
||||
Décompresser :
|
||||
```
|
||||
unzip mineclone2_6745.zip
|
||||
```
|
||||
|
||||
Ranger dans l'arborescence de Minetest :
|
||||
```
|
||||
mv mineclone2 /usr/share/games/minetest/games/
|
||||
```
|
||||
|
||||
## Création d'un monde
|
||||
|
||||
Choisir un port et l'ouvrir (remplacer X par un chiffre dédié) :
|
||||
```
|
||||
ufw allow 3000X/udp
|
||||
```
|
||||
|
||||
Créer un fichier de configuration élémentaire :
|
||||
```
|
||||
cp /etc/minetest/minetest.conf /etc/minetest/fooland.conf
|
||||
```
|
||||
|
||||
Éditer le fichier de configuration `/etc/minetest/fooland.conf` :
|
||||
```
|
||||
- server_name = My Minetest server
|
||||
+ server_name = Chalec – Mineclone2 – Fooland
|
||||
|
||||
- server_description = Minetest server powered by Debian
|
||||
+ server_description = Le libreverse pour tout le monde sur Chalec
|
||||
|
||||
-# server_address = game.minetest.net
|
||||
+ server_address = libreverse.chalec.org
|
||||
|
||||
-# server_url = http://minetest.net
|
||||
+ server_url = https://libreverse.chalec.org/
|
||||
|
||||
-port = 30000
|
||||
+port = 3000X
|
||||
|
||||
- default_game = minetest
|
||||
+ default_game = mineclone2
|
||||
|
||||
- motd = Welcome to Minetest. Enjoy your stay!
|
||||
+ motd = Bienvenue sur le Libreverse de Chalec \o/
|
||||
|
||||
-# map-dir =
|
||||
+map-dir = /srv/libreverse.chalec.org/worlds/fooland
|
||||
|
||||
- max_users = 15
|
||||
+ max_users = 64
|
||||
|
||||
- enable_damage = false
|
||||
+ enable_damage = true
|
||||
|
||||
- # disallow_empty_password = false
|
||||
+ disallow_empty_password = true
|
||||
```
|
||||
|
||||
Créer le dossier des mondes dans l'espace du service :
|
||||
```
|
||||
mkdir -p /srv/libreverse.chalec.org/worlds
|
||||
chown Debian-minetest /srv/libreverse.chalec.org/worlds
|
||||
```
|
||||
|
||||
Créer le nouveau monde :
|
||||
```
|
||||
systemctl start minetest-server@fooland.service
|
||||
```
|
||||
|
||||
Le démarrer au prochain boot :
|
||||
```
|
||||
systemctl enable minetest-server@fooland.service
|
||||
```
|
||||
|
||||
Tester le nouveau monde en se connectant avec un client Minetest.
|
||||
|
||||
## Migration dans Posgreql
|
||||
Créer un compte dédié (si pas déjà fait) :
|
||||
```
|
||||
su - postgres -c "psql -c \"create user minetestdba with password 'XXXXXXXX'; \" "
|
||||
```
|
||||
|
||||
Créer une base de données :
|
||||
```
|
||||
su - postgres -c "psql -c \"CREATE DATABASE minetestdb_fooland OWNER minetestdba; \""
|
||||
```
|
||||
|
||||
Associer le compte dédié avec la base fraîchement créée :
|
||||
```
|
||||
su - postgres -c "psql -c \"GRANT ALL PRIVILEGES ON DATABASE minetestdb_fooland TO minetestdba; \""
|
||||
```
|
||||
|
||||
Définir la base de données dans `/srv/libreverse.chalec.org/worlds/fooland/world.mt` :
|
||||
```
|
||||
pgsql_connection = host=127.0.0.1 port=5432 user=minetestdba password=XXXXX dbname=minetestdb_fooland
|
||||
pgsql_auth_connection = host=127.0.0.1 port=5432 user=minetestdba password=XXXXXX dbname=minetestdb_fooland
|
||||
pgsql_player_connection = host=127.0.0.1 port=5432 user=minetestdba password=XXXXXX dbname=minetestdb_fooland
|
||||
```
|
||||
|
||||
Migrer le nouveau monde vers le backend Postgres :
|
||||
```
|
||||
systemctl stop minetest-server@fooland.service
|
||||
/usr/games/minetestserver --migrate postgresql --world /srv/libreverse.chalec.org/worlds/fooland
|
||||
/usr/games/minetestserver --migrate-auth postgresql --world /srv/libreverse.chalec.org/worlds/fooland
|
||||
/usr/games/minetestserver --migrate-players postgresql --world /srv/libreverse.chalec.org/worlds/fooland
|
||||
chown Debian-minetester.games /srv/libreverse.chalec.org/worlds/fooland/world.mt
|
||||
systemctl start minetest-server@fooland.service
|
||||
```
|
||||
|
||||
## Jouer
|
||||
Liens utiles :
|
||||
- Mineclone2 : https://wiki.minetest.net/Games/MineClone_2/Differences_from_Minetest_Game
|
||||
- Database backends : https://wiki.minetest.net/Database_backends
|
||||
- Server commands : https://wiki.minetest.net/Server_commands
|
||||
- Item strings : https://wiki.minetest.net/Itemstrings
|
||||
- Privileges : https://wiki.minetest.net/Privilegesc
|
||||
|
||||
## Génération une carte du monde
|
||||
|
||||
### Migration du backend
|
||||
La procédure utilise `minetestmapper` qui ne gère pas Postgresql, donc une étape va consister à convertir la base de donnée.
|
||||
|
||||
Copier temporairement la base :
|
||||
```
|
||||
su - postgres -c "psql -c \"CREATE DATABASE test with template minetestdb_libremine; \""
|
||||
```
|
||||
|
||||
Copier temporairement l'arborescence du monde :
|
||||
```
|
||||
cp /srv/libreverse.chalec.org/worlds/libremine /srv/libreverse.chalec.org/worlds/test
|
||||
```
|
||||
|
||||
Modifier le paramétrage de la base de données dans le fichier de paramétrage du monde :
|
||||
```
|
||||
sed -i 's/minetestdb_libremine/test/g' /srv/libreverse.chalec.org/worlds/test/world.mt
|
||||
```
|
||||
|
||||
Migrer le `backend` du monde (minetestmapper ne sais pas gérer postgresql):
|
||||
```
|
||||
/usr/games/minetestserver --migrate sqlite3 --world /srv/libreverse.chalec.org/worlds/test
|
||||
/usr/games/minetestserver --migrate-players sqlite3 --world /srv/libreverse.chalec.org/worlds/test
|
||||
```
|
||||
|
||||
### Correspondance des couleurs
|
||||
|
||||
Minetestmapper sait traduire les blocs Minetest en pixel de couleur mais Mineclone2 apporte de nouveaux blocs. La liste des correspondances de couleurs est donc à générer :
|
||||
```
|
||||
./mtsedit -m Mineclone2 -C > mineclone-colors.txt
|
||||
```
|
||||
|
||||
### Génération
|
||||
```
|
||||
/usr/games/minetestmapper -i /srv/libreverse.chalec.org/worlds/test/ -o /srv/libreverse.chalec.org/foo.png --colors /srv/libreverse.chalec.org/mineclone-colors.txt --draworigin --drawscale
|
||||
```
|
||||
|
||||
### Nettoyage
|
||||
|
||||
Supprimer la base temporaire :
|
||||
```
|
||||
su - postgres -c "psql -c \"DROP DATABASE test; \""
|
||||
```
|
||||
|
||||
Supprimer l'arborescence temporaire :
|
||||
```
|
||||
rm -fr /srv/libreverse.chalec.org/worlds/test
|
||||
```
|
||||
|
|
|
|||
Loading…
Reference in New Issue