Guide : comment modder votre serveur Palworld

Les mods pour un serveur dédié Palworld se divisent en deux catégories, et la catégorie 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 s’y connectent. Un mod côté client est installé par chaque joueur sur son propre PC et ne modifie que ce que ce joueur voit. Placez un mod au mauvais endroit et il ne fera rien. Cette page explique comment distinguer les deux, comment les mods Workshop côté serveur s’installent sur un serveur dédié, et quoi vérifier lorsqu’un mod ne fonctionne pas. Elle est à jour pour la version 1.0 du jeu.

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 paramètre serveur distinct décide si les joueurs utilisant des mods côté client peuvent se connecter : bAllowClientMod dans PalWorldSettings.ini. La valeur par défaut du jeu est True. Quand elle 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 paramètre correspond à l’option Allow Modded Clients de l’outil Server Config, activée par défaut. Consultez Paramètres du serveur Palworld pour la liste complète des paramètres.

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 panneau de contrôle et trouvez l’outil Workshop Mods.
2. Cliquez sur Parcourir et cherchez dans le Workshop Palworld par nom, auteur, catégorie ou identifiant de fichier. Chaque résultat porte une pastille Fonctionne sur le serveur ou Côté client uniquement ; seuls ceux du premier type fonctionneront 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. Enregistrez vos paramètres et redémarrez le serveur. 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 :

• Ignorer la mise à jour des mods saute l’étape de téléchargement Workshop au démarrage et au redémarrage. Utilisez cette option pour des redémarrages plus rapides lorsque vos mods sont déjà à jour.
• Clean Mods Folder vide \Pal\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. L’option Allow Modded Clients doit être activée sur le serveur, ce qui est le cas par défaut.

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 panneau de contrôle.
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.

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. C’est pour cette raison que le bouton « Update to 1.0 » du panneau propose de vider le dossier des mods. Réinstallez ensuite la version compatible 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.