Ce guide explique comment configurer votre serveur dédié Portal Knights sur Legion Hosting, paramétrer les variables de démarrage, ajuster les paramètres du serveur, vous connecter avec des amis et gérer vos sauvegardes de monde. Pour les contrôles d'administration et la gestion des joueurs, consultez les Commandes d'administration Portal Knights.

1. Premier démarrage

1. Connectez-vous à GPanel et sélectionnez votre serveur Portal Knights.
2. Allez dans l'onglet Startup et examinez les variables disponibles (voir le tableau ci-dessous).
3. Définissez un SERVER_NAME pour identifier votre serveur dans le navigateur.
4. Changez le ADMIN_PASS par défaut. Définissez éventuellement USER_PASS ou GUEST_PASS pour restreindre l'accès à votre groupe.
5. Retournez dans l'onglet Console et cliquez sur Start.
6. Attendez que la console indique que le serveur a fini de charger. Le premier démarrage génère les fichiers de configuration par défaut et un nouveau monde.

2. Variables de démarrage GPanel

Les variables suivantes sont disponibles dans l'onglet Startup de GPanel. Ces valeurs sont appliquées à chaque démarrage du serveur.

3. Configuration du serveur

Au-delà des variables de démarrage, Portal Knights permet un réglage fin via son fichier de configuration serveur. Arrêtez votre serveur avant d'effectuer des modifications.

Emplacement du fichier de configuration

dedicated_server/server_config.json

Ouvrez ce fichier en utilisant l'onglet Files dans GPanel ou connectez-vous via SFTP. Si le fichier n'existe pas, démarrez et arrêtez le serveur une fois pour le générer avec les valeurs par défaut.

Paramètres clés

Le fichier de configuration utilise le format JSON. Les propriétés principales incluent :

Exemple de configuration

{
  "basicServerData": {
    "name": "My Portal Knights Server",
    "ipv4": "0.0.0.0",
    "port": 27015,
    "saveFolderPath": "./savedata"
  },
  "admins": {
    "credentials": {
      "password": "my_admin_password"
    }
  },
  "users": {
    "credentials": {
      "password": ""
    }
  },
  "guests": {
    "credentials": {
      "password": ""
    }
  },
  "gameplayMode": "Adventure",
  "universeSize": "Normal",
  "hideConsoleWindow": true
}

4. Paramètres du monde

Les mondes de Portal Knights sont composés d'îles générées de manière procédurale reliées par des portails. Points importants concernant le monde :

• Dossier de sauvegarde : Les données du monde sont stockées dans le répertoire savedata (configuré via basicServerData.saveFolderPath dans la configuration).
• Mode de jeu : Défini via la variable de démarrage GAMEMODE. Adventure est l'expérience RPG standard ; Creative permet la construction libre et l'exploration.
• Taille de l'univers : Définie via la variable de démarrage UNIVERSE_SIZE. Contrôle le nombre d'îles : Small, Normal, ou Large.
• Progression des îles : Les joueurs progressent à travers les îles en collectant des fragments de portail et en activant des portails. Le serveur enregistre toutes les îles découvertes et leurs états.

5. Comment se connecter

Option A -- Navigateur de serveurs en jeu

1. Lancez Portal Knights via Steam.
2. Depuis le menu principal, sélectionnez Multijoueur.
3. Choisissez Partie en ligne puis Parcourir les serveurs.
4. Recherchez votre serveur par nom ou parcourez la liste.
5. Sélectionnez votre serveur et cliquez sur Rejoindre. Entrez le mot de passe si demandé.

Option B -- Connexion directe par IP

1. Lancez Portal Knights via Steam.
2. Depuis le menu principal, sélectionnez Multijoueur.
3. Choisissez Partie en ligne puis Connexion directe.
4. Entrez l'IP et le port de votre serveur depuis l'onglet Network de GPanel :

   <your-server-ip>:<port>

5. Entrez le mot de passe du serveur si un mot de passe est défini.

6. Gestion des sauvegardes

Emplacement des fichiers de sauvegarde

Les sauvegardes de monde sont stockées sur le serveur à :

dedicated_server/savedata/

Ce chemin est configuré via le paramètre basicServerData.saveFolderPath dans server_config.json.

Sauvegardes manuelles via SFTP

1. Arrêtez le serveur depuis GPanel pour vous assurer que toutes les données sont écrites sur le disque.
2. Connectez-vous à votre serveur via SFTP. Voir Comment transférer des fichiers via SFTP pour les instructions.
3. Naviguez vers le répertoire dedicated_server/savedata/.
4. Téléchargez le dossier du monde entier que vous souhaitez sauvegarder.

Restaurer une sauvegarde

1. Arrêtez le serveur depuis GPanel.
2. Connectez-vous via SFTP et naviguez vers dedicated_server/savedata/.
3. Téléversez votre dossier de monde sauvegardé, en remplaçant celui existant si nécessaire.
4. Assurez-vous que le nom du dossier correspond au paramètre world_name dans votre configuration.
5. Démarrez le serveur depuis GPanel.

Dépannage

• Le serveur n'apparaît pas dans le navigateur : Confirmez que le serveur est entièrement démarré dans GPanel. Le navigateur de serveurs peut prendre 2 à 3 minutes pour indexer un nouveau serveur. Essayez la connexion directe par IP en attendant.
• Impossible de se connecter : Vérifiez l'IP et le port de votre serveur dans l'onglet Network de GPanel. Assurez-vous que le serveur est en cours d'exécution et n'est pas en état de plantage.
• Plantages au démarrage : Supprimez le fichier de configuration et redémarrez pour régénérer les valeurs par défaut. Si le problème persiste, vérifiez la console GPanel pour les messages d'erreur.
• Le monde ne se charge pas : Assurez-vous que le paramètre basicServerData.saveFolderPath dans server_config.json pointe vers le bon répertoire.

Articles connexes

• Commandes d'administration Portal Knights
• Comment trouver l'IP et le port de votre serveur
• Comment transférer des fichiers via SFTP
• Guide de démarrage du serveur

Besoin d'aide ?

Si vous rencontrez des problèmes non couverts ici, ouvrez un ticket de support en incluant l'IP de votre serveur, une description du problème et tout message d'erreur de la console GPanel.