Ce guide explique comment configurer les fichiers GameUserSettings.ini et Game.ini pour votre serveur ARK: Survival Ascended hébergé chez Legion Hosting.
Arrêtez votre serveur avant de modifier les fichiers de configuration. Arrêtez toujours votre serveur depuis l'onglet Console du GPanel avant de modifier les fichiers
.ini. ARK peut écraser les fichiers lors de l'arrêt, donc les modifications effectuées pendant que le serveur est en cours d'exécution peuvent être perdues.
Aperçu des fichiers de configuration
ARK: Survival Ascended utilise deux fichiers de configuration principaux pour contrôler le comportement du serveur. Les deux se trouvent dans le répertoire ShooterGame/Saved/Config/WindowsServer/ de votre serveur.
| Fichier | Fonction |
|---|---|
GameUserSettings.ini |
Paramètres principaux du serveur — nom de session, mots de passe, nombre de joueurs, taux, crossplay, BattleEye, et plus encore. Ce fichier est créé lors du premier démarrage du serveur. |
Game.ini |
Personnalisations avancées du gameplay — points d'engramme, mise à l'échelle des statistiques, tailles de pile d'objets, apparitions de NPC personnalisées. Doit être exactement Game.ini (sensible à la casse). Créez-le manuellement s'il n'existe pas. |
Game.ini peut ne pas exister par défaut. Si le fichier n'est pas présent, créez-le manuellement dans l'éditeur de fichiers du GPanel. Le nom du fichier doit être exactement
Game.ini avec un G et un I majuscules — game.ini ou GAME.INI ne fonctionneront pas.
Étape 1 — Accéder au gestionnaire de fichiers dans GPanel
- Connectez-vous à GPanel.
- Sélectionnez votre serveur ARK: Survival Ascended dans la liste des serveurs.
- Si le serveur est en cours d'exécution, cliquez sur Stop dans l'onglet Console et attendez que le statut passe à Offline.
- Cliquez sur l'onglet Files pour ouvrir le gestionnaire de fichiers.
- Naviguez vers
ShooterGame/Saved/Config/WindowsServer/. Vous y trouverezGameUserSettings.iniune fois que le serveur aura démarré au moins une fois. SiGame.inin'est pas présent, vous le créerez manuellement à l'étape 3.
Étape 2 — Configurer GameUserSettings.ini
Cliquez sur GameUserSettings.ini dans le gestionnaire de fichiers pour l'ouvrir dans l'éditeur intégré. Le fichier est divisé en sections — les plus importantes pour la configuration du serveur sont [SessionSettings] et [ServerSettings].
Paramètres clés dans [SessionSettings]
| Paramètre | Valeur exemple | Description |
|---|---|---|
SessionName |
My Legion Server |
Le nom qui apparaît dans le navigateur de serveurs en jeu. Choisissez un nom unique pour que les joueurs puissent le trouver facilement. |
QueryPort |
7778 |
Le port de requête utilisé par le navigateur de serveurs. Doit correspondre au port attribué dans GPanel. Par défaut, il s'agit du port de jeu + 1. |
Paramètres clés dans [ServerSettings]
| Paramètre | Valeur exemple | Description |
|---|---|---|
ServerPassword |
mypassword |
Mot de passe requis pour que les joueurs puissent rejoindre le serveur. Laissez vide pour un serveur public. |
ServerAdminPassword |
adminpass123 |
Mot de passe administrateur utilisé pour authentifier les commandes d'administration en jeu. Gardez-le confidentiel. |
MaxPlayers |
20 |
Nombre maximum de joueurs simultanés. Doit correspondre à la limite de places de votre plan. |
XPMultiplier |
2.0 |
Multiplicateur d'XP gagnée. 1.0 est la valeur par défaut, 2.0 double le gain d'XP. |
TamingSpeedMultiplier |
3.0 |
Multiplicateur de vitesse d'apprivoisement. Des valeurs plus élevées accélèrent l'apprivoisement. |
HarvestAmountMultiplier |
2.0 |
Multiplicateur des ressources récoltées par action de récolte. |
DifficultyOffset |
1.0 |
Contrôle la distribution des niveaux des créatures. Réglez sur 1.0 pour les niveaux sauvages maximum avec des paramètres officiels. |
OverrideOfficialDifficulty |
5.0 |
Définit le niveau maximum des dinosaures sauvages lorsque DifficultyOffset=1.0. Une valeur de 5.0 permet des niveaux jusqu'à 150. |
AllowCrateSpawnsOnTopOfStructures |
True |
Permet aux largages de ravitaillement d'atterrir sur les structures des joueurs. Recommandé pour les serveurs PvE. |
EnablePvPGamma |
True |
Permet aux joueurs d'ajuster le gamma en PvP. Désactivez pour une expérience plus compétitive. |
Un exemple minimal d'une section configurée de GameUserSettings.ini :
[SessionSettings]
SessionName=My Legion Server
QueryPort=7778
[ServerSettings]
ServerPassword=
ServerAdminPassword=adminpass123
MaxPlayers=20
XPMultiplier=2.0
TamingSpeedMultiplier=3.0
HarvestAmountMultiplier=2.0
DifficultyOffset=1.0
OverrideOfficialDifficulty=5.0Étape 3 — Créer et configurer Game.ini
Création de Game.ini
Game.ini doit être créé manuellement par l'utilisateur s'il n'existe pas déjà. Naviguez vers ShooterGame/Saved/Config/WindowsServer/ dans le gestionnaire de fichiers du GPanel. Si Game.ini n'est pas listé, créez un nouveau fichier avec le nom exact Game.ini (G et I majuscules — game.ini ou GAME.INI ne fonctionneront pas).
Commencez le fichier avec l'en-tête suivant — tous les paramètres de Game.ini vont sous cette unique section :
[/script/shootergame.shootergamemode]Modification de Game.ini
Game.ini utilise un format basé sur des sections. La section la plus courante pour la personnalisation du serveur est [/script/shootergame.shootergamemode]. Les paramètres sont ajoutés un par ligne dans la section appropriée.
Personnalisations courantes de Game.ini :
[/script/shootergame.shootergamemode]
; Engram points per level (one entry per level, starting at level 1)
OverridePlayerLevelEngramPoints=8
OverridePlayerLevelEngramPoints=8
OverridePlayerLevelEngramPoints=8
; Increase max XP required per level (one entry per level)
LevelExperienceRampOverrides=(...)
; Custom harvest amounts per resource
ResourceItemReplacementClasses=(...)
; Disable specific engrams
EngramEntryAutoUnlocks=(EngramClassName="EngramEntry_TurretGun_Rocket_C",LevelToAutoUnlock=0)| Paramètre | Description |
|---|---|
OverridePlayerLevelEngramPoints=N |
Définit les points d'engramme accordés à chaque niveau. Ajoutez une ligne par niveau de joueur. Utilisez ceci pour accorder plus d'engrammes par montée de niveau. |
MaxCustomNodes=N |
Contrôle le nombre maximum de nœuds d'apparition personnalisés. Utile pour les configurations d'apparition moddées avancées. |
EngramEntryAutoUnlocks=(...) |
Force le déverrouillage automatique d'engrammes spécifiques à un niveau défini, utile pour donner à tous les joueurs l'accès à certains objets sans dépenser de points. |
ConfigOverrideItemMaxQuantity=(...) |
Remplace les tailles maximales de pile pour des objets spécifiques. |
Astuce : L'en-tête de section
[/script/shootergame.shootergamemode] ne doit être présent qu'une seule fois dans Game.ini. Si vous l'ajoutez une deuxième fois, seule la dernière occurrence sera utilisée. Ajoutez tous vos paramètres sous l'en-tête unique.
Configuration du port de requête
Le port de requête est distinct du port de jeu et est utilisé exclusivement par le navigateur de serveurs (Steam/Epic) pour lister votre serveur. Si le port de requête est incorrect ou inaccessible, votre serveur n'apparaîtra pas dans le navigateur même s'il fonctionne correctement.
| Port | Par défaut | Configuré dans | Fonction |
|---|---|---|---|
| Game Port | 7777 |
GPanel Startup / Network tab | Les joueurs se connectent via ce port pour rejoindre le serveur |
| Query Port | 7778 |
GameUserSettings.ini — QueryPort under [SessionSettings] |
Interrogation du navigateur de serveurs — doit correspondre au port alloué dans GPanel |
Le port de requête doit correspondre à GPanel. La valeur de
QueryPort dans GameUserSettings.ini doit correspondre exactement au port de requête affiché dans l'onglet Network de votre GPanel. Legion Hosting pré-attribue les deux ports lors de la création de votre serveur — vérifiez l'onglet Network pour connaître vos valeurs spécifiques avant de modifier le fichier .ini. Ne supposez pas que les valeurs par défaut 7777/7778 s'appliquent à votre serveur.
Appliquer les modifications
- Enregistrez votre fichier
.inimodifié en utilisant le bouton Save dans l'éditeur de fichiers du GPanel. - Retournez à l'onglet Console.
- Cliquez sur Start pour démarrer le serveur. GPanel chargera votre configuration mise à jour au démarrage.
- Surveillez la sortie de la console pour détecter d'éventuelles erreurs. Les erreurs de configuration telles que des valeurs invalides ou des en-têtes de section dupliqués produisent souvent des avertissements dans le journal de démarrage.
Modifiez toujours les fichiers de configuration lorsque le serveur est arrêté. Modifier
GameUserSettings.ini ou Game.ini pendant que le serveur est arrêté puis démarrer le serveur est suffisant. N'essayez pas de recharger les fichiers de configuration à chaud pendant que le serveur est en cours d'exécution — ARK ne prend pas en charge le rechargement en direct de la configuration pour la plupart des paramètres.
Dépannage
Game.ini n'existe pas ou les paramètres ne sont pas lus
Game.inin'est pas créé automatiquement. Si le fichier n'existe pas, créez-le manuellement dans l'éditeur de fichiers du GPanel dansShooterGame/Saved/Config/WindowsServer/.- Le nom du fichier est sensible à la casse. Il doit être exactement
Game.ini— pasgame.ini,GAME.INI, ou toute autre variante. - Assurez-vous que le fichier contient l'en-tête
[/script/shootergame.shootergamemode]comme première ligne, et que cet en-tête n'apparaît qu'une seule fois.
Les paramètres dans Game.ini ou GameUserSettings.ini ne sont pas appliqués
- Confirmez que le serveur était complètement arrêté avant de modifier le fichier. Si le serveur était en cours d'exécution, il peut avoir écrasé vos modifications lors de son prochain arrêt.
- Vérifiez que l'en-tête de section (par ex.
[ServerSettings]ou[/script/shootergame.shootergamemode]) n'apparaît qu'une seule fois dans le fichier. Les en-têtes de section dupliqués feront que les paramètres ultérieurs écraseront les précédents, ou seront entièrement ignorés selon l'analyseur. - Après avoir enregistré le fichier, redémarrez complètement le serveur depuis GPanel avant de tester.
- Vérifiez que le fichier se trouve dans le bon répertoire :
ShooterGame/Saved/Config/WindowsServer/. Les fichiers placés au mauvais emplacement sont ignorés silencieusement.
Le serveur n'apparaît pas dans le navigateur de serveurs après la configuration
- Confirmez que le
QueryPortdansGameUserSettings.inicorrespond exactement au port indiqué dans l'onglet Network du GPanel. - Le navigateur de serveurs peut mettre 5 à 10 minutes pour indexer un serveur nouvellement démarré ou reconfiguré. Essayez une connexion directe avec
open IP:GAMEPORTdans la console en jeu d'ASA pour vérifier que le serveur est accessible en attendant que le navigateur se mette à jour. - Si le crossplay est activé, les joueurs doivent décocher les filtres de verrouillage par plateforme dans le navigateur de serveurs. Consultez le guide de connexion pour plus de détails.
