Aller au contenu
+90 850 303 07 52 [email protected]
Assistance Espace client
Sur une sélection d'offres d'hébergement annuelles et de VDS sur 3 mois, nom de domaine .com / .com.tr offert la première année · Voir les offres

Guides

Des guides pas à pas pour installer et gérer votre propre serveur, serveur de jeu ou site web, rédigés par l'équipe qui exploite notre infrastructure à Istanbul.

Rust

Comment installer Oxide (uMod) sur un serveur Rust ? Windows et Linux

26 août 2026 14 min de lecture Mis à jour :
Partager cet article

Dans ce guide, vous installerez le framework de plugins Oxide sur votre serveur Rust sous Windows et Linux, vous vérifierez l'installation et vous installerez votre premier plugin. Vous verrez aussi les dossiers oxide/plugins et oxide/config, la réinstallation après chaque mise à jour de Rust et le framework alternatif Carbon. Les chemins et les noms de scripts sont les mêmes que dans le guide d'installation d'un serveur Rust.

Avant de commencer

Oxide est un framework de modding qui charge dans un serveur Rust des plugins écrits en C# (fichiers .cs) ; les plugins de téléportation, de clan ou d'économie ne fonctionnent pas sur un serveur vanilla (non modifié). uMod est le nom de umod.org, la plateforme sur laquelle les plugins sont publiés, d'où l'association fréquente des deux noms. Le logiciel que vous installez sur le serveur est toutefois Oxide : le lien de téléchargement Rust sur umod.org télécharge lui aussi directement la dernière version d'Oxide depuis GitHub.

  • Un serveur Rust fonctionnel : il doit être installé avec SteamCMD et avoir démarré au moins une fois. Les chemins sont C:\Rust\Server (le dossier de RustDedicated.exe) sous Windows et /home/rust/rustserver sous Linux ; l'identité du serveur est myserver. Si les vôtres sont différents, adaptez les chemins.
  • unzip sous Linux : nécessaire pour extraire l'archive d'Oxide. Comme l'utilisateur rust n'a pas les droits sudo, installez-le depuis une session root :
    sudo apt install unzip
  • Accès HTTPS sortant : à chaque démarrage, Oxide vérifie le programme Oxide.Compiler qui compile les plugins et le télécharge depuis downloads.oxidemod.com si nécessaire.
  • Compatibilité des versions : Oxide et le serveur Rust doivent correspondre à la même mise à jour ; une nouvelle version d'Oxide sort peu après chaque mise à jour de Facepunch. Des versions incompatibles peuvent empêcher le serveur de démarrer.
  • Sauvegardes : les sauvegardes automatiques ne sont pas incluses dans les offres VDS ; sauvegardez le dossier server/myserver avant de commencer et, une fois Oxide installé, sauvegardez aussi régulièrement le dossier oxide.

1. Arrêtez le serveur

Ne copiez pas les fichiers d'Oxide pendant que le serveur tourne ; la documentation d'Oxide avertit que cela peut corrompre les données du serveur. Pour enregistrer et arrêter le serveur, tapez quit dans la console :

  • Windows : tapez quit dans la fenêtre du serveur ; comme la boucle goto start relancerait le serveur, fermez aussi la fenêtre une fois le serveur arrêté.
  • Linux : envoyez quit depuis votre outil RCON (administration à distance). Le serveur enregistre puis s'arrête, et la session screen se termine.

2. Retirez la ligne SteamCMD du script de démarrage

Les scripts start.bat et start.sh du guide d'installation mettent à jour le serveur avec SteamCMD à chaque démarrage. La page de Facepunch sur l'installation d'un serveur souligne que lancer SteamCMD dans le script de démarrage remet toujours les fichiers à l'état vanilla ; autrement dit, Oxide est supprimé sans que vous le remarquiez.

  • Windows : ouvrez le fichier C:\Rust\Server\start.bat dans le « Notepad » (Bloc-notes) et supprimez la ligne qui commence par C:\Rust\SteamCMD\steamcmd.exe. La ligne RustDedicated.exe et la boucle goto start restent.
  • Linux : ouvrez-le avec nano ~/start.sh et supprimez la ligne qui commence par /usr/games/steamcmd. Les lignes SERVER_DIR=, cd, export LD_LIBRARY_PATH et ./RustDedicated doivent rester. La ligne cd est importante, car Oxide crée le dossier oxide dans le dossier à partir duquel le serveur s'exécute.

Désormais, vous ferez les mises à jour avec le script séparé de l'étape 8, en réinstallant Oxide au passage.

3. Téléchargez Oxide

Oxide est distribué via sa page officielle des versions (releases) sur GitHub. Sur cette page, choisissez la version la plus récente qui ne porte pas l'étiquette « Pre-release », puis téléchargez l'archive correspondant à votre système d'exploitation dans la section Assets :

https://github.com/OxideMod/Oxide.Rust/releases
ServeurFichierLien direct vers la dernière version
WindowsOxide.Rust.ziphttps://github.com/OxideMod/Oxide.Rust/releases/latest/download/Oxide.Rust.zip
LinuxOxide.Rust-linux.ziphttps://github.com/OxideMod/Oxide.Rust/releases/latest/download/Oxide.Rust-linux.zip

Les deux archives sont compilées séparément et ne sont pas interchangeables ; n'installez pas l'archive Windows sur un serveur Linux. Les versions d'Oxide sont numérotées au format 2.0.xxxx, et les notes de version indiquent pour quelle mise à jour de Rust chacune a été publiée. La procédure d'installation officielle se trouve dans la documentation d'installation d'Oxide.

4. Extrayez les fichiers dans le dossier du serveur

La racine de l'archive ne contient que le dossier RustDedicated_Data ; les fichiers d'Oxide vont dans le dossier Managed qu'il contient. Extrayez l'archive dans le dossier racine du serveur (celui qui contient RustDedicated.exe ou RustDedicated) et autorisez le remplacement des fichiers existants.

Windows

  1. Faites un clic droit sur le fichier Oxide.Rust.zip et utilisez Extract All (Extraire tout) pour l'extraire dans un dossier temporaire (par exemple le bureau).
  2. Copiez le dossier RustDedicated_Data extrait et collez-le dans C:\Rust\Server.
  3. Lorsque Windows vous interroge sur les fichiers portant le même nom, choisissez Replace the files in the destination (remplacer les fichiers dans la destination).

Après l'installation, le fichier C:\Rust\Server\RustDedicated_Data\Managed\Oxide.Rust.dll doit exister. Si vous collez par erreur le dossier à l'intérieur de RustDedicated_Data, vous obtenez un deuxième dossier imbriqué et Oxide ne se charge pas.

Linux

Connectez-vous avec l'utilisateur rust, puis téléchargez l'archive et extrayez-la dans le dossier du serveur :

cd ~
curl -fL -o Oxide.Rust-linux.zip https://github.com/OxideMod/Oxide.Rust/releases/latest/download/Oxide.Rust-linux.zip
unzip -o Oxide.Rust-linux.zip -d /home/rust/rustserver
ls /home/rust/rustserver/RustDedicated_Data/Managed/Oxide.Rust.dll

unzip -o remplace les fichiers existants sans poser de question. Si la dernière commande affiche le chemin du fichier, Oxide est en place.

5. Démarrez le serveur et vérifiez l'installation

Démarrez le serveur comme d'habitude : start.bat sous Windows, screen -S rust_server ~/start.sh sous Linux. Au premier démarrage, Oxide crée le dossier oxide et télécharge le compilateur dans le dossier du serveur (Oxide.Compiler.exe sous Windows, Oxide.Compiler sous Linux) ; vous le verrez dans les lignes de la console qui commencent par [CSharp].

Une fois le serveur démarré, tapez ceci dans la fenêtre du serveur sous Windows, ou dans votre outil RCON sous Linux :

oxide.version

Si la sortie contient une ligne de la forme Oxide.Rust Version: 2.0.xxxx, l'installation est terminée. Vous pouvez aussi exécuter la commande depuis la console F1 en jeu ; la version y est affichée avec une formulation différente. Par défaut, Oxide fait passer votre serveur dans l'onglet Modded de la liste des serveurs.

6. Découvrez le dossier oxide

Tous les fichiers des plugins sont conservés dans le dossier oxide, à l'intérieur du dossier du serveur :

Dossier / fichierContenuQuand l'utiliser
oxide/pluginsLes fichiers .cs des pluginsPour ajouter, mettre à jour ou supprimer des plugins
oxide/configLes réglages des plugins ; un fichier .json par plugin, portant son nomPour modifier les réglages d'un plugin
oxide/dataLes données persistantes des plugins ; les enregistrements de permissions et de groupes d'Oxide (oxide.users.data, oxide.groups.data)Généralement laissé tel quel ; toujours sauvegardé
oxide/langLes fichiers de langue des messages des plugins (dans des sous-dossiers comme oxide/lang/en)Pour traduire les messages des plugins
oxide/logsLes journaux d'Oxide et du compilateurQuand un plugin ne se charge pas
oxide/oxide.config.jsonLes réglages propres à OxidePour les réglages de liste des serveurs et de commandes de chat

7. Installez votre premier plugin

ExamplePlugin sert de nom d'exemple ; les étapes sont les mêmes pour tous les plugins.

  1. Téléchargez le plugin sur umod.org ou auprès d'un développeur de confiance ; vérifiez la date de dernière mise à jour et les commentaires sur sa page. Ne modifiez ni le nom ni l'extension du fichier.
  2. Placez le fichier ExamplePlugin.cs dans le dossier oxide/plugins. Sous Windows, vous pouvez le copier via RDP ; sous Linux, connectez-vous avec l'utilisateur rust dans un client SFTP comme WinSCP ou FileZilla et envoyez-le dans le dossier /home/rust/rustserver/oxide/plugins.
  3. Inutile de redémarrer le serveur : Oxide détecte le changement dans le dossier, compile le plugin et le charge. Une ligne commençant par Loaded plugin doit apparaître dans la console.
  4. Les plugins configurables créent le fichier oxide/config/ExamplePlugin.json lors de leur premier chargement. Après avoir modifié et enregistré le fichier, rechargez le plugin avec la première commande ci-dessous.
  5. Si le plugin utilise des permissions, accordez la permission à un groupe comme dans la deuxième commande. Les noms des permissions sont indiqués sur la page du plugin.
oxide.reload ExamplePlugin
oxide.grant group default exampleplugin.use

Le groupe default couvre toutes les personnes qui se connectent au serveur, et le groupe admin les joueurs que vous avez nommés admins avec ownerid. Les règles de syntaxe JSON, les groupes personnalisés comme VIP, le retrait de permissions et le débogage à partir des journaux sont expliqués pas à pas dans le guide des plugins Rust ; pour les droits d'administration, consultez le guide des commandes admin Rust. Pour supprimer un plugin, il suffit de supprimer son fichier .cs ; Oxide décharge le plugin, et son fichier de réglages reste dans oxide/config.

8. Réinstallez Oxide après une mise à jour de Rust

Lorsque Facepunch publie une mise à jour, SteamCMD remplace par les originaux les fichiers modifiés par Oxide ; vous devez donc réinstaller Oxide après chaque mise à jour du serveur. Les plugins, les réglages et les permissions restent dans le dossier oxide ; la réinstallation d'Oxide ne remplace que les fichiers situés sous RustDedicated_Data/Managed.

  1. Vérifiez sur la page des versions GitHub si une nouvelle version d'Oxide est sortie ; si ce n'est pas le cas, patientez.
  2. Arrêtez le serveur avec quit et sauvegardez le dossier oxide.
  3. Exécutez le script ci-dessous : il met d'abord Rust à jour, puis télécharge la dernière version d'Oxide et l'extrait par-dessus les fichiers.
  4. Démarrez le serveur et vérifiez la nouvelle version avec oxide.version.

La documentation d'Oxide recommande d'ajouter -beta public lors de la mise à jour avec SteamCMD ; le serveur reste ainsi sur la branche publique de Rust.

Windows : C:\Rust\update.bat

@echo off
C:\Rust\SteamCMD\steamcmd.exe +force_install_dir C:\Rust\Server\ +login anonymous +app_update 258550 -beta public +quit
powershell -NoProfile -Command "$ErrorActionPreference='Stop'; [Net.ServicePointManager]::SecurityProtocol='Tls12'; Invoke-WebRequest -UseBasicParsing -Uri 'https://github.com/OxideMod/Oxide.Rust/releases/latest/download/Oxide.Rust.zip' -OutFile 'C:\Rust\Oxide.Rust.zip'; Expand-Archive -Path 'C:\Rust\Oxide.Rust.zip' -DestinationPath 'C:\Rust\Server' -Force"
pause

-UseBasicParsing évite la demande de confirmation de sécurité de Windows PowerShell 5.1 ; la partie Tls12 impose TLS 1.2 pour la connexion à GitHub sur les anciennes versions de Windows Server. $ErrorActionPreference='Stop' empêche l'extraction de l'archive si le téléchargement échoue, -Force remplace les fichiers et pause garde la fenêtre ouverte.

Linux : ~/update.sh

#!/bin/bash
SERVER_DIR=/home/rust/rustserver
/usr/games/steamcmd +force_install_dir "$SERVER_DIR" +login anonymous +app_update 258550 -beta public +quit
curl -fL -o ~/Oxide.Rust-linux.zip https://github.com/OxideMod/Oxide.Rust/releases/latest/download/Oxide.Rust-linux.zip && unzip -o ~/Oxide.Rust-linux.zip -d "$SERVER_DIR"

&& garantit que l'archive n'est extraite que si le téléchargement a réussi. Rendez le script exécutable ; à chaque mise à jour, exécutez-le, puis redémarrez le serveur :

chmod +x ~/update.sh
~/update.sh
screen -S rust_server ~/start.sh

9. Alternative : un aperçu de Carbon

Carbon est un autre framework de modding pour Rust, qui se présente comme un remplaçant direct (drop-in) d'Oxide ; sa structure de dossiers et de plugins ressemble à celle d'Oxide. Testez néanmoins chaque plugin après le changement.

OxideCarbon
ArchiveOxide.Rust.zip / Oxide.Rust-linux.zipCarbon.Windows.Release.zip / Carbon.Linux.Release.tar.gz
Emplacement d'installationRustDedicated_Data/ManagedUn dossier carbon à la racine du serveur
Dossier des réglagesoxide/configcarbon/configs
Préfixe des commandesoxide. ou o.c.

Les deux ne fonctionnent pas ensemble dans la même installation. Si vous voulez changer, arrêtez le serveur, désactivez les scripts qui installent ou mettent à jour Oxide, lancez SteamCMD avec validate pour remettre les fichiers à l'état vanilla, puis installez Carbon. À son premier démarrage, Carbon copie dans son propre dossier les fichiers de réglages, de données, de langue et de permissions d'Oxide. Les détails se trouvent sur la page de Carbon sur la migration depuis Oxide.

Exemple de réglages et commandes de base

Les deux premières sections du fichier oxide/oxide.config.json ressemblent à ceci (les autres sections sont omises). Redémarrez le serveur après vos modifications.

{
  "Options": {
    "Modded": true,
    "PluginWatchers": true,
    "DefaultGroups": {
      "Players": "default",
      "Administrators": "admin"
    },
    "WebRequestIP": "0.0.0.0"
  },
  "Commands": {
    "Chat command prefixes": [
      "/"
    ]
  }
}
Commande / réglageRôle
oxide.version (o.version)Affiche la version d'Oxide installée.
oxide.pluginsListe les plugins avec leur version, leur auteur, le temps total passé dans les hooks et l'utilisation de la mémoire ; indique la raison de l'échec pour ceux qui n'ont pas pu se charger.
oxide.load / oxide.unload PluginNameCharge ou décharge le plugin.
oxide.reload PluginNameDécharge et recharge le plugin ; oxide.reload * les recharge tous.
oxide.grant / oxide.revokeAccorde ou retire une permission à un utilisateur ou à un groupe.
"Modded": trueAffiche le serveur dans l'onglet Modded ; avec false, il passe dans l'onglet Community.
"DefaultGroups"Les groupes dans lesquels sont placés tout le monde (default) et les admins (admin).
"Chat command prefixes"Le préfixe des commandes de chat ; la valeur par défaut est /.

Erreurs fréquentes

  • oxide.version n'est pas reconnu : les fichiers ont été extraits au mauvais endroit (un RustDedicated_Data imbriqué), ou la ligne SteamCMD du script de démarrage a remis les fichiers d'origine. Vérifiez si le dossier Managed contient Oxide.Rust.dll ; refaites les étapes 2 et 4.
  • Le serveur ne démarre plus après une mise à jour : les versions d'Oxide et de Rust ne correspondent pas ; attendez la nouvelle version d'Oxide et installez-la. En attendant, pour démarrer le serveur sans Oxide, lancez SteamCMD avec validate ; les fichiers reviennent à l'état vanilla et le dossier oxide reste en place, mais les plugins ne fonctionnent pas.
  • Un plugin ne se charge pas ou renvoie une erreur de compilation : oxide.plugins en indique la raison, et les détails se trouvent dans oxide/logs. Il s'agit peut-être d'une ancienne version du plugin qui n'a pas été mise à jour pour la dernière mise à jour de Rust ; téléchargez sa version actuelle.
  • Compiler may not be set as executable sous Linux : avec l'utilisateur rust, donnez au compilateur le droit d'exécution et redémarrez le serveur :
    chmod +x /home/rust/rustserver/Oxide.Compiler
  • Le compilateur ne peut pas être téléchargé ou ne démarre pas : vérifiez la connectivité HTTPS sortante ; dans son message d'erreur, Oxide indique l'adresse à laquelle télécharger le fichier manuellement et le chemin où l'enregistrer. Si le chemin du serveur contient une apostrophe ('), le compilateur ne s'exécute pas ; renommez le dossier.
  • Une modification des réglages ne prend pas effet : le JSON est peut-être invalide, ou le plugin a peut-être réécrit ses réglages en se déchargeant ; suivez l'ordre indiqué à l'étape de configuration du guide des plugins.
  • Une commande de plugin ne fonctionne pas : le plugin n'est peut-être pas chargé, la commande est peut-être mal saisie ou une permission manque. Vérifiez avec oxide.plugins et oxide.show user.

Questions fréquentes

L'installation d'Oxide fait-elle passer mon serveur dans la liste Modded ?

Oui, par défaut. Si le réglage Modded de oxide.config.json vaut false, le serveur apparaît dans l'onglet Community ; d'après l'avertissement d'Oxide, Facepunch n'y autorise toutefois que les outils d'administration qui n'affectent pas le gameplay.

Dois-je arrêter le serveur pour ajouter un plugin ?

Non. Oxide surveille le dossier oxide/plugins ; lorsqu'un fichier est ajouté, modifié ou supprimé, il charge, recharge ou décharge automatiquement le plugin. Pour installer ou mettre à jour Oxide lui-même, en revanche, le serveur doit être arrêté.

Mes plugins et mes réglages seront-ils supprimés après une mise à jour de Rust ?

Non, le dossier oxide reste en place ; seuls les fichiers du jeu modifiés par Oxide dans le dossier Managed reviennent à leur état d'origine. Une fois Oxide réinstallé, les plugins reprennent là où ils s'étaient arrêtés ; faites tout de même une sauvegarde avant la mise à jour.

Les plugins ralentissent-ils le serveur ?

Chaque plugin se branche sur les événements du jeu, et le temps que cela prend apparaît dans la sortie de oxide.plugins ; les plugins dont le temps de hook est élevé chargent le CPU. À mesure que le nombre de joueurs et de plugins augmente, la vitesse en monocœur du CPU devient déterminante. C'est pourquoi, pour un serveur Rust moddé, la gamme VDS AMD Ryzen 9 9950X, avec ses performances élevées en monocœur, est recommandée. Les détails se trouvent dans le guide des performances Rust.

Guides associés

Pour d'autres articles, parcourez la page des guides Rust.

Commentaires0

Pas encore de commentaire

Soyez le premier à partager votre avis.

Rejoignez la discussion

Veuillez vous connecter ou vous inscrire pour laisser un commentaire.

Ne manquez aucun article

Recevez nos derniers tutoriels, guides et actualités produit dans votre boîte de réception.

Votre abonnement à notre newsletter est confirmé.