Rust: installer les plugins Oxide/uMod et effectuer un "wipe"

Deux choses dont presque tous les propriétaires de serveurs Rust ont besoin : le framework de modding Oxide (uMod) pour pouvoir exécuter des plugins, et une routine de wipe fiable pour le moment où Facepunch publie la mise à jour forcée mensuelle. Ce guide couvre les deux.

Installer Oxide (uMod)

Oxide (également appelé uMod) est le framework de plugins sur lequel presque tous les serveurs Rust moddés fonctionnent. Sur ServerPrism, le moyen le plus simple de l'obtenir est intégré à votre type de serveur :

1. Ouvrez votre serveur et allez dans l'onglet Startup.
2. Recherchez une option modding framework / Oxide (de nombreux "eggs" Rust ont un interrupteur ou une variable de build comme Oxide/Carbon).
3. Réglez-le sur Oxide, puis réinstallez ou redémarrez pour que le framework soit téléchargé.
4. Après le démarrage, la console affiche la version d'Oxide au démarrage, et un dossier oxide/ apparaît dans le gestionnaire de fichiers.

Si votre type de serveur n'expose pas d'interrupteur, ouvrez un ticket de support et nous vous basculerons vers la version Oxide.

Installer des plugins

Les plugins Rust sont des fichiers .cs uniques.

1. Téléchargez le fichier .cs du plugin depuis umod.org.
2. Dans le File Manager, déposez-le dans oxide/plugins/.
3. Oxide charge à chaud les plugins — aucun redémarrage n'est nécessaire. La console affiche Loaded plugin <Name> en quelques secondes.

Les fichiers de configuration et de données sont générés sous oxide/config/ et oxide/data/ lors du premier chargement. Modifiez la configuration, puis rechargez le plugin avec oxide.reload <PluginName> dans la console.

Commandes de console utiles :

oxide.plugins           # lister les plugins chargés
oxide.reload PluginName  # appliquer les changements de configuration
oxide.unload PluginName  # désactiver sans supprimer
oxide.grant group admin PluginName.permission  # permissions

Effectuer un "wipe" de votre serveur

Un wipe réinitialise la progression. Il y a deux niveaux :

• Map wipe — régénère la carte et efface les bâtiments/butins, mais conserve les plans. Faites cela lorsque vous voulez une nouvelle carte.
• Full wipe (BP wipe) — map wipe plus l'effacement des plans des joueurs. C'est ce que la plupart des serveurs font lors de la mise à jour forcée mensuelle.

Comment effectuer un "wipe"

1. Arrêtez le serveur depuis l'onglet Console.
2. Dans le File Manager, ouvrez le dossier server/<identity>/ (l'identité est définie dans votre onglet Startup).
3. Pour un map wipe, supprimez les fichiers de carte : *.map et *.sav (et leurs sauvegardes .1, .2).
4. Pour un full wipe, supprimez également les données de plans — supprimez les fichiers player.blueprints.*.db (ou l'ensemble des fichiers storage/blueprint selon votre build).
5. Changez éventuellement le world seed et/ou la map size dans l'onglet Startup pour une toute nouvelle carte.
6. Démarrez le serveur. Il génère un nouveau monde au démarrage.

Toujours sauvegarder d'abord. Faites une sauvegarde avant d'effectuer un "wipe" afin qu'une erreur soit réversible — voir Sauvegarder votre serveur.

Calendrier du "force wipe"

Facepunch publie une mise à jour obligatoire le premier jeudi de chaque mois, ce qui rend Oxide et les plugins inutilisables jusqu'à ce qu'ils soient mis à jour. Le jour du "force wipe" : mettez à jour le serveur, attendez qu'Oxide et vos plugins publient des versions mises à jour, puis effectuez le "wipe". L'exécution d'un Oxide obsolète après une mise à jour forcée échouera à charger — c'est normal jusqu'à ce qu'uMod se mette à jour.

Problèmes courants

• Les plugins ne se chargent pas après la mise à jour mensuelle : Oxide/les plugins ne sont pas encore mis à jour pour la nouvelle version de Rust — mettez à jour le serveur et attendez qu'uMod se mette à jour.
• Failed to compile un plugin : mauvaise version de plugin pour votre build Oxide, ou un plugin de dépendance manquant — vérifiez la page uMod du plugin.
• Le "wipe" n'a "pas fonctionné" : vous avez supprimé des fichiers dans le mauvais dossier d'identité, ou n'avez pas arrêté le serveur d'abord — arrêtez, supprimez dans le bon dossier server/<identity>/, puis démarrez.
• Serveur non visible dans le navigateur : toujours en cours de démarrage, ou la description/server.hostname n'est pas définie — vérifiez la console.

Besoin d'aide pour un "wipe" ou un plugin récalcitrant ? Ouvrez un ticket de support et nous nous en occuperons sur le nœud.