Installer des mods sur un serveur Enshrouded (EML)

Enshrouded n'a pas de support officiel des mods : il n'y a ni Steam Workshop ni onglet de mods dans le panel. Vous pouvez quand même faire tourner des mods sur votre serveur avec EML (Enshrouded Mod Loader), un loader communautaire gratuit. Il y a quatre étapes : envoyer une DLL, envoyer vos mods, ajouter deux lignes dans un fichier de réglages, puis redémarrer. Nous avons testé chaque étape ci-dessous sur notre propre serveur Enshrouded.

Avant de commencer : EML et ses mods sont non officiels. Une mise à jour du jeu peut les casser jusqu'à ce que leurs auteurs les adaptent, et nous ne pouvons pas réparer un mod à votre place. Faites d'abord une sauvegarde (onglet Backups, ou téléchargez le dossier savegame).

Ce qu'est EML

EML est un loader open source créé par la communauté. Au démarrage du serveur, il exécute chaque mod du dossier mods et modifie les données du jeu avant le chargement du monde : par exemple la taille des piles, la quantité de butin, les coûts de fabrication ou l'endurance. Il n'ajoute pas de nouvelles commandes ni de scripts qui tournent pendant la partie.

Vous avez besoin de deux téléchargements :

• EML lui-même : le fichier dbghelp.dll de la dernière version sur GitHub : https://github.com/Brabb3l/kfc-parser/releases
• Les mods : la plupart des mods EML se trouvent sur Nexus Mods : https://www.nexusmods.com/enshrouded. Choisissez des mods dont la page indique qu'ils fonctionnent avec EML et la version actuelle du jeu. Chaque mod est un dossier contenant un fichier mod.json.

Étape 1 : arrêter le serveur et envoyer EML

1. Arrêtez votre serveur depuis le panel.
2. Ouvrez Files. Vous êtes dans le dossier principal du serveur, celui qui contient enshrouded_server.exe.
3. Cliquez sur Upload et envoyez dbghelp.dll ici, à côté de enshrouded_server.exe.

Étape 2 : envoyer vos mods

1. Dans ce même dossier principal, cliquez sur New folder et nommez-le mods.
2. Ouvrez mods, cliquez sur Upload, puis sur Upload folder, et choisissez le dossier du mod sur votre PC. Répétez l'opération pour chaque mod. La structure doit ressembler à ceci :

mods/
  more-stamina/
    mod.json
    src/
      mod.lua

mod.json doit se trouver directement dans le dossier du mod, pas un niveau plus bas. Si un téléchargement se décompresse dans un dossier supplémentaire, envoyez le dossier intérieur. Pour beaucoup de mods d'un coup, le SFTP fonctionne aussi (onglet Files, bouton SFTP).

Étape 3 : faire charger la DLL au serveur

Votre serveur Enshrouded exécute le programme serveur Windows sous Linux via Proton. Proton utilise sa propre dbghelp.dll intégrée et ignore celle que vous avez envoyée, sauf si vous le lui indiquez. Vous le faites une seule fois, dans un fichier de réglages appelé user.reg.

1. Gardez le serveur arrêté. Si vous modifiez ce fichier pendant que le serveur tourne, votre modification est écrasée à l'arrêt.
2. Dans Files, ouvrez Steam, puis steamapps, compatdata, 2278520 et pfx.

3. Cliquez sur les trois points à côté de user.reg et choisissez Download. L'éditeur du panel n'ouvre pas les fichiers .reg, vous le modifiez donc sur votre PC.
4. Ne double-cliquez pas sur le fichier : sous Windows, cela l'ajoute au registre de votre propre PC. Faites un clic droit, choisissez Ouvrir avec, puis votre éditeur de texte. Ouvrez le fichier téléchargé dans un éditeur de texte simple (Bloc-notes, Notepad++ ou VS Code). Allez tout à la fin, ajoutez une ligne vide, puis ajoutez ces deux lignes exactement telles quelles (les doubles antislashs sont corrects) :

[Software\\Wine\\AppDefaults\\enshrouded_server.exe\\DllOverrides]
"dbghelp"="native,builtin"

5. Enregistrez le fichier en gardant le nom user.reg.
6. De retour dans le dossier pfx, cliquez sur Upload et envoyez votre user.reg modifié pour qu'il remplace l'ancien.

Si le dossier pfx n'existe pas encore, démarrez le serveur une fois, laissez-le passer en ligne, arrêtez-le et réessayez. Le dossier est créé au premier démarrage.

Étape 4 : démarrer le serveur et vérifier qu'EML est chargé

Démarrez le serveur depuis le panel, puis ouvrez Files à nouveau. Quand EML est chargé, vous voyez de nouveaux fichiers dans le dossier principal : eml.json et enshrouded_server.kfc.bak (la copie par EML des données d'origine du jeu).

EML écrit son propre journal, pas dans la Console. Ouvrez le dossier logs et cliquez sur le fichier qui se termine par .eml.log (il porte la date du jour). Après un démarrage où vous avez ajouté ou modifié des mods, chaque mod a une ligne Running mod, suivie de Applied ... patches :

Lors des démarrages suivants sans changement, le journal indique No changes detected, skipping patching à la place. C'est normal : les données du jeu déjà modifiées restent en place.

Vos mods sont maintenant actifs pour tous les joueurs qui se connectent. Certains mods doivent aussi être installés sur le PC de chaque joueur : la page du mod l'indique.

Ajouter, modifier ou retirer des mods

• Ajouter ou modifier un mod : arrêtez le serveur, modifiez les fichiers dans mods, redémarrez-le. EML détecte le changement et applique à nouveau les patchs aux données du jeu.
• Retirer tous les mods : arrêtez le serveur et supprimez dbghelp.dll ainsi que le dossier mods. Supprimez ensuite enshrouded_server.kfc et renommez enshrouded_server.kfc.bak en enshrouded_server.kfc, ce qui remet les données d'origine du jeu. Pour repartir d'une base totalement propre, activez Validate dans l'onglet Startup pour un démarrage (Steam vérifie et répare alors tous les fichiers du jeu), puis désactivez-le ensuite. Vous pouvez laisser les deux lignes dans user.reg : sans dbghelp.dll, elles ne font rien.
• Mods de taille de pile : avant d'en retirer un, divisez toute pile plus grande que la limite normale, sinon les objets en trop de cette pile peuvent être perdus.

Votre monde reste dans savegame tout du long. EML modifie les fichiers de données du jeu, pas votre sauvegarde.

Problèmes courants

Pas de fichier .eml.log ni d'eml.json après un redémarrage. EML ne s'est pas chargé. Vérifiez les deux lignes de user.reg (fautes de frappe, deux antislashs entre chaque partie, guillemets droits) et que vous avez envoyé le fichier pendant que le serveur était arrêté. Vérifiez aussi que dbghelp.dll se trouve à côté de enshrouded_server.exe, et non dans mods.

Le journal indique Running mods mais aucune ligne Running mod, même après l'ajout d'un mod. EML n'a trouvé aucun mod. Assurez-vous que le mod.json de chaque mod se trouve directement dans mods/<nom du mod>/.

Le serveur ne démarre plus après une mise à jour du jeu. Une grosse mise à jour d'Enshrouded peut casser EML ou un mod jusqu'à sa mise à jour. Arrêtez le serveur, supprimez dbghelp.dll et redémarrez-le pour être tout de suite de nouveau en ligne. Remettez la dernière version d'EML quand elle prend en charge la mise à jour, puis vos mods un par un.

Un mod se charge mais ne change rien. Il est probablement conçu pour une version plus ancienne du jeu, ou il ne change quelque chose que côté joueur. Consultez la page du mod pour connaître la version prise en charge.

Les mods ne fonctionnent plus après la restauration d'une sauvegarde. Si le serveur reconstruit le dossier Proton après une restauration, votre modification de user.reg a disparu. Refaites l'étape 3.

Ce que vous pouvez changer sans mods

Une bonne partie de ce pour quoi on installe des mods est déjà un réglage du monde : difficulté, quantité de butin, force des ennemis, durée du jour et plus encore. Ces réglages ne cassent jamais lors d'une mise à jour. Voir Comment modifier les paramètres et la difficulté d'un serveur Enshrouded. Pour jouer sur un monde que vous avez déjà construit, voir Comment importer votre monde sur votre serveur Enshrouded.

Vous n'avez pas encore de serveur ? Découvrez l'hébergement de serveur Enshrouded.