Comment installer Oxide (uMod) sur un serveur Rust ? Windows et Linux
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 deRustDedicated.exe) sous Windows et/home/rust/rustserversous Linux ; l'identité du serveur estmyserver. Si les vôtres sont différents, adaptez les chemins. - unzip sous Linux : nécessaire pour extraire l'archive d'Oxide. Comme l'utilisateur
rustn'a pas les droitssudo, installez-le depuis une session root :sudo apt install unzip - Accès HTTPS sortant : à chaque démarrage, Oxide vérifie le programme
Oxide.Compilerqui compile les plugins et le télécharge depuisdownloads.oxidemod.comsi 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/myserveravant de commencer et, une fois Oxide installé, sauvegardez aussi régulièrement le dossieroxide.
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
quitdans la fenêtre du serveur ; comme la bouclegoto startrelancerait le serveur, fermez aussi la fenêtre une fois le serveur arrêté. - Linux : envoyez
quitdepuis votre outil RCON (administration à distance). Le serveur enregistre puis s'arrête, et la sessionscreense 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.batdans le « Notepad » (Bloc-notes) et supprimez la ligne qui commence parC:\Rust\SteamCMD\steamcmd.exe. La ligneRustDedicated.exeet la bouclegoto startrestent. - Linux : ouvrez-le avec
nano ~/start.shet supprimez la ligne qui commence par/usr/games/steamcmd. Les lignesSERVER_DIR=,cd,export LD_LIBRARY_PATHet./RustDedicateddoivent rester. La lignecdest importante, car Oxide crée le dossieroxidedans 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
| Serveur | Fichier | Lien direct vers la dernière version |
|---|---|---|
| Windows | Oxide.Rust.zip | https://github.com/OxideMod/Oxide.Rust/releases/latest/download/Oxide.Rust.zip |
| Linux | Oxide.Rust-linux.zip | https://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
- Faites un clic droit sur le fichier
Oxide.Rust.zipet utilisez Extract All (Extraire tout) pour l'extraire dans un dossier temporaire (par exemple le bureau). - Copiez le dossier
RustDedicated_Dataextrait et collez-le dansC:\Rust\Server. - 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 / fichier | Contenu | Quand l'utiliser |
|---|---|---|
oxide/plugins | Les fichiers .cs des plugins | Pour ajouter, mettre à jour ou supprimer des plugins |
oxide/config | Les réglages des plugins ; un fichier .json par plugin, portant son nom | Pour modifier les réglages d'un plugin |
oxide/data | Les 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/lang | Les fichiers de langue des messages des plugins (dans des sous-dossiers comme oxide/lang/en) | Pour traduire les messages des plugins |
oxide/logs | Les journaux d'Oxide et du compilateur | Quand un plugin ne se charge pas |
oxide/oxide.config.json | Les réglages propres à Oxide | Pour 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.
- 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.
- Placez le fichier
ExamplePlugin.csdans le dossieroxide/plugins. Sous Windows, vous pouvez le copier via RDP ; sous Linux, connectez-vous avec l'utilisateurrustdans un client SFTP comme WinSCP ou FileZilla et envoyez-le dans le dossier/home/rust/rustserver/oxide/plugins. - 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 plugindoit apparaître dans la console. - Les plugins configurables créent le fichier
oxide/config/ExamplePlugin.jsonlors de leur premier chargement. Après avoir modifié et enregistré le fichier, rechargez le plugin avec la première commande ci-dessous. - 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.
- Vérifiez sur la page des versions GitHub si une nouvelle version d'Oxide est sortie ; si ce n'est pas le cas, patientez.
- Arrêtez le serveur avec
quitet sauvegardez le dossieroxide. - 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.
- 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.
| Oxide | Carbon | |
|---|---|---|
| Archive | Oxide.Rust.zip / Oxide.Rust-linux.zip | Carbon.Windows.Release.zip / Carbon.Linux.Release.tar.gz |
| Emplacement d'installation | RustDedicated_Data/Managed | Un dossier carbon à la racine du serveur |
| Dossier des réglages | oxide/config | carbon/configs |
| Préfixe des commandes | oxide. 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églage | Rôle |
|---|---|
oxide.version (o.version) | Affiche la version d'Oxide installée. |
oxide.plugins | Liste 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 PluginName | Charge ou décharge le plugin. |
oxide.reload PluginName | Décharge et recharge le plugin ; oxide.reload * les recharge tous. |
oxide.grant / oxide.revoke | Accorde ou retire une permission à un utilisateur ou à un groupe. |
"Modded": true | Affiche 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.versionn'est pas reconnu : les fichiers ont été extraits au mauvais endroit (unRustDedicated_Dataimbriqué), ou la ligne SteamCMD du script de démarrage a remis les fichiers d'origine. Vérifiez si le dossierManagedcontientOxide.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 dossieroxidereste en place, mais les plugins ne fonctionnent pas. - Un plugin ne se charge pas ou renvoie une erreur de compilation :
oxide.pluginsen indique la raison, et les détails se trouvent dansoxide/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 executablesous Linux : avec l'utilisateurrust, 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.pluginsetoxide.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
- Comment installer un serveur Rust ? Guide SteamCMD pour Windows et Linux
- Comment installer un plugin Rust ? Configuration Oxide, permissions et erreurs
- Commandes admin Rust et attribution des droits (auth level)
- Ouvrir les ports d'un serveur Rust et l'administrer à distance en toute sécurité avec RCON
- Comment corriger le lag d'un serveur Rust ? FPS, entités et plugins
Pour d'autres articles, parcourez la page des guides Rust.
Commentaires0
Pas encore de commentaire
Soyez le premier à partager votre avis.
Veuillez vous connecter ou vous inscrire pour laisser un commentaire.