Comment installer des mods sur un serveur ARK ? Guide CurseForge et Workshop
Dans ce guide, vous apprendrez à installer des mods (extensions qui ajoutent du contenu au jeu ou modifient le gameplay) sur votre serveur ARK. Les mods d'ARK : Survival Ascended (ASA) proviennent de CurseForge, ceux d'ARK : Survival Evolved (ASE) du Steam Workshop ; la méthode et les noms des réglages diffèrent entre les deux jeux. Vous verrez étape par étape comment trouver l'identifiant d'un mod, l'ajouter au serveur, gérer l'ordre des mods, la compatibilité côté joueurs et les mods payants (premium), les mettre à jour et retirer un mod sans endommager la sauvegarde du monde.
Les étapes ASA concernent Windows ; les étapes ASE sont données séparément pour Windows et pour Linux. Pour les autres sujets ARK, consultez la page Guides serveur ARK.
Avant de commencer
- Un serveur fonctionnel : ce guide explique comment ajouter des mods à un serveur déjà installé. Pour l'installation avec SteamCMD, l'ouverture des ports et le fichier de lancement, suivez d'abord le guide d'installation d'un serveur ARK. Le dossier
C:\arkserver, le fichierstart.batet l'unité systemdark-dedicatedsous Linux utilisés dans les exemples sont les mêmes que dans ce guide d'installation. - Le bon jeu : un serveur ASA utilise les mods CurseForge, un serveur ASE les mods du Steam Workshop. Selon le wiki officiel d'ARK, ASA n'utilise plus les mods du Steam Workshop ; indiquer un identifiant Workshop sur un serveur ASA ne sert à rien. ASA ne dispose pas de fichiers serveur pour Linux.
- Sauvegarde : avant d'ajouter ou de retirer un mod, arrêtez le serveur et copiez le dossier
ShooterGame\Saved. La sauvegarde automatique n'est pas incluse dans les VDS ; les sauvegardes relèvent de votre responsabilité. - Marge de ressources : le wiki indique que la consommation de mémoire dépend des réglages du serveur et des mods installés, et que les mods et les mises à jour demandent de l'espace disque supplémentaire ; il ne donne aucune valeur sur ce que les mods ajoutent. Après avoir ajouté des mods, surveillez la RAM et le disque dans les graphiques d'utilisation en direct de l'Espace client. Si vous avez besoin de plus de mémoire, les options figurent sur la page Location de serveur ARK.
- Accès Internet sortant : le serveur télécharge lui-même les mods au démarrage : sous ASA, ceux de la liste
-mods; sous ASE, les mods du Workshop si l'option-automanagedmodsest présente. Si vous avez sur le VDS une règle de pare-feu qui restreint les connexions sortantes, tenez-en compte. - Maps de mod : les maps de mod (custom map), qui remplacent la map elle-même, demandent en plus de sélectionner la map dans la commande de lancement. Ce guide traite des mods qui ajoutent du contenu à la map ; pour une map de mod, consultez le guide des maps personnalisées ARK.
1. Rassembler les identifiants des mods
ASA (CurseForge) : trouvez le mod dans la section ARK : Survival Ascended de curseforge.com ou dans la liste des mods en jeu. Dans la section Details (détails) de la page du mod, notez les informations suivantes :
- Project ID (identifiant du projet) : c'est l'identifiant numérique que vous indiquerez au serveur. Le texte de la barre d'adresse (par exemple
super-spyglass-plus) n'est pas l'identifiant. - Plateforme : PC Only (PC uniquement) ou Cross-Platform (multiplateforme). Selon CurseForge, c'est le créateur qui choisit si le mod sera utilisable uniquement sur PC (Steam) ou sur toutes les plateformes, Xbox et PlayStation comprises.
- Statut payant : si la page indique que le mod est premium, les joueurs doivent l'acheter (étape 6).
Exemple : sur la page CurseForge du mod Super Spyglass Plus, le Project ID affiché est 929420 et la plateforme est Cross-Platform. Les pages des mods peuvent changer ; vérifiez de nouveau l'identifiant juste avant l'installation.
ASE (Steam Workshop) : dans l'adresse de la page Workshop du mod, le nombre qui suit id= est l'identifiant Workshop. Notez les identifiants dans un fichier texte, dans l'ordre de priorité de chargement souhaité ; cet ordre prendra de l'importance à l'étape 5.
2. ASA : ajouter les mods avec -mods (Windows)
Si le serveur est en marche, connectez-vous au jeu, obtenez les droits d'administrateur dans la console avec enablecheats MotDePasseAdmin, enregistrez le monde avec cheat saveworld et arrêtez le serveur avec cheat doexit. Ajoutez ensuite le paramètre -mods= au fichier start.bat :
@echo off
cd /d C:\arkserver\ShooterGame\Binaries\Win64
start "" ArkAscendedServer.exe TheIsland_WP?SessionName=HanArk_Mods?ServerAdminPassword=MotDePasseAdmin -port=7777 -WinLiveMaxPlayers=20 -mods=929420,ID_DEUXIEME_MOD -servergamelog
D'après le wiki, -mods= accepte les Project ID CurseForge, et les mods sont mis à jour automatiquement à chaque démarrage du serveur. Règles à respecter :
- Séparez les identifiants par des virgules, sans espace. La ligne de commande étant découpée aux espaces, les identifiants placés après un espace ne font pas partie du paramètre.
- Le serveur télécharge lui-même les mods depuis CurseForge au démarrage ; vous n'avez pas à installer les fichiers manuellement. Plus il y a de mods, plus le premier démarrage est long.
[ModInstaller]/ModIDS=,?GameModIds=et-automanagedmodsne fonctionnent que sous ASE, pour les mods du Steam Workshop. Le wiki présente la ligneActiveModscomme valable aussi sous ASA, mais précise qu'il n'est pas nécessaire de la définir sous ASA et qu'il faut utiliser-modsau lieu de?GameModIds=. Sous ASA, indiquez la liste des mods uniquement avec-mods=.
Une fois le serveur démarré, vérifiez dans le fichier log (journal) le plus récent du dossier ShooterGame\Saved\Logs s'il y a une erreur de téléchargement ou de chargement de mod.
3. ASE : installer les mods du Workshop (Windows)
Sous ASE, l'installation des mods comporte trois éléments : la liste de téléchargement, la liste des mods actifs et l'option de lancement qui active la gestion automatique des mods. Enregistrez et arrêtez le serveur comme à l'étape 2 ; les fichiers ini se trouvent dans le dossier ShooterGame\Saved\Config\WindowsServer.
a) Liste de téléchargement : ajoutez la section [ModInstaller] au fichier Game.ini. D'après le wiki, on écrit une ligne ModIDS= distincte pour chaque mod, sur le même modèle, et cette section ne fonctionne pas sans -automanagedmods. La note de patch 244.3 de Wildcard décrit ces lignes comme des éléments de téléchargement supplémentaires (extra) ; pour suivre la méthode du wiki, indiquez chaque identifiant à la fois ici et dans la partie b) :
[ModInstaller]
ModIDS=ID_WORKSHOP_1
ModIDS=ID_WORKSHOP_2
b) Liste des mods actifs : ModIDS ne fait que télécharger ; pour que le mod fonctionne en jeu, il faut la ligne ActiveMods dans la section [ServerSettings] du fichier GameUserSettings.ini. Les identifiants tiennent sur une seule ligne, séparés par des virgules sans espace :
[ServerSettings]
ActiveMods=ID_WORKSHOP_1,ID_WORKSHOP_2
c) Lancement : ajoutez l'option -automanagedmods à la fin du fichier start.bat. Cette option télécharge, installe et met à jour les mods avant le démarrage du serveur :
@echo off
cd /d C:\arkserver\ShooterGame\Binaries\Win64
start "" ShooterGameServer.exe TheIsland?SessionName=HanArk_Mods?Port=7777?QueryPort=27015?MaxPlayers=20?ServerAdminPassword=MotDePasseAdmin -automanagedmods
Selon des sources communautaires, les mods ASE téléchargés sont placés dans le dossier ShooterGame\Content\Mods, sous la forme d'un dossier nommé d'après leur numéro d'identifiant et d'un fichier .mod portant le même numéro. Ce chemin n'est pas documenté dans le wiki officiel ; pour vérifier, le fichier log est une source plus fiable.
4. ASE : installer les mods du Workshop (Linux)
Sous Linux, les fichiers ini se trouvent dans le dossier ShooterGame/Saved/Config/LinuxServer ; les lignes de Game.ini et de GameUserSettings.ini sont les mêmes qu'à l'étape 3. Avant d'utiliser la gestion automatique des mods pour la première fois, une préparation est nécessaire : d'après la note de patch 244.3 de Wildcard, sur les serveurs Linux, le script SteamCMDInstall.sh fourni avec les fichiers du serveur doit être exécuté une fois pour installer SteamCMD. Trouvez le script et exécutez-le avec l'utilisateur steam :
sudo -iu steam
find /home/steam/servers/ark -name SteamCMDInstall.sh
cd /dossier/trouve
bash SteamCMDInstall.sh
exit
Ouvrez ensuite l'unité systemd et ajoutez -automanagedmods à la fin de la ligne ExecStart :
sudo nano /etc/systemd/system/ark-dedicated.service
ExecStart=/home/steam/servers/ark/ShooterGame/Binaries/Linux/ShooterGameServer TheIsland?SessionName=HanArk_Mods?Port=7777?QueryPort=27015?MaxPlayers=20?ServerAdminPassword=MotDePasseAdmin -automanagedmods
L'unité doit contenir une ligne WorkingDirectory ; d'après le wiki officiel, sans cette ligne, -automanagedmods ne peut pas télécharger les mods. L'unité du guide d'installation contient déjà cette ligne. Rechargez la configuration et redémarrez le serveur :
sudo systemctl daemon-reload
sudo systemctl restart ark-dedicated
sudo systemctl status ark-dedicated
5. Régler l'ordre et les paramètres des mods
Ordre sous ASE : d'après le wiki, ActiveMods détermine quels mods sont chargés et dans quel ordre, la priorité décroissant de gauche à droite : l'identifiant le plus à gauche a la priorité la plus élevée. Si deux mods modifient le même objet ou la même créature, placez plus à gauche le mod qui doit l'emporter. Il est aussi possible de fournir la même liste dans la ligne de commande avec ?GameModIds=, mais le wiki ne le recommande pas ; gardez la liste à un seul endroit.
Ordre sous ASA : le wiki ne définit aucune règle de priorité pour -mods. Si la page d'un mod donne des instructions sur l'ordre de chargement (par exemple, un mod d'extension qui doit venir après le mod principal), suivez-les.
Paramètres des mods : de nombreux mods lisent leurs propres paramètres dans une section distincte du fichier ini. Par exemple, la page de Super Spyglass Plus fournit la section [SuperSpyglassPlus] à ajouter au fichier GameUserSettings.ini. Écrivez ces lignes dans le fichier et la section indiqués par le créateur, serveur arrêté. Pour les multiplicateurs et les réglages du jeu lui-même, consultez le guide des réglages du serveur ARK.
6. Préparer le côté joueurs : compatibilité, plateforme et mods premium
- Téléchargement des mods par les joueurs sous ASA : d'après l'article de CurseForge sur l'installation des mods ASA, lorsqu'un joueur rejoint un serveur moddé, le jeu liste les mods requis ; quand il choisit Join (rejoindre), les mods qui lui manquent sont installés. Les joueurs ne sont pas obligés d'installer les mods un par un à l'avance.
- Plateforme sous ASA : si la liste contient un mod PC Only, les joueurs Xbox et PlayStation ne peuvent pas utiliser ce mod. Dans une communauté mixte, assurez-vous que chaque mod de la liste est Cross-Platform. Pour les réglages multiplateformes, consultez le guide des ports et du crossplay ARK.
- Mods premium (ASA uniquement) : d'après l'explication de CurseForge sur les mods premium, le joueur achète le mod soit depuis la page du mod, soit en rejoignant un serveur qui l'utilise ; après l'achat, il peut l'utiliser en solo et sur les serveurs qui l'utilisent. L'achat d'une plateforme à l'autre n'est pas pris en charge : un mod acheté sur PC n'est pas valable sur console, et un mod acheté sur console ne l'est pas sur PC. Si vous ajoutez un mod premium à votre serveur, chaque joueur doit l'acheter sur sa propre plateforme ; annoncez-le à l'avance à votre communauté.
- Client sous ASE : les mods du Workshop parviennent aux joueurs via Steam. Les étapes de téléchargement côté joueur ne sont pas détaillées dans le wiki officiel ; une méthode sûre consiste à ce que les joueurs s'abonnent aux mods du serveur depuis leurs pages Workshop (« S'abonner ») avant de se connecter. Communiquez à votre communauté la liste des mods avec leurs identifiants.
7. Redémarrer le serveur après une mise à jour de mod
Le serveur ne met à jour les mods qu'au démarrage : sous ASA, les mods de la liste -mods sont mis à jour à chaque démarrage ; sous ASE, ils le sont avec -automanagedmods avant le démarrage du serveur. Tant qu'il reste allumé, le serveur fonctionne avec l'ancienne version du mod. Lorsqu'un mod est mis à jour :
- Prévenez les joueurs d'une courte maintenance.
- Enregistrez le monde avec
cheat saveworld, puis arrêtez le serveur aveccheat doexit. - S'il s'agit d'une mise à jour importante du mod, sauvegardez le dossier
ShooterGame\Saved. - Redémarrez le serveur (
start.batsous Windows,sudo systemctl restart ark-dedicatedsous Linux) et vérifiez dans le fichier log qu'il n'y a pas d'erreur.
Si le jeu lui-même a été mis à jour, vous devez aussi mettre à jour les fichiers du serveur avec SteamCMD ; les étapes se trouvent dans la section consacrée à la mise à jour du guide d'installation.
8. Retirer un mod et protéger la sauvegarde du monde
Retirer un mod de la liste signifie que les objets, les structures et les créatures ajoutés par ce mod ne peuvent plus être chargés dans le monde. Enregistrez donc d'abord le serveur, arrêtez-le et sauvegardez le dossier ShooterGame\Saved ; cette copie est le seul moyen fiable de revenir en arrière. Pour le transfert de sauvegardes et les sauvegardes planifiées, consultez le guide de sauvegarde ARK.
ASE : supprimez l'identifiant du mod de la ligne ActiveMods et de la ligne ModIDS= de la section [ModInstaller], puis démarrez le serveur.
ASA : supprimez l'identifiant de la liste -mods=. Si vous voulez désactiver les fonctions du mod tout en conservant ses données, il existe l'option -passivemods=. Le wiki la décrit ainsi : elle « désactive les fonctions du mod mais continue de charger ses données ». Wildcard a également recommandé cette méthode lors du retrait d'un mod d'événement, pour que les objets de l'événement ne disparaissent pas, en donnant ce modèle : l'identifiant du mod passif figure aussi au début de la liste -mods. Le wiki note en revanche que le mod passif n'a pas besoin de figurer dans la liste normale des mods et que le mod de la liste -passivemods est lui aussi téléchargé ; l'exemple ci-dessous reprend le modèle de Wildcard.
-mods=ID_MOD_PASSIF,ID_AUTRE_MOD -passivemods=ID_MOD_PASSIF
Tableau des paramètres de mods
| Paramètre / réglage | Jeu | Où l'écrire | Rôle |
|---|---|---|---|
-mods=ID1,ID2 | ASA | Commande de lancement | Charge les mods CurseForge ; les met à jour à chaque démarrage |
-passivemods=ID | ASA | Commande de lancement | Charge les données du mod, désactive ses fonctions |
-automanagedmods | ASE | Commande de lancement | Télécharge, installe et met à jour les mods du Workshop |
ModIDS=ID | ASE | Game.ini, [ModInstaller] | Une ligne par mod à télécharger ; nécessite -automanagedmods |
ActiveMods=ID1,ID2 | ASE (inutile sous ASA) | GameUserSettings.ini, [ServerSettings] | Mods actifs et priorité ; le plus à gauche est prioritaire |
?GameModIds= | ASE | Commande de lancement | Même rôle qu'ActiveMods ; déconseillé par le wiki, non utilisé sous ASA |
-MapModID= | ASE | Commande de lancement | Charge une map de mod par son identifiant Workshop ; expliqué dans le guide des maps personnalisées |
Les définitions du tableau proviennent de la page de configuration du serveur du wiki ARK.
Erreurs fréquentes
- Sous ASA, le mod ne se charge pas du tout : la cause est le plus souvent un mauvais identifiant, par exemple le nom de la barre d'adresse ou un identifiant Workshop indiqué à la place du Project ID. Si la liste contient un espace, les identifiants placés après l'espace ne sont pas lus. Reprenez l'identifiant dans la section Details de la page CurseForge, écrivez la liste sans espace et vérifiez le fichier log.
- Sous ASE, le mod ne se télécharge pas : l'option
-automanagedmodsmanque, la section[ModInstaller]a été écrite dans un autre fichier queGame.ini, ou bien, sous Linux,SteamCMDInstall.shn'a pas été exécuté ou l'unité systemd ne contient pas de ligneWorkingDirectory. Vérifiez les étapes 3 et 4 dans l'ordre. - Sous ASE, le mod est téléchargé mais absent du jeu : l'identifiant ne figure que dans la ligne
ModIDS. Pour activer le mod, ajoutez aussi le même identifiant à la ligneActiveMods. - Une modification du fichier ini est annulée : le fichier a été modifié pendant que le serveur tournait. Enregistrez et arrêtez le serveur, puis modifiez de nouveau le fichier.
- Un achat est demandé au joueur quand il rejoint le serveur : l'un des mods de la liste est premium. Le joueur doit acheter le mod sur sa propre plateforme ; si vous ne le souhaitez pas, retirez le mod de la liste ou choisissez une alternative gratuite.
- Les joueurs sur console ne peuvent pas utiliser le mod : la liste contient un mod PC Only, ou le serveur a été lancé de façon à n'accepter que le PC. Vérifiez le champ plateforme du mod ; pour les réglages de plateforme, consultez le guide du crossplay.
- Le mod a été mis à jour et les problèmes ont commencé : le serveur ne télécharge la nouvelle version qu'au démarrage. Redémarrez le serveur en suivant l'ordre de l'étape 7 ; si le problème persiste, consultez les notes de modification sur la page du mod.
- Des objets ou des créatures ont disparu après le retrait d'un mod : le contenu du mod retiré ne peut pas être chargé dans le monde. La solution la plus sûre consiste à arrêter le serveur et à restaurer la sauvegarde faite avant le retrait ; sous ASA, envisagez la méthode
-passivemodsla prochaine fois.
Questions fréquentes
Puis-je ajouter à un serveur ASA un mod du Workshop que j'utilisais sous ASE ?
Pas directement. ASA n'utilise pas les mods du Steam Workshop ; si une version du mod pour ASA est publiée sur CurseForge, vous indiquez son Project ID dans la liste -mods=. Les identifiants des deux versions sont différents.
Combien de mods puis-je installer sur le serveur ?
Le wiki d'ARK n'indique aucune limite au nombre de mods. En pratique, la limite dépend de la mémoire, du disque et du temps de démarrage ; après chaque mod, consultez les graphiques d'utilisation en direct de l'Espace client. Si la RAM est en permanence au maximum, réduisez le nombre de mods ou passez à une offre disposant de plus de mémoire.
La liste des mods doit-elle être identique sur les serveurs d'un cluster ?
Si une créature ou un objet issu d'un mod doit être transféré d'une map à l'autre, le serveur de destination doit lui aussi charger les données de ce mod. Le wiki donne justement cet exemple pour l'option -passivemods : dans un cluster, utiliser le mod S-Dinos de façon active sur le serveur Astraeos et le charger en mode passif sur le serveur The Island. Ainsi, les créatures de ce mod n'apparaissent pas sur The Island mais peuvent être transférées entre les deux maps. Pour la mise en place d'un cluster, consultez le guide du cluster ARK.
Guides associés
- Comment installer un serveur ARK : guide SteamCMD pour ASA et ASE
- Comment installer une map personnalisée (custom map) sur ARK ? Guide ASA et ASE
- Réglages et multiplicateurs d'un serveur ARK : GameUserSettings.ini et Game.ini
- Comment créer un cluster ARK ? Transférer personnages et dinos entre les maps
- Comment sauvegarder un serveur ARK ? Transférer une partie solo vers le serveur
Commentaires0
Pas encore de commentaire
Soyez le premier à partager votre avis.
Veuillez vous connecter ou vous inscrire pour laisser un commentaire.