Comment installer des mods sur un serveur Unturned

Pour installer des mods sur un serveur Unturned, ajoutez leurs identifiants du Workshop Steam dans un fichier, puis redémarrez. Le serveur télécharge alors les mods et les cartes tout seul. Ce guide montre aussi où déposer les plugins de RocketMod, installé avec votre serveur. Il part d'un serveur Unturned déjà commandé chez OuiHeberg.

Le serveur doit avoir démarré au moins une fois. Le guide Comment créer un serveur Unturned explique ce premier démarrage.

---

Trouver l'identifiant d'un mod du Workshop

Chaque mod et chaque carte du Workshop Steam d'Unturned porte un identifiant, un nombre. Il se lit à la fin de l'adresse de sa page, après ?id=.

https://steamcommunity.com/sharedfiles/filedetails/?id=1702240229

Ici, l'identifiant est 1702240229. C'est celui de la carte Greece, que nous avons utilisée pour notre test.

OuiPanel n'a pas de gestionnaire de mods pour Unturned. Tout passe par un fichier du serveur, décrit ci-dessous.

---

Ajouter les mods dans WorkshopDownloadConfig.json

La liste des mods à télécharger se trouve dans Servers/PterodactylUnturned/WorkshopDownloadConfig.json. Le jeu crée ce fichier au premier démarrage.

1. Dans la Console, arrêtez le serveur avec Arrêter.

2. Cliquez sur Gestionnaire de fichiers, puis ouvrez les dossiers Servers et PterodactylUnturned.

3. Cliquez sur WorkshopDownloadConfig.json. La fenêtre « Édition de WorkshopDownloadConfig.json » s'ouvre.

4. Ajoutez les identifiants dans File_IDs, séparés par des virgules, puis cliquez sur Sauvegarder.

5. Démarrez le serveur depuis la Console.

"File_IDs": [1702240229, 1753134636],

Cet exemple demande les cartes Greece et Hawaii. Au démarrage, le serveur télécharge chaque élément de la liste, avec ses dépendances. Lors de notre test, il a téléchargé la carte Greece et le mod dont elle dépend, puis il a démarré.

Ce démarrage est plus long que d'habitude. Une grande carte occupe aussi plusieurs centaines de Mo sur le disque du serveur.

D'après la documentation de l'éditeur, les joueurs téléchargent ensuite les mêmes mods tout seuls, en se connectant. Nous ne l'avons pas encore vérifié avec un joueur.

Ne touchez pas aux autres lignes du fichier. Gardez un JSON valide, avec ses virgules et ses crochets.

---

Changer de carte

La carte se choisit dans la variable Carte, dans Configuration › Paramètres du serveur. Un serveur neuf charge PEI.

• Les cartes officielles PEI, Washington, Yukon, Russia et Germany sont installées avec le serveur.

• Une carte du Workshop demande deux gestes. Ajoutez son identifiant dans File_IDs, puis écrivez son nom dans Carte.

Lors de notre test, nous avons ajouté l'identifiant de Greece, écrit Greece dans la variable, puis redémarré. Le serveur a téléchargé la carte et l'a chargée.

D'après le wiki du jeu, le nom de la carte respecte les majuscules. Chaque carte a son propre dossier dans Servers/PterodactylUnturned/Level, avec son monde.

Créez une sauvegarde dans la page Sauvegardes avant de changer de carte ou d'ajouter des mods sur un monde qui compte.

---

Installer un plugin RocketMod

RocketMod ajoute des plugins et des commandes au serveur. Votre serveur utilise la version maintenue par l'éditeur du jeu, installée et activée avec le serveur. Lors de notre test, elle s'est chargée au démarrage, et la console a affiché la ligne Rocket Unturned.

1. Arrêtez le serveur depuis la Console.

2. Dans Gestionnaire de fichiers, ouvrez le dossier Servers/PterodactylUnturned/Rocket.

3. Déposez le fichier .dll du plugin dans le dossier Plugins, par glisser-déposer.

4. Démarrez le serveur, puis lisez la console.

Le dossier Plugins est créé vide. Nous n'avons pas encore testé de plugin sur nos serveurs. D'après l'usage de RocketMod, un plugin chargé devrait créer son propre dossier de réglages dans Plugins.

Fichier du dossier Rocket	Rôle, d'après RocketMod
Permissions.config.xml	Groupes de joueurs et permissions
Commands.config.xml	Liste des commandes et de leurs réglages
Rocket.config.xml	Réglages généraux de RocketMod
Rocket.Unturned.config.xml	Réglages propres à Unturned, dont la sauvegarde automatique

OuiPanel réécrit la ligne de sauvegarde automatique de Rocket.Unturned.config.xml à chaque démarrage. Réglez donc ce délai dans la variable Sauvegarde automatique (minutes).

Pour envoyer plusieurs fichiers d'un coup, passez par SFTP avec le guide Comment se connecter en SFTP avec FileZilla.

Ne supprimez pas RocketMod si vous tenez à la sauvegarde automatique du monde. C'est RocketMod qui enregistre le monde à intervalle régulier. Sans lui, le serveur ne l'enregistre plus qu'à chaque arrêt.

---

Installer OpenMod

OpenMod est un autre système de plugins, développé par un tiers. Il n'est pas installé sur nos serveurs, et nous ne l'avons pas testé. Ce qui suit vient de la documentation de l'éditeur.

• OpenMod s'installerait à côté de RocketMod et ferait tourner ses plugins.

• Il s'ajouterait avec un plugin RocketMod et la commande openmod install, ou en copiant le dossier OpenMod.Unturned dans Modules.

• Au premier démarrage, il téléchargerait ses composants.

Si vous l'essayez, créez d'abord une sauvegarde. Le dossier Modules fait partie des sauvegardes de OuiPanel.

---

Mettre à jour ou retirer un mod

D'après la documentation de l'éditeur, les mods du Workshop sont mis à jour à chaque démarrage du serveur. Le serveur surveillerait aussi leurs mises à jour pendant la partie. Il préviendrait alors les joueurs dans le tchat, puis s'arrêterait après un délai. Redémarrez-le ensuite depuis la Console.

Pour retirer un mod, arrêtez le serveur, puis effacez son identifiant de File_IDs. Pour retirer un plugin, supprimez son fichier .dll du dossier Plugins.

Les mods et les plugins viennent de leurs auteurs. Notre support vous aide sur le serveur et sur OuiPanel, pas sur le contenu ni sur les erreurs d'un mod.

---

Si un mod ne se charge pas

Symptôme	Solution
Le serveur démarre sans le mod	Vérifiez l'identifiant dans File_IDs et la syntaxe du fichier, puis redémarrez
Le serveur ne trouve pas la carte	Le nom écrit dans Carte doit être celui de la carte, majuscules comprises. Son identifiant doit figurer dans File_IDs
Le démarrage est long	Le serveur télécharge les mods. Attendez la ligne Loading level: 100%
Le disque est plein	Les cartes du Workshop sont lourdes. Retirez des identifiants, ou passez à une offre avec plus de stockage
Un plugin ne répond pas	Lisez la console au démarrage. Vérifiez que le fichier .dll est bien dans Plugins
Le serveur plante depuis l'ajout d'un mod	Retirez le dernier mod ajouté, ou restaurez une sauvegarde depuis Sauvegardes

Pour les commandes d'administration, lisez le guide Commandes admin Unturned.

---

Besoin d'aide ?

Ouvrez un ticket depuis Tickets › Ouvrir un ticket, ou depuis la tuile Contacter le support en bas de la fiche de votre serveur dans l'espace client. Vous pouvez aussi poser votre question sur le Discord de OuiHeberg.

Ouvrir un ticketDiscord