Guide de configuration du serveur Starbound

Ce guide couvre la mise en place et la configuration de votre serveur dédié Starbound sur Legion Hosting, y compris les prérequis d'authentification Steam, le premier démarrage, la configuration du serveur, les paramètres de l'univers, la connexion des joueurs et la gestion des sauvegardes. Pour l'installation de mods, consultez Installation de mods Starbound. Pour les commandes admin et les privilèges, consultez Commandes admin Starbound.

Prérequis

Avant de démarrer votre serveur Starbound, vous devez disposer des éléments suivants :

• Un compte Steam possédant Starbound. Le binaire du serveur n'est pas disponible en téléchargement anonyme -- le compte que vous fournissez doit avoir Starbound dans sa bibliothèque.
• Considérations Steam Guard. Si votre compte Steam a Steam Guard (authentification à deux facteurs) activé, vous devrez fournir le code d'authentification via la variable de démarrage STEAM_AUTH lors de la première installation. Après l'authentification initiale, SteamCMD met en cache la session et les démarrages suivants ne devraient pas nécessiter le code à nouveau, sauf si le cache expire.
• Compte Steam dédié recommandé. Pour des raisons de sécurité, envisagez d'utiliser un compte Steam séparé possédant Starbound uniquement pour l'hébergement du serveur. Cela évite de partager les identifiants de votre compte principal et prévient les conflits si vous souhaitez jouer sur le même compte simultanément.

Premier démarrage

Après avoir acheté votre serveur Starbound chez Legion Hosting, suivez ces étapes pour le lancer pour la première fois :

1. Connectez-vous à GPanel et sélectionnez votre serveur Starbound.
2. Allez dans l'onglet Startup.
3. Remplissez les identifiants Steam requis :
   • STEAM_USER -- Le nom d'utilisateur de votre compte Steam (requis).
   • STEAM_PASS -- Le mot de passe de votre compte Steam (requis).
   • STEAM_AUTH -- Votre code 2FA Steam Guard, si demandé (optionnel, nécessaire uniquement lors de la première installation ou lorsque la session en cache expire).
4. Allez dans l'onglet Console et cliquez sur Start.
5. Le serveur téléchargera les fichiers du serveur dédié Starbound via SteamCMD. Cela peut prendre plusieurs minutes lors du premier lancement.
6. Une fois le téléchargement terminé, le serveur générera un univers par défaut et commencera à écouter les connexions.

Variables de démarrage GPanel

starbound_server.config

Le fichier de configuration principal du serveur se trouve à :

storage/starbound_server.config

Ce fichier utilise le format JSON. Modifiez-le via le gestionnaire de fichiers dans GPanel ou par SFTP. Le serveur doit être arrêté avant toute modification, car les changements sont chargés au démarrage.

Paramètres clés du serveur

Exemple de starbound_server.config

{
  "serverName" : "My Legion Starbound Server",
  "maxPlayers" : 8,
  "gameServerBind" : "::",
  "serverPassword" : "",
  "allowAnonymousConnections" : true,
  "allowAssetsMismatch" : true,
  "maxTeamSize" : 4,
  "clientIPJoinable" : true,
  "clientP2PJoinable" : false,
  "allowAdminCommands" : true,
  "allowAdminCommandsFromAnyone" : false,
  "serverUsers" : {
    "YourUsername" : {
      "admin" : true,
      "password" : "your-admin-password"
    }
  }
}

Paramètres du monde et de l'univers

Starbound utilise un univers généré de manière procédurale. Chaque fois qu'un joueur visite un nouveau système stellaire ou une planète, le jeu le génère en se basant sur une graine d'univers et un système de coordonnées. Les données de l'univers du serveur sont stockées dans :

storage/universe/

Ce répertoire contient toutes les données de monde générées, y compris les planètes, les stations spatiales et les structures construites par les joueurs dans le monde.

Configuration de l'univers

Les paramètres de génération de l'univers peuvent être ajustés dans le fichier starbound_server.config ou via les fichiers d'assets liés à l'univers. Concepts clés :

Comment se connecter

Les joueurs se connectent à votre serveur Starbound via le menu multijoueur en jeu.

Connexion directe par IP

1. Lancez Starbound.
2. Depuis le menu principal, cliquez sur Multiplayer.
3. Sélectionnez votre personnage.
4. Dans le champ Server Address, entrez l'adresse IP et le port de votre serveur au format : IP:Port
5. Si le serveur a un mot de passe défini, entrez le nom de compte et le mot de passe correspondant à une entrée serverUsers dans la configuration du serveur. Si allowAnonymousConnections est défini sur true et qu'aucun mot de passe de serveur n'est défini, ces champs peuvent être laissés vides.
6. Cliquez sur Join Server.

Amis Steam (non applicable)

La fonctionnalité « Rejoindre la partie » de Steam est destinée aux parties hébergées en peer-to-peer, pas aux serveurs dédiés. Les joueurs doivent utiliser la méthode de connexion directe par IP décrite ci-dessus pour rejoindre votre serveur Legion Hosting.

Gestion des sauvegardes

Starbound stocke toutes les données du serveur dans le répertoire storage/. Comprendre la structure des fichiers aide pour les sauvegardes, les transferts et le dépannage.

Répertoires et fichiers de stockage clés

Créer des sauvegardes

Des sauvegardes régulières protègent l'univers, les données des joueurs et la configuration de votre serveur contre la perte ou la corruption accidentelle.

1. Arrêtez votre serveur dans GPanel pour vous assurer que toutes les données sont écrites sur le disque.
2. Connectez-vous à votre serveur via SFTP ou utilisez le gestionnaire de fichiers.
3. Téléchargez l'intégralité du répertoire storage/ sur votre ordinateur local.
4. Stockez la sauvegarde dans un emplacement sûr avec une étiquette de date (par ex., storage-backup-2026-02-26).

Restaurer à partir d'une sauvegarde

1. Arrêtez votre serveur.
2. Téléversez vos fichiers de sauvegarde aux emplacements correspondants dans le répertoire storage/, en écrasant les fichiers existants.
3. Démarrez le serveur.

Transférer un monde depuis un autre serveur

Pour déplacer votre univers Starbound depuis un autre serveur ou une partie locale :

1. Arrêtez les serveurs source et destination.
2. Copiez le répertoire storage/universe/ de la source vers le serveur de destination.
3. Optionnellement, copiez storage/player/ si vous souhaitez transférer également les données des joueurs.
4. Copiez votre starbound_server.config pour préserver les paramètres du serveur.
5. Démarrez le serveur de destination et vérifiez que le monde se charge correctement.

Articles connexes

• Installation de mods Starbound
• Commandes admin Starbound
• Comment trouver l'IP et le port de votre serveur
• Comment téléverser des fichiers via SFTP
• Guide de démarrage du serveur

Besoin d'aide ?

Si vous rencontrez des problèmes non couverts par ce guide, notre équipe de support est disponible pour vous aider. Ouvrez un ticket à legionhosting.net/submitticket.php avec les détails de votre serveur et une description du problème.