Gérer vos serveurs

Le quotidien de l'exploitation de serveurs de jeu avec Saba-chan : ajout, démarrage et surveillance des serveurs, sauvegardes, planifications, invitation d'amis et intégration Discord.

Gérer vos serveurs

Ce document explique comment utiliser Saba-chan du point de vue de l'utilisateur. Même sans toucher au code des modules ni écrire vos propres extensions, cette seule page suffit pour faire tourner un ou deux serveurs de jeu pour vos amis.

L'installation est traitée dans Démarrage, et l'appairage du bot dans Bot Discord & relais cloud. Ici, on suppose que l'installation est terminée et on se concentre sur ce que vous cliquez et ce que vous regardez pendant que la GUI est ouverte.


1. Vue d'ensemble : la GUI est une télécommande, le démon fait tourner les serveurs

À savoir d'abord : fermer la fenêtre de la GUI n'arrête pas vos serveurs de jeu.

  • saba-chan-gui (fenêtre) : la télécommande qui envoie des commandes au démon et affiche l'écran. La CLI (saba-chan-cli) joue le même rôle.
  • saba-core (démon) : le processus central qui tourne en arrière-plan, lance les serveurs de jeu et les supervise. L'exécution des serveurs, les sauvegardes, les tâches planifiées et la connexion Discord sont toutes gérées par le démon.
  • Processus des serveurs de jeu : les serveurs réels lancés par le démon (java, PalServer.exe, etc.).

Votre routine quotidienne ressemble donc à ceci :

  1. Lancez la GUI et le démon démarre avec elle (s'il tourne déjà, la GUI s'y rattache).
  2. Quand vos amis s'apprêtent à se connecter, appuyez sur Démarrer dans l'écran du serveur.
  3. Pendant que vous jouez, vous pouvez réduire ou fermer la fenêtre. À la fermeture, vous choisissez entre Fermer l'interface (le démon continue de tourner) et Quitter complètement (le démon s'arrête aussi). Pour garder les serveurs en marche, choisissez Fermer l'interface.
  4. Une fois terminé, rouvrez la GUI et appuyez sur Arrêter.

Éteindre votre PC arrête aussi vos serveurs de jeu. Le démon ne tourne que sur votre propre PC. Si vous voulez une disponibilité 24 h/24, 7 j/7, utilisez un hébergement dédié.


2. Créer votre premier serveur (résumé rapide)

Voir Démarrage pour la procédure complète. En bref :

  1. Dans l'écran Serveurs, cliquez sur Ajouter un serveur.
  2. Choisissez Ajouter comme nouveau serveur. Si vous avez déjà un dossier de serveur, Migration d'un serveur existant le lie à la place (les fichiers restent là où ils sont).
  3. Choisissez un jeu (Minecraft / Palworld / Project Zomboid / Terraria, etc.), puis définissez le nom du serveur et un préréglage recommandé.
  4. Si le jeu comporte des conditions à accepter, vous les acceptez ici. Par exemple, Minecraft exige d'accepter l'EULA de Minecraft avant que le serveur puisse démarrer (§3.7).
  5. Cliquez sur Ajouter un serveur. Les fichiers du serveur sont téléchargés automatiquement et la progression s'affiche dans l'écran du serveur.
  6. Une fois l'installation terminée, le serveur apparaît dans la liste.

Vous pouvez nommer votre serveur comme vous voulez : « Minecraft entre amis », « Zomboid du week-end », etc. Dans les commandes Discord, vous pouvez désigner un serveur par son nom ou par le nom de son jeu (alias). Vous pouvez renommer un serveur arrêté avec le bouton crayon à côté de son nom.


3. Fonctionnement au quotidien

Sélectionner un serveur ouvre son écran à droite. En haut se trouvent le bouton Démarrer/Arrêter et l'état ; en dessous, les onglets. Les onglets affichés dépendent du jeu.

OngletContenu
ConsoleSortie du serveur et saisie de commandes (uniquement pour les jeux dotés d'une console)
CommandesLes commandes définies par le jeu (p. ex. annonces et liste des joueurs de Palworld)
ParamètresParamètres du jeu (port, nombre maximal de joueurs, mot de passe, etc.)
Saba-chanRéglages de la façon dont Saba-chan gère le serveur : redémarrage auto, limite de mémoire, délai d'arrêt, aperçu des arguments de lancement, relais du chat du jeu
SauvegardesCréation et restauration de sauvegardes, tâches planifiées
DiscordLes mots qui désignent ce serveur et ses commandes sur Discord
JournalQui a démarré, arrêté ou envoyé des commandes, et quand
InfosPort, version, temps de fonctionnement, arrêts récents, vérification du serveur, ouverture du dossier du serveur, suppression du serveur

3.1 Démarrer / Arrêter / Redémarrer

  • Démarrer : le démon vérifie d'abord l'acceptation des conditions et exécute les vérifications du module, puis lance le serveur. Si la vérification détecte un problème critique, le serveur n'est pas démarré et la raison est affichée.
  • Arrêter : envoie la commande d'arrêt propre du jeu (p. ex. stop pour Minecraft, quit pour Zomboid) et attend. Si le serveur ne s'est pas arrêté dans le délai d'arrêt (30 secondes par défaut ; il varie selon le jeu et peut être modifié dans l'onglet Saba-chan), il est tué de force.
  • Redémarrer : enchaîne arrêt → démarrage en une seule étape. Les joueurs connectés sont brièvement déconnectés.

3.2 Consulter la console / envoyer des commandes

  • L'onglet Console affiche la sortie du serveur de jeu en temps réel.
  • Tapez une commande et appuyez sur Entrée pour l'envoyer à la console du serveur (stdin). Exemples pour Minecraft : say hi!, op FriendNick. Utilisez ↑ pour rappeler les commandes précédentes.
  • Les commandes suivent l'ordre stdin → REST → RCON. Les jeux sans console (comme Palworld, contrôlé uniquement via son API REST) se pilotent avec les commandes prédéfinies de l'onglet Commandes. RCON n'est utilisé que pour un jeu sans autre voie, uniquement en loopback (127.0.0.1) avec un port et un mot de passe aléatoire par instance attribués par le démon.
  • La console peut être détachée dans une fenêtre séparée, et sous Windows, Ouvrir dans le terminal ouvre une console CLI.
  • Pour chaque serveur, le démon conserve en mémoire les lignes de console les plus récentes (jusqu'à 10 000) et les écrit aussi dans des fichiers sous logs/ dans le dossier du serveur.

3.3 Faire tourner plusieurs serveurs à la fois

  • Vous pouvez créer plusieurs serveurs du même jeu (p. ex. « MC Vanilla » et « MC Modpack ») ou faire tourner différents jeux côte à côte.
  • Les ports (les numéros qu'un jeu utilise pour accepter les joueurs) de chaque serveur ne doivent pas se chevaucher. Lorsque vous créez un nouveau serveur, Saba-chan décale le port par défaut pour éviter tout conflit avec vos autres serveurs, et un avertissement apparaît dans l'écran du serveur si des ports se chevauchent. Vous pouvez changer le port dans l'onglet Paramètres.
  • Chaque serveur supplémentaire utilise plus de mémoire et de CPU sur votre PC. Vérifiez les caractéristiques de votre PC avant d'en ajouter.

3.4 Détection des crashs et redémarrage automatique

  • Lorsqu'un serveur s'arrête, le démon en détermine la raison : Arrêté par vous, Arrêté en jeu, Crash ou Inconnu. Le verdict est enregistré dans Arrêts récents sur l'onglet Infos.
  • S'il est jugé comme Crash, le serveur est redémarré automatiquement par défaut. Le premier redémarrage a lieu après 5 secondes, et l'attente double à chaque redémarrage. Au-delà de 3 redémarrages en 10 minutes, Saba-chan ne redémarre plus le serveur, et vous devez le démarrer vous-même.
  • Vous pouvez modifier ce comportement sous Redémarrage auto dans l'onglet Saba-chan.
    • Redémarrer après un crash : lorsque le serveur s'est clairement arrêté à cause d'une erreur (activé par défaut).
    • Redémarrer aussi sur les arrêts inconnus : couvre aussi les cas impossibles à juger, comme un arrêt depuis le Gestionnaire des tâches (désactivé par défaut).
  • Les serveurs que vous avez arrêtés vous-même, depuis Saba-chan ou depuis le jeu, ne sont pas redémarrés.

3.5 Limite de mémoire (Windows)

  • Sous Limite de mémoire dans l'onglet Saba-chan, vous pouvez plafonner la mémoire (Mo) que le serveur et ses processus enfants peuvent utiliser ensemble. Si la limite est dépassée, le serveur est arrêté.
  • Laissez le champ vide pour ne fixer aucune limite. Pour les serveurs Java, réglez-la 1 à 2 Go au-dessus de -Xmx.
  • Windows uniquement ; prend effet après le redémarrage du serveur.

3.6 Aperçu des arguments de lancement

  • Pour les jeux qui utilisent des arguments de lancement, Aperçu des arguments de lancement dans l'onglet Saba-chan affiche la ligne de commande avec laquelle le serveur serait lancé avec les paramètres actuels, sans le démarrer.
  • Les arguments que vous placez dans Arguments supplémentaires et qui ne figurent pas dans l'écran des paramètres (p. ex. -players=16 -useperfthreads) sont transmis tels quels au lancement. Les valeurs mal formées sont signalées directement dans l'aperçu.
  • Les valeurs comme les mots de passe sont masquées sous la forme ***.

3.7 Accepter les conditions (EULA de Minecraft, etc.)

  • Si un serveur de jeu comporte des conditions qui exigent un consentement, une boîte de dialogue Accord requis apparaît lorsque vous créez le serveur ou le démarrez pour la première fois. Lisez le texte original, cochez la case et cliquez sur Accepter et démarrer.
  • Le consentement ne peut être donné que depuis la GUI ou la CLI de ce PC. Si quelqu'un tente de démarrer le serveur depuis Discord avant l'acceptation des conditions, acceptez-les d'abord sur le PC.

4. Sauvegardes et tâches planifiées

Elles se trouvent dans l'onglet Sauvegardes. Les tâches planifiées sont disponibles pour tous les serveurs ; la liste des sauvegardes et les tâches de sauvegarde n'apparaissent que pour les jeux prenant en charge les sauvegardes.

4.1 Sauvegardes

  • Sauvegarder compresse le monde et les fichiers de sauvegarde. Le module de jeu décide de ce qui est sauvegardé (pour Minecraft, les dossiers des mondes). Si le serveur tourne, une commande de sauvegarde (save-all pour Minecraft, etc.) est d'abord envoyée au jeu.
  • La liste des sauvegardes indique le type de chacune : Manuelle, Planifiée, Avant mise à jour, Avant restauration.
  • La restauration n'est possible que lorsque le serveur est arrêté. L'état actuel est sauvegardé une fois de plus avant la restauration ; même une sauvegarde choisie par erreur peut donc être annulée.
  • Les sauvegardes manuelles sont exclues du nettoyage automatique. Les autres (planifiées, avant mise à jour, avant restauration) sont conservées jusqu'au nombre Sauvegardes planifiées à conserver (10 par défaut), en supprimant d'abord les plus anciennes.
  • Les fichiers de sauvegarde sont stockés dans le dossier du serveur (de l'instance). Supprimer le serveur supprime aussi ses sauvegardes ; copiez donc ailleurs les sauvegardes importantes.

4.2 Tâches planifiées

Utilisez Ajouter une tâche pour exécuter automatiquement les actions suivantes à intervalle fixe (toutes les N minutes) ou à une heure donnée chaque jour (HH:MM, dans le fuseau horaire du PC).

TâcheCe qu'elle fait
SauvegardeSauvegarde pendant que le serveur tourne
RedémarrageRedémarre le serveur s'il tourne
AnnonceEnvoie un message en jeu si le serveur tourne
Mise à jourVérifie s'il existe une mise à jour du serveur de jeu et l'applique le cas échéant (redémarre le serveur s'il tournait)
  • Les tâches de redémarrage et de mise à jour peuvent prévenir les joueurs en jeu à l'avance (p. ex. 10, 5, 1 minutes avant). Les annonces et les avertissements ne sont disponibles que si le jeu prend en charge une commande d'annonce.
  • Au redémarrage du démon, les tâches à intervalle recommencent à compter à partir de ce moment. Les tâches dont l'heure est passée pendant que le démon était arrêté ne sont pas exécutées en rattrapage ensuite.

5. Permettre à vos amis de se connecter

Si vous avez mis en place le serveur de jeu mais que vos amis ne peuvent pas entrer, il s'agit presque toujours de l'un de ces trois cas.

5.1 Amis sur le même Wi-Fi (LAN)

Aucune configuration supplémentaire n'est nécessaire. Connectez-vous simplement avec l'IP privée du PC serveur (p. ex. 192.168.0.10) et le port.

5.2 Amis à l'extérieur : le routeur prend en charge la redirection de ports

La redirection de ports est un réglage du routeur qui transmet les connexions venant de l'extérieur au PC serveur.

  1. Dans la page d'administration de votre routeur, redirigez le port du jeu vers l'IP privée du PC serveur.
  2. Donnez à vos amis l'adresse <IP publique>:<port>. Vous pouvez trouver votre IP publique sur des sites comme whatismyip.com.
  3. Dans le Pare-feu Windows, autorisez le trafic entrant (les connexions venant de l'extérieur) sur ce port.

5.3 Amis à l'extérieur : redirection de ports impossible

La redirection de ports est souvent bloquée sur les réseaux d'école ou d'entreprise, derrière le CGNAT d'un FAI et sur les Wi-Fi invités. Même là, vous pouvez quand même démarrer et arrêter vos serveurs depuis Discord grâce au relais cloud.

  • Dans l'écran Discord de la GUI, utilisez Connecter un serveur Discord pour obtenir un code, puis saisissez-le avec la slash command /saba connect dans votre serveur Discord.
  • Ensuite, vos amis peuvent démarrer et arrêter les serveurs ou consulter leur état depuis Discord.
  • Voir Bot Discord & relais cloud pour le déroulement détaillé.

Le relais cloud ne transmet que les commandes de contrôle (démarrage/arrêt/état, etc.), pas le trafic du jeu. Si vos amis ne peuvent pas se connecter directement au serveur de jeu, une solution supplémentaire (p. ex. ZeroTier, Tailscale) peut aussi être nécessaire.


6. Utiliser le bot Discord : résumé en une page

Une fois le bot appairé, une grande partie de l'exploitation quotidienne peut se faire depuis Discord sans ouvrir la GUI. Les commandes par message prennent la forme <préfixe> <serveur> <commande>, et le préfixe par défaut est Saba-chan (modifiable dans les paramètres du bot). Pour <serveur>, utilisez le nom du serveur ou le nom du jeu (alias).

SituationCe que vous tapez dans Discord (préfixe par défaut)
« On lance MC aujourd'hui »Saba-chan minecraft start
« Le serveur est-il en ligne ? »Saba-chan minecraft status
« On l'éteint »Saba-chan minecraft stop
« Quels serveurs y a-t-il ? »Saba-chan list
« Que puis-je taper ? »Saba-chan help

Chaque serveur reçoit aussi sa propre slash command /<nom du serveur>. La liste complète des commandes et la façon d'enregistrer des alias sont décrites dans Commandes.

Pour la configuration, l'appairage et le fonctionnement du relais du bot lui-même, voir Bot Discord & relais cloud.


7. Mises à jour et nettoyage

7.1 Mettre à jour Saba-chan

  • Saba-chan consulte périodiquement une liste de versions signées et affiche une notification Mises à jour disponibles dans la GUI lorsqu'une nouvelle version est publiée.
  • Dans Paramètres → Saba Storage, l'onglet Composants permet de télécharger et d'appliquer les mises à jour par composant (cœur, modules, extensions, etc.). Pour les composants dont les fichiers en cours d'exécution doivent être remplacés, comme le cœur, l'installateur (saba-chan-installer) arrête brièvement le démon, remplace les fichiers, puis ne relance que ce qui a changé. Si seul le démon a changé, la fenêtre de l'application reste ouverte et seul le démon est relancé.
  • Comme le démon redémarre, appliquez les mises à jour quand personne ne joue.

7.2 Mettre à jour un serveur de jeu

  • Lorsqu'une nouvelle version du serveur de jeu est disponible, un bouton Mettre à jour apparaît dans l'écran du serveur. Elle peut être appliquée lorsque le serveur est arrêté.
  • Une sauvegarde Avant mise à jour est d'abord créée automatiquement (pour les jeux qui prennent en charge les sauvegardes).
  • Vous pouvez aussi appliquer les mises à jour automatiquement à une heure donnée avec la tâche planifiée Mise à jour (§4.2).

7.3 Supprimer un serveur

  • Supprimez-le avec Supprimer le serveur dans l'onglet Infos. Un serveur ne peut être supprimé qu'une fois arrêté.
  • Pour les serveurs que Saba-chan a téléchargés et créés, le dossier du serveur (y compris les fichiers du serveur de jeu et les sauvegardes) est entièrement supprimé. Copiez d'abord les mondes ou sauvegardes dont vous avez besoin.
  • Pour les serveurs liés avec Migration d'un serveur existant, les fichiers du jeu dans le dossier d'origine sont laissés en place.

7.4 Désinstaller Saba-chan

  • Désinstallez Saba-chan depuis Paramètres → Applications → Applications installées de Windows.
  • Le programme de désinstallation arrête d'abord proprement les serveurs en cours d'exécution, puis supprime le dossier d'installation, le dossier de données (%APPDATA%\saba-chan\) et les raccourcis. Les fichiers et sauvegardes des serveurs créés par Saba-chan se trouvent aussi par défaut dans ce dossier de données ; copiez donc les mondes que vous voulez garder avant de désinstaller. Si vous cochez Keep game servers, les fichiers des serveurs, les mondes, les sauvegardes et les réglages propres à chaque serveur sont conservés ; si vous cochez Keep settings, les réglages de l'application et la connexion Discord le sont, et une réinstallation les reprend tels quels. Si une autre installation de Saba-chan utilise encore le dossier de données, il est laissé en place.

8. En cas de problème

  • Si des lignes rouges apparaissent dans la console, commencez par rechercher ce message exact. Saba-chan affiche la sortie du serveur de jeu sans la modifier.
  • Vérifier le serveur et Diagnostiquer le journal dans l'onglet Infos recherchent des problèmes de configuration et des erreurs connues dans les logs récents.
  • Si cela ne suffit pas, la page Dépannage rassemble les scénarios courants et leur résolution.
  • Si vous rencontrez un nouveau problème, signalez-le sur GitHub Issues avec la sortie de la console. Les logs de la GUI sont stockés dans %APPDATA%\saba-chan\logs\, et vous pouvez ouvrir ce dossier avec Ouvrir le dossier des journaux dans la fenêtre qui apparaît lorsque vous cliquez sur l'état du démon en haut. Joindre ces fichiers accélère grandement le diagnostic.