Comment installer Oxide ou Carbon et des plugins sur un serveur Rust ?

Contexte

Un serveur Rust vanilla tourne très bien tel quel, mais la plupart des communautés veulent des kits de départ, de la téléportation, des clans ou un shop. Tout cela passe par des plugins, et les plugins ont besoin d'un framework de modding, Oxide (uMod) ou Carbon.

Sur votre serveur Rust Winheberg, pas besoin d'installer ce framework à la main. Le panel gaming le télécharge pour vous au démarrage, il suffit de le choisir. Ce guide vous montre comment activer Oxide ou Carbon, installer un plugin depuis uMod, puis vérifier qu'il tourne.

Prérequis

Un serveur Rust actif sur votre panel gaming Winheberg
Le lien de téléchargement du plugin voulu, par exemple sur umod.org
Une sauvegarde récente depuis l'onglet Backups, avant tout changement de framework

1. Choisir le framework dans Startup

Dans le menu latéral, ouvrez Startup et descendez jusqu'à la variable MODDING FRAMEWORK. Trois valeurs sont proposées.

Valeur	Résultat
`vanilla`	Serveur sans mod, valeur par défaut
`oxide`	Installe Oxide (uMod), le framework historique de Rust
`carbon`	Installe Carbon, compatible avec la plupart des plugins Oxide

Sélectionnez oxide ou carbon. Le choix est enregistré dès que vous changez la valeur, il n'y a pas de bouton de sauvegarde.

Variable MODDING FRAMEWORK réglée sur oxide dans l'onglet Startup du panel

Oxide et Carbon ne peuvent pas cohabiter. Choisissez-en un seul. Les plugins s'écrivent de la même façon pour les deux, mais Carbon range ses fichiers dans un dossier carbon au lieu de oxide.

2. Redémarrer et vérifier le chargement

Revenez sur la Console et cliquez sur Restart. À chaque démarrage, le serveur met Rust à jour puis télécharge la dernière version du framework choisi. Vous n'avez donc jamais à mettre Oxide à jour vous-même.

Le premier démarrage avec un framework prend quelques minutes de plus. Quand Oxide se charge, la console affiche ces lignes.

Loading Oxide Core v2.0.4143...
Loading extensions...
Loaded extension Rust v2.0.7839 by Oxide Team and Contributors
Loading plugins...

Chargement d'Oxide Core et de ses extensions dans la console du serveur Rust

Les numéros de version changent à chaque mise à jour, c'est normal. Une fois le serveur démarré, un dossier oxide apparaît à la racine du serveur, avec les sous-dossiers plugins, config, data, lang et logs.

3. Installer un plugin depuis une URL

Un plugin Oxide est un simple fichier .cs. Le gestionnaire de fichiers du panel peut le télécharger directement, sans passer par votre PC.

Ouvrez Files, puis le dossier oxide, puis plugins (avec Carbon, carbon puis plugins)
Cliquez sur Upload, puis sur Upload from URL

Menu Upload du gestionnaire de fichiers avec l'option Upload from URL

Collez le lien direct du fichier .cs dans le champ URL. Sur uMod, il prend la forme https://umod.org/plugins/NomDuPlugin.cs
Vérifiez le champ Filename. Il se remplit tout seul à partir de l'URL, il doit contenir uniquement le nom du fichier, ici Kits.cs
Cliquez sur Upload

Fenêtre Upload from URL avec le lien du plugin Kits et le nom de fichier Kits.cs

Le fichier apparaît dans le dossier quelques secondes plus tard.

Le fichier Kits.cs dans le dossier oxide/plugins

Vous avez téléchargé le plugin sur votre PC ? Utilisez Upload Files à la place, ou le SFTP pour les gros fichiers, comme expliqué dans notre guide Comment se connecter en SFTP à son serveur gaming ?.

4. Vérifier que le plugin est chargé

Oxide surveille le dossier plugins et charge automatiquement un plugin dès que son fichier est ajouté ou modifié, sans redémarrage. Au premier chargement, le plugin crée son fichier de configuration dans oxide/config (avec Carbon, carbon/configs).

Pour lister les plugins actifs, tapez cette commande dans la console, sans / devant.

o.plugins

Les commandes utiles pour gérer vos plugins sont les suivantes.

Commandes de gestion des plugins

Oxide	Carbon	Rôle
`o.plugins`	`c.plugins`	Liste les plugins chargés
`o.reload Kits`	`c.reload Kits`	Recharge un plugin, par exemple après une modification de sa configuration
`o.unload Kits`	`c.unload Kits`	Décharge un plugin sans supprimer son fichier
`o.load Kits`	`c.load Kits`	Charge un plugin déchargé

La console du panel envoie les commandes au serveur par RCON. Pendant le démarrage, elle répond Unable to run "o.plugins" due to RCON not being connected yet. Attendez que le statut du serveur passe à Online et réessayez. Si le message persiste après le démarrage, remplacez le mot de passe par défaut CHANGEME de la variable RCON PASSWORD dans Startup, puis redémarrez.

5. Donner les permissions du plugin

La plupart des plugins réservent leurs commandes aux joueurs qui ont la bonne permission. La page du plugin sur uMod liste ses permissions. Oxide crée deux groupes par défaut, default pour tous les joueurs et admin pour les administrateurs.

Commande	Effet
`o.grant group default <permission>`	Donne la permission à tous les joueurs
`o.grant user <pseudo ou SteamID64> <permission>`	Donne la permission à un seul joueur
`o.revoke user <pseudo ou SteamID64> <permission>`	Retire la permission
`o.show user <pseudo>`	Affiche les permissions et les groupes d'un joueur

Avec Carbon, remplacez o. par c., par exemple c.grant. Les joueurs déclarés owner sur le serveur sont ajoutés automatiquement au groupe admin d'Oxide. Pour devenir owner, suivez notre guide « Comment devenir administrateur sur un serveur Rust ? ».

En cas de problème

❌ Le plugin n'apparaît pas dans o.plugins

Vérifiez que le fichier se trouve bien dans oxide/plugins (ou carbon/plugins) et qu'il se termine par .cs
Vérifiez son nom. Si la console affiche une erreur comme celle-ci, le champ Filename contenait le nom en double, renommez le fichier en Kits.cs

Could not load plugin 'Kits.csKits' (no plugin found with that file name)

Ouvrez le dernier fichier de oxide/logs, les erreurs de compilation des plugins y sont détaillées

❌ Un plugin ne marche plus après le wipe mensuel

Chaque mise à jour obligatoire de Rust peut casser un plugin. Le framework, lui, se met à jour tout seul au redémarrage. Vérifiez sur la page du plugin si une nouvelle version est sortie, téléchargez-la par-dessus l'ancienne, puis lisez la console pour confirmer qu'elle se charge.

❌ Le serveur plante après un changement de framework

Oxide modifie certains fichiers du jeu, qui restent en place si vous repassez en vanilla ou passez à carbon. Faites une sauvegarde, puis lancez Reinstall Server depuis Settings pour que SteamCMD restaure les fichiers d'origine de Rust.

Bonnes pratiques

Ajoutez vos plugins un par un et lisez la console après chacun, un conflit est alors facile à repérer
Modifiez la configuration d'un plugin dans oxide/config, puis appliquez-la avec o.reload NomDuPlugin
Ne téléchargez vos plugins que depuis des sources connues comme uMod. Un plugin .cs exécute du code sur votre serveur
Sauvegardez le dossier oxide avant un wipe ou une grosse mise à jour, il contient vos configurations et les données de vos joueurs

Besoin d'aide ?

Si un plugin refuse de se charger malgré ces vérifications, notre équipe est là pour vous aider. Ouvrez un ticket dans le département Technique depuis votre espace client, renseignez le champ Produit lié avec votre serveur Rust et joignez le message d'erreur de la console.

Retrouvez nos offres sur la page Hébergement Rust. Votre serveur est prêt à accueillir ses premiers plugins 📦