Guide : comment modder votre serveur Palworld

Les mods pour un serveur dédié Palworld existent en deux types, et le type détermine où le mod doit être installé. Un mod côté serveur s’installe une seule fois sur le serveur et s’applique à tous ceux qui se connectent. Un mod côté client est installé par chaque joueur sur son propre PC et ne change que ce que ce joueur voit. Un mod placé au mauvais endroit ne fait rien.

Côté serveur ou côté client

	Mod côté serveur	Mod côté client
Où il s’exécute	Sur le serveur dédié	Dans le jeu de chaque joueur
Qui l’installe	Le propriétaire du serveur, une seule fois	Chaque joueur qui le souhaite, sur son propre PC
Qui est concerné	Tout le monde sur le serveur, y compris les joueurs console	Uniquement le joueur qui l’a installé
Comment le repérer	La page Steam Workshop du mod indique qu’il prend en charge les serveurs dédiés. Dans le Info.json du mod, les règles d’installation contiennent "IsServer": true	Aucune prise en charge du serveur dédié indiquée. Catégories typiques : User Interface, Model Replacement, tout ce qui ne modifie que les visuels ou les menus
Exemples de ce qu’il modifie	Tables de spawn, taux de drop, statistiques des Pals, recettes, règles du monde, outils d’administration exécutés sur le serveur	Menus, HUD, modèles de Pals et de joueurs, textures, caméra, sons
Joueurs sur console	Bénéficient de l’effet, parce qu’il s’exécute sur le serveur	Impossible de l’utiliser. Les mods Workshop sont réservés à Steam

La documentation officielle de Pocketpair sur les serveurs dédiés énonce clairement la règle : seuls les mods conçus pour fonctionner sur des serveurs fonctionneront sur le serveur. Un mod côté client copié sur le serveur est ignoré.

Un mod peut être les deux. Un mod qui modifie ce que fait le serveur et ajoute aussi un menu côté joueur est livré en deux parties, et la page Workshop l’indique. Dans ce cas, le propriétaire du serveur installe la partie serveur et chaque joueur installe la partie client.

Le serveur autorise-t-il les mods côté client ?

Un réglage distinct du serveur décide si les joueurs qui utilisent des mods côté client peuvent se connecter : bAllowClientMod dans PalWorldSettings.ini. La valeur par défaut du jeu est True. Quand il est sur False, un joueur avec des mods activés est refusé avec un message indiquant que le serveur n’autorise pas les mods client. Sur une instance Survival Servers, ce réglage est l’interrupteur Allow Modded Clients de l’outil Server Config, et il est désactivé par défaut. Voir Paramètres du serveur Palworld pour la liste complète des réglages.

Quelles catégories du Workshop correspondent à quoi

Le Steam Workshop de Palworld classe les mods en six catégories. La catégorie indique où un mod s’exécute, sans le garantir. Vérifiez toujours sur la page du mod qu’il prend en charge les serveurs dédiés.

Catégorie Workshop	Fonctionne généralement sur
Gameplay	Le serveur, lorsque l’auteur l’a conçu pour les serveurs. C’est là que se trouvent les mods de taux de drop, d’apparition et d’équilibrage
PalSchema	Serveur. Les mods PalSchema modifient les tables de données du jeu telles que les statistiques des Pals, les objets et les recettes, et le serveur doit les charger pour que les changements s’appliquent à tout le monde
UE4SS	L’un ou l’autre. UE4SS est une couche de script ; un mod UE4SS s’exécute là où il est installé, et c’est l’auteur qui décide s’il est écrit pour le serveur, le client ou les deux
Utilitaires	L’un ou l’autre. Les outils d’administration et d’automatisation sont généralement côté serveur ; les outils de confort de jeu sont généralement côté client
Interface utilisateur	Client uniquement
Remplacement de modèle	Client uniquement. Le serveur n’effectue jamais aucun rendu

Installer des mods côté serveur sur une instance Survival Servers

1. Ouvrez votre serveur de jeu dans le Command Center et trouvez Workshop Mods sous MODIFY GAME SERVER SETTINGS.
2. Cliquez sur Browse et recherchez dans le Workshop Palworld par nom, auteur, catégorie ou ID de fichier. Après un redémarrage, chaque mod dans Manage porte une étiquette Runs on server ou Client-side only ; seuls ceux du premier type s’exécuteront sur le serveur.
3. Ajoutez les mods souhaités et définissez leur ordre avec les flèches. L’ordre de chargement compte lorsque des mods modifient les mêmes données. La liste active est écrite dans Mods\PalModSettings.ini au prochain redémarrage.
4. Cliquez sur Save Settings & Restart. Les mods se téléchargent et se mettent à jour automatiquement à chaque démarrage ou redémarrage.

Deux options sur la même page modifient le comportement des départs :

• Skip mod updating ignore l’étape de téléchargement depuis le Workshop au prochain démarrage ou redémarrage, et sur Palworld, cette option désactive aussi les mods pour ce démarrage. Laissez-la décochée tant que vous utilisez des mods.
• Clean Mods Folder vide \Mods\, y compris tous les mods Workshop téléchargés, au prochain démarrage. Utilisez cette option pour repartir de zéro ou pour supprimer un téléchargement corrompu.

Les mods côté serveur ne fonctionnent que sur l’édition Windows du serveur dédié. Les serveurs Palworld de Survival Servers tournent sous Windows, donc tous les mods conçus pour les serveurs dédiés sont éligibles.

Ce qui se passe sur le serveur au redémarrage

Palworld est livré avec un chargeur de mods officiel pour les serveurs dédiés. Au redémarrage, le serveur lit Mods\PalModSettings.ini, qui se présente ainsi :

[PalModSettings]
bGlobalEnableMod=true
ActiveModList=GamingCattiva
ActiveModList=FarmingQuivern

bGlobalEnableMod active le chargement des mods. Chaque ligne ActiveModList désigne un mod par le PackageName de son Info.json, et non par le nom de son dossier. Le panneau écrit ce fichier pour vous à partir du sélecteur ; sur un serveur auto-hébergé, vous l’écrivez à la main, et il est créé automatiquement au premier démarrage du serveur.

Pour chaque mod actif, le serveur crée ensuite Mods\ManagedMods\<PackageName>\InstallManifest.json et copie les fichiers du mod là où ses règles d’installation l’indiquent :

Règle d’installation	Déployé sur
UE4SS	Mods\NativeMods\UE4SS
Lua	Mods\NativeMods\UE4SS\Mods\<PackageName>
PalSchema	Mods\NativeMods\UE4SS\Mods\PalSchema\mods\<PackageName>
LogicMods	Pal\Content\Paks\LogicMods
Paks	Pal\Content\Paks\~WorkshopMods\<PackageName>

Les mises à jour se gèrent de la même façon. Lorsque le Version du Info.json d’un mod change, le redémarrage suivant désinstalle l’ancienne copie et déploie la nouvelle. Supprimer la ligne d’un mod de ActiveModList le désactive au redémarrage suivant.

Installer des mods côté client

Les mods côté client s’installent joueur par joueur et rien ne change sur le serveur :

1. Dans Steam, abonnez-vous au mod sur le Workshop Palworld. Steam le télécharge dans C:\Program Files (x86)\Steam\steamapps\workshop\content\1623730.
2. Activez-le dans le menu des mods du jeu et redémarrez le jeu.
3. Rejoignez le serveur normalement. Le serveur doit avoir Allow Modded Clients activé, ce qui est le réglage par défaut du jeu (il est activé dès le départ sur un serveur Survival Servers).

Les mods de Nexus Mods ou d’autres sites, livrés sous forme de fichiers libres ou de fichiers .pak, suivent quant à eux les instructions d’installation de l’auteur du mod. Ils vont dans le dossier de jeu du joueur lui-même.

Mods qui doivent correspondre des deux côtés

Certains mods plus anciens, surtout des fichiers .pak datant d’avant la prise en charge du Workshop, modifient les données du jeu et exigent le même fichier sur le serveur et sur le PC de chaque joueur. Ils ne sont pas gérés par le sélecteur Workshop. Pour en installer un :

1. Arrêtez le serveur depuis le Command Center.
2. Connectez-vous avec votre client FTP et téléversez le .pak dans /Pal/Content/Paks.
3. Demandez à chaque joueur de placer le même fichier dans le dossier correspondant de sa propre installation de Palworld.
4. Démarrez le serveur.

Si les deux copies se désynchronisent après une mise à jour, les joueurs voient des erreurs ou du contenu manquant jusqu’à ce que les deux côtés concordent à nouveau. Lorsqu’une version Workshop du même mod existe, utilisez-la plutôt ; le serveur la gère pour vous.

Un .pak installé manuellement et conçu pour une version antérieure du jeu peut empêcher le serveur de démarrer après une mise à jour ; dans ce cas, retirez-le de /Pal/Content/Paks.

Quand un mod ne fait rien

Suivez ces points dans l’ordre. Ce sont les causes que Pocketpair liste dans la documentation du serveur dédié, plus les deux qui reviennent le plus souvent sur les serveurs hébergés.

1. Il s’agit d’un mod côté client. Consultez la page Workshop. Si elle ne mentionne pas la prise en charge des serveurs dédiés, ou si ses règles d’installation Info.json ne contiennent pas "IsServer": true, le serveur ne peut pas l’exécuter. Chaque joueur l’installe à la place.
2. Le serveur n’a pas été redémarré. Les mods ne se déploient qu’au redémarrage. Enregistrer le sélecteur ne suffit pas.
3. Une dépendance est manquante. Certains mods en nécessitent un autre. Ajoutez aussi la dépendance au sélecteur, au-dessus du mod qui en a besoin.
4. Le mod a été supprimé lors de la mise à jour 1.0. Les mods conçus pour les versions antérieures à 1.0 peuvent faire planter un serveur 1.0, et Pocketpair recommande de les retirer avant la mise à jour. Clean Mods Folder dans les One Time Toggles du panneau vide le dossier des mods pour cette raison. Réinstallez ensuite la version compatible avec 1.0 depuis le Workshop.
5. Les mods sont désactivés globalement. L’argument de lancement -NoMods désactive tous les mods, quel que soit PalModSettings.ini. Retirez-le de vos paramètres de lancement.
6. Le déploiement n’a pas eu lieu. Sur un serveur auto-hébergé, vérifiez que Mods\ManagedMods\<PackageName>\InstallManifest.json existe après le redémarrage. Si ce n’est pas le cas, le mod ne s’est jamais chargé ; vérifiez bGlobalEnableMod=true et assurez-vous que l’entrée ActiveModList est bien le PackageName, et non le nom du dossier.

Les mods peuvent corrompre les sauvegardes ou faire planter le serveur. La consigne de Pocketpair est de les utiliser à vos risques et périls. Faites une sauvegarde avant d’en ajouter un, et si un problème survient après l’ajout d’un mod, retirez d’abord ce mod.

Voir aussi

Paramètres du serveur Palworld

Commandes admin Palworld

Guide : comment créer un serveur Palworld

Comment rejoindre un serveur Palworld

Chaque serveur Palworld de Survival Servers inclut le sélecteur de mods Workshop : installer des mods côté serveur se résume à une recherche, une commande et un redémarrage.