Recette et déploiement VPS

Besoin d’un VPS ? 24Racks est bon marché et fait tourner ce projet sans souci. Plus de détails sur le choix dans Hébergement.

Il y a trois façons. Choisis-en une.

1. Recette txAdmin - le plus simple pour un serveur neuf.
2. DEPLOY_VPS.bat - pour un VPS Windows que tu veux mettre à jour d’un double-clic.
3. Manuel - voir Installation.

Recette txAdmin

Dans l’assistant de configuration de txAdmin, choisis Remote URL Template et colle :

https://raw.githubusercontent.com/Arcainex/bs19/main/recipe.yaml

Ce que fait la recette, dans l’ordre :

1. Demande à txAdmin une connexion à la base de données (connect_database).
2. Télécharge le framework, la carte et le server.cfg depuis GitHub.
3. Télécharge la dernière version d’oxmysql dans resources/.
4. Écrit ta clé de licence, la connection string de la base, les endpoints et sv_maxclients dans server.cfg.
5. Ajoute ton compte txAdmin comme principal admin en bas de server.cfg.

À l’étape de la base de données, utilise ton hôte MariaDB, le port 3306 et un utilisateur qui peut créer une base. Le téléchargement fait environ 700 Mo, laisse-lui quelques minutes. Une fois fini, clique sur Save & Run Server et active OneSync On dans Settings > FXServer.

Les tables sont créées au premier démarrage par bs_core, n’importe pas de SQL.

DEPLOY_VPS.bat

Si on t’a donné le script de déploiement VPS, lance-le sur le VPS. Une fois pour installer, puis à nouveau plus tard pour mettre à jour. Ce qu’il fait :

• Demande le dossier de données du serveur (par défaut C:\FXServer\beyondsurvival).
• Installe Git s’il manque (winget, ou l’installeur officiel sur Windows Server).
• Clone le dépôt, ou lors des exécutions suivantes réinitialise server.cfg et fait un git pull --ff-only.
• Installe MariaDB avec winget s’il ne trouve ni MariaDB ni MySQL.
• Crée une base beyondsurvival et un utilisateur beyondsurvival avec un mot de passe aléatoire, comme le fait txAdmin. Il essaie d’abord root sans mot de passe et ne demande que si ça échoue.
• Enregistre la connection string dans .dbconfig (exclu de git) pour que les exécutions suivantes ne redemandent jamais.
• Écrit db.cfg avec la ligne mysql_connection_string.

Après la première exécution, dans txAdmin choisis Existing Server Data, pointe vers le dossier, sélectionne server.cfg et active OneSync. Pour mettre à jour : relance le bat et redémarre le serveur.

db.cfg

server.cfg a une ligne exec db.cfg près du haut. db.cfg contient une seule ligne :

set mysql_connection_string "mysql://USER:PASSWORD@localhost/beyondsurvival?charset=utf8mb4"

Il est dans .gitignore, donc git pull n’y touche jamais et ne rentre jamais en conflit avec ton mot de passe. Si tu as monté le serveur à la main, tu peux faire pareil : mets la ligne dans db.cfg toi-même et garde la ligne factice dans server.cfg. Le exec vient après la ligne factice, donc la vraie l’emporte.

Attention

Ne commit jamais et n’envoie jamais à personne db.cfg, .dbconfig ou server.private.cfg. Ils contiennent le mot de passe de ta base de données et ta clé de licence.