ARK: Survival Ascended utilise CurseForge pour la distribution des mods au lieu du Steam Workshop. Ce guide couvre la recherche de mods, leur installation sur votre serveur, la gestion de l'ordre de chargement des mods, l'ajout de cartes personnalisées, la mise à jour et la suppression de mods, ainsi que le dépannage des problèmes courants liés aux mods.
Avant de commencer : Assurez-vous que votre serveur est configuré et en cours d'exécution. Si vous n'avez pas encore configuré votre serveur ARK: Survival Ascended, consultez d'abord le Guide de configuration du serveur. Vous aurez besoin d'accéder à GPanel pour gérer les paramètres de démarrage.
ASA utilise CurseForge, pas le Steam Workshop. Contrairement à ARK: Survival Evolved, ARK: Survival Ascended n'utilise pas le Steam Workshop pour les mods. Tous les mods ASA sont hébergés sur CurseForge. Vous ne pouvez pas utiliser les identifiants de mods du Steam Workshop pour ASA.
Trouver des mods sur CurseForge
Tous les mods ARK: Survival Ascended sont publiés sur CurseForge. Pour trouver l'identifiant du mod dont vous avez besoin pour l'installation sur le serveur :
- Visitez la section ARK: Survival Ascended sur CurseForge.
- Parcourez ou recherchez le mod souhaité. Vous pouvez filtrer par catégorie (gameplay, cartes, objets, structures, etc.).
- Ouvrez la page du mod et repérez le Project ID sur le côté droit sous la section About Project. Cet identifiant numérique est celui dont vous avez besoin.
Example CurseForge URL: https://www.curseforge.com/ark-survival-ascended/mods/super-structures
Project ID (shown on the page): 929420
^^^^^^ this is the mod ID you need
Conseil : Notez ou enregistrez les identifiants des mods avant de vous rendre sur GPanel. Si vous installez plusieurs mods, gardez une liste de tous les identifiants et de l'ordre dans lequel vous souhaitez qu'ils se chargent.
Installer des mods via GPanel
La méthode recommandée pour ajouter des mods à votre serveur ARK: Survival Ascended est via les variables de démarrage de GPanel :
- Arrêtez votre serveur depuis la page console de GPanel.
- Accédez à l'onglet Startup.
- Repérez la variable de démarrage Mod IDs (ou MODS).
- Entrez vos identifiants de mods CurseForge séparés par des virgules sans espaces :
929420,926956,927131 - Démarrez le serveur. Les mods seront téléchargés et installés automatiquement au démarrage.
Le premier démarrage avec des mods prend plus de temps. Le serveur doit télécharger chaque mod avant de pouvoir terminer son démarrage. Les mods volumineux ou les mods de conversion totale peuvent ajouter plusieurs minutes au temps de démarrage. Ne redémarrez pas le serveur pendant le téléchargement des mods.
Ajouter des mods via GameUserSettings.ini
Vous pouvez également ajouter des mods en modifiant directement le fichier de configuration. Accédez à GameUserSettings.ini via le File Manager de GPanel ou par SFTP.
Sous la section [ServerSettings], ajoutez ou modifiez la ligne ActiveMods :
[ServerSettings]
ActiveMods=929420,926956,927131Alternativement, les mods peuvent être spécifiés dans la ligne de commande de lancement du serveur en utilisant le paramètre -mods :
-mods="929420,926956,927131"
Remarque : Sur les serveurs Legion Hosting, la méthode par variable de démarrage GPanel est préférable à la modification manuelle des fichiers. Si vous définissez les mods à la fois dans la variable de démarrage et dans le fichier de configuration, la variable de démarrage a généralement la priorité.
Ordre de chargement des mods
L'ordre dans lequel les identifiants des mods sont listés détermine l'ordre de chargement. Cela est important car les mods qui modifient les mêmes systèmes de jeu peuvent entrer en conflit.
| Position | Ce qu'il faut placer ici | Exemple |
|---|---|---|
| Premier | Mods de conversion totale ou cartes personnalisées (ceux-ci remplacent les systèmes de jeu principaux) | Total conversion, modded map |
| Milieu | Modifications majeures de gameplay (empilement, structures, apprivoisement) | Super Structures, Awesome SpyGlass |
| Dernier | Mods mineurs de qualité de vie et cosmétiques | Death Recovery, HUD mods |
Si deux mods entrent en conflit, celui listé en premier a la priorité. Lors du dépannage de problèmes de mods, essayez de réorganiser l'ordre de chargement avant de supprimer complètement des mods.
Installer des cartes personnalisées (cartes moddées)
Les cartes moddées fonctionnent de manière similaire aux mods classiques mais nécessitent une étape supplémentaire pour indiquer au serveur quelle carte charger :
- Trouvez la carte moddée sur CurseForge et notez son Project ID.
- Ajoutez l'identifiant du mod de la carte à votre liste de mods (idéalement en première position).
- Dans l'onglet Startup de GPanel, changez la variable Map (ou SERVER_MAP) par le nom interne de la carte. Celui-ci est généralement indiqué sur la page CurseForge du mod dans les instructions d'installation.
- Démarrez le serveur. Le mod de la carte sera téléchargé et le serveur chargera la carte personnalisée.
Cartes moddées vs. cartes DLC : Les cartes DLC (telles que The Center, Scorched Earth, Aberration, etc.) sont du contenu officiel et ne nécessitent pas d'identifiant de mod. Elles sont sélectionnées uniquement via la variable de démarrage Map. Les cartes moddées provenant de CurseForge nécessitent à la fois l'identifiant du mod dans la liste des mods et le nom de carte correct dans la variable Map.
Installation des mods côté client
Les joueurs se connectant à votre serveur moddé doivent avoir les mêmes mods installés sur leur client. Si un joueur n'a pas un mod requis, il ne pourra pas se connecter ou sera déconnecté pendant le chargement.
Comment les joueurs installent les mods
- Les joueurs peuvent installer l'application CurseForge et s'abonner aux mêmes mods que ceux utilisés par votre serveur.
- Alternativement, lorsqu'un joueur tente de rejoindre un serveur moddé, ARK: Survival Ascended lui proposera de télécharger automatiquement les mods manquants (si les mods sont disponibles sur CurseForge).
- Les joueurs doivent s'assurer que leurs versions de mods correspondent à celles du serveur. Des mods obsolètes côté client entraîneront des échecs de connexion.
Partagez votre liste de mods : C'est une bonne pratique de partager la liste des mods de votre serveur (incluant les liens CurseForge ou les identifiants des mods) avec vos joueurs. Cela les aide à installer les mods avant de tenter de se connecter et réduit le temps de dépannage.
Mettre à jour les mods
Les mises à jour des mods sont gérées automatiquement dans la plupart des cas :
- Côté serveur : Au démarrage du serveur, celui-ci vérifie les mises à jour des mods et télécharge automatiquement les nouvelles versions. Un simple redémarrage du serveur suffit généralement pour appliquer les mises à jour des mods.
- Côté client : Les joueurs utilisant l'application CurseForge recevront des notifications de mise à jour des mods. Les joueurs doivent mettre à jour leurs fichiers de mods locaux pour correspondre à la version du serveur.
- Forcer une mise à jour : Si un mod ne se met pas à jour automatiquement, arrêtez le serveur puis redémarrez-le. Le processus de démarrage revalide tous les fichiers de mods.
Les mises à jour de mods peuvent causer des problèmes. Une mise à jour de mod peut introduire des incompatibilités avec d'autres mods ou avec la version actuelle du jeu. Si votre serveur cesse de fonctionner après une mise à jour de mod, consultez la page CurseForge du mod pour les problèmes connus ou revenez en arrière en désactivant temporairement le mod problématique.
Supprimer des mods
- Arrêtez le serveur.
- Allez dans l'onglet Startup de GPanel et supprimez l'identifiant du mod de la liste des mods.
- Si vous avez ajouté le mod via
GameUserSettings.ini, supprimez-le également de la ligneActiveMods. - Démarrez le serveur. Le mod ne sera plus chargé.
Attention : La suppression de mods qui ajoutent des objets, des structures ou des créatures au jeu entraînera la disparition de ces éléments du monde. Les joueurs qui avaient des objets moddés dans leur inventaire les perdront. Cela peut causer des problèmes avec les bases construites à l'aide de structures moddées. Prévenez toujours vos joueurs avant de supprimer des mods de contenu.
Dépannage des problèmes courants liés aux mods
Le serveur ne démarre pas avec les mods
- Vérifiez les identifiants des mods : Vérifiez que tous les identifiants de mods dans votre variable de démarrage ou votre fichier de configuration sont des Project ID CurseForge corrects. Une faute de frappe ou un identifiant invalide empêchera le serveur de démarrer.
- Vérifiez les mods incompatibles : Supprimez tous les mods, puis ajoutez-les un par un en démarrant le serveur après chaque ajout. Cela permet d'identifier quel mod cause le problème.
- Erreurs dans la console : Consultez la sortie de la console GPanel pour les messages d'erreur. Les erreurs liées aux mods mentionnent généralement l'identifiant ou le nom du mod.
- Mod abandonné : Si un mod a été retiré de CurseForge, le serveur ne peut pas le télécharger. Supprimez l'identifiant de votre liste de mods.
Erreurs de différence de version
- Mise à jour du jeu vs. mise à jour du mod : Après une mise à jour majeure d'ARK: Survival Ascended, certains mods peuvent ne pas être compatibles avec la nouvelle version tant que l'auteur du mod ne les a pas mis à jour. Consultez la page CurseForge de chaque mod pour les notes de compatibilité.
- Différence client/serveur : Le serveur et tous les joueurs doivent exécuter la même version de chaque mod. Redémarrez le serveur pour récupérer les dernières versions des mods, et demandez aux joueurs de mettre à jour leurs mods via l'application CurseForge.
Conflits de mods
- Symptômes : Plantages, objets manquants, interface cassée ou comportement de jeu inattendu après l'ajout d'un nouveau mod.
- Résolution : Réorganisez l'ordre de chargement des mods (voir la section Ordre de chargement des mods ci-dessus). Si le conflit persiste, consultez les pages des mods sur CurseForge pour les incompatibilités connues. Vous devrez peut-être choisir un mod plutôt que l'autre.
Les joueurs ne peuvent pas se connecter au serveur moddé
- Confirmez que les joueurs ont tous les mods requis installés et à jour.
- Vérifiez que les versions des mods correspondent entre le serveur et le client.
- Si le problème a commencé après l'ajout d'un nouveau mod, essayez de le supprimer temporairement pour confirmer qu'il en est la cause.
- Assurez-vous que les paramètres BattleEye correspondent entre le serveur et le client. Consultez le guide Comment se connecter pour plus de détails.
Problèmes de performance avec les mods
- Chaque mod ajoute de la charge au serveur. L'exécution de nombreux mods volumineux peut augmenter le temps de démarrage, l'utilisation de la RAM et causer des ralentissements.
- Les mods de conversion totale sont les plus lourds. Combiner plusieurs conversions totales n'est pas recommandé.
- Si le serveur a des difficultés, envisagez de réduire le nombre de mods actifs ou de mettre à niveau votre plan de serveur pour plus de ressources.
Catégories de mods populaires
| Catégorie | Description | Exemples |
|---|---|---|
| Structures | Pièces de construction améliorées, améliorations de l'accrochage et nouvelles options de construction | Super Structures, Castles & Keeps |
| Qualité de vie | Mods d'empilement, améliorations de l'interface, aides à la récupération après la mort | Awesome SpyGlass, Death Recovery |
| Créatures | Nouvelles créatures apprivoisables, rééquilibrage des créatures et refonte des compagnons | Additional Creatures, Dino Storage |
| Cartes | Mondes personnalisés avec des terrains, des ressources et des défis uniques | Cartes personnalisées créées par la communauté |
| Conversions totales | Refontes complètes du jeu qui modifient les mécaniques de base, la progression et le gameplay | Divers projets de conversion totale |
Articles connexes
- ARK: Survival Ascended Server Configuration
- ARK: Survival Ascended Admin Commands
- How to Connect to Your ARK: Survival Ascended Server
- How to Find Your Server IP and Port
- How to Upload Files via SFTP
Besoin d'aide ? Si vous rencontrez des problèmes de mods non couverts par ce guide, ouvrez un ticket de support et incluez votre identifiant de serveur, les identifiants des mods que vous utilisez et toute sortie console pertinente de GPanel.
