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 un plugin Rust ? Configuration Oxide, permissions et erreurs

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

Dans ce guide, vous apprendrez à installer un plugin sur un serveur Rust équipé d'Oxide (uMod), à modifier le fichier de configuration JSON du plugin et à accorder des permissions à des joueurs ou à des groupes avec les commandes oxide.grant. Vous verrez ensuite comment maintenir les plugins à jour, diagnostiquer les problèmes grâce aux journaux du dossier oxide/logs et trouver le plugin qui ralentit le serveur.

Avant de commencer

  • Un serveur avec Oxide installé : lorsque vous tapez oxide.version dans la console du serveur, un numéro de version doit s'afficher. Si Oxide n'est pas encore installé, suivez d'abord le guide d'installation d'Oxide.
  • Accès aux fichiers : vous vous connectez à un VDS Windows avec le Bureau à distance (RDP) et à un VDS Linux en SSH ; pour transférer des fichiers vers Linux, vous pouvez utiliser un client SFTP comme WinSCP ou FileZilla. Les chemins des exemples suivent l'organisation du guide d'installation d'un serveur Rust : C:\Rust\Server sous Windows et /home/rust/rustserver sous Linux.
  • Accès à la console : sous Windows, vous tapez les commandes directement dans la fenêtre du serveur. Sous Linux, la console du serveur n'accepte pas de commandes ; vous utilisez donc un outil RCON (guide RCON). En tant qu'admin, vous pouvez aussi saisir les mêmes commandes dans la console F1 du jeu.
  • Droits d'administrateur : les joueurs que vous nommez admin avec ownerid sont automatiquement ajoutés au groupe admin d'Oxide. Les niveaux de droits sont expliqués dans le guide des commandes admin Rust.
  • Sauvegarde : les sauvegardes automatiques ne sont pas incluses dans les offres VDS. Copiez le dossier oxide avant toute modification ; pour des sauvegardes régulières, vous pouvez utiliser l'espace de sauvegarde cloud, accessible en SFTP.

1. Découvrez les dossiers d'Oxide

Dans le dossier racine du serveur (celui qui contient RustDedicated), Oxide crée un dossier oxide : C:\Rust\Server\oxide sous Windows et /home/rust/rustserver/oxide sous Linux.

Dossier / fichierContenuModifié à la main ?
pluginsLes fichiers sources .cs des pluginsOn se contente d'ajouter ou de remplacer des fichiers
configLe fichier de réglages de chaque plugin, qui porte son nom (PluginName.json)Oui
dataLes données des plugins (maisons des joueurs, utilisation des kits) ; les permissions se trouvent dans les fichiers oxide.users.data et oxide.groups.dataNon
langLes messages des plugins, dans des dossiers portant le code de la langue (en, fr)Oui
logsLes fichiers journauxLecture seule
oxide.config.jsonLes réglages propres à OxideSi nécessaire ; lu au démarrage du serveur

2. Téléchargez le plugin et placez-le dans le dossier plugins

Les plugins sont distribués sous forme de fichiers sources C# (.cs), qu'Oxide compile lui-même pendant que le serveur tourne. La principale source de plugins gratuits est le site uMod. Avant de télécharger un plugin, vérifiez sur sa page la date de la dernière mise à jour, les commentaires et les dépendances (les autres plugins dont il a besoin). Ne renommez pas le fichier : Oxide identifie un plugin par son nom de fichier.

Vous pouvez copier le fichier dans le dossier oxide/plugins par RDP ou SFTP, ou le télécharger directement sur le serveur. L'exemple télécharge le plugin Auto Doors, qui ferme automatiquement les portes. Sous Windows, avec PowerShell (la première ligne active TLS 1.2 sur les anciennes versions de Windows Server) :

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Invoke-WebRequest -UseBasicParsing -Uri https://umod.org/plugins/AutoDoors.cs -OutFile C:\Rust\Server\oxide\plugins\AutoDoors.cs

Sous Linux, avec l'utilisateur rust :

wget -O /home/rust/rustserver/oxide/plugins/AutoDoors.cs https://umod.org/plugins/AutoDoors.cs

Inutile d'arrêter le serveur. Oxide repère le nouveau fichier, le compile et le charge ; dans la console, une ligne du type Loaded plugin Auto Doors v… by … apparaît. Pour lister les plugins chargés :

oxide.plugins

La liste indique aussi les plugins qui n'ont pas pu être chargés, avec la raison de l'échec. Pour charger, recharger et décharger un plugin manuellement, utilisez oxide.load AutoDoors, oxide.reload AutoDoors et oxide.unload AutoDoors ; le nom doit correspondre au nom du fichier sans l'extension.

3. Modifiez le fichier de configuration

Au premier chargement, les plugins configurables écrivent dans le dossier oxide/config un fichier JSON qui porte leur nom : pour AutoDoors.cs, il s'agit de AutoDoors.json. Si aucun fichier n'apparaît, soit le plugin n'a pas de réglages, soit il n'a pas pu être chargé ; consultez le journal (étape 7).

Dans Gather Manager, qui modifie les taux de récolte des ressources, ce réglage se trouve dans GatherManager.json, dans la section Options, sous la clé GatherResourceModifiers, et il est vide au départ ({}). Saisissez les ressources sous leur nom anglais dans le jeu et attribuez un multiplicateur à chacune ; la clé * s'applique à toutes les ressources que vous n'avez pas définies séparément. La section doit ressembler à ceci :

"GatherResourceModifiers": {
  "Wood": 3.0,
  "Stones": 3.0,
  "Metal Ore": 2.5,
  "Sulfur Ore": 2.0,
  "*": 2.0
}

La commande gather.resources, dans la console du serveur, liste les noms de ressources valides. Le même réglage peut aussi être donné depuis la console, et le plugin écrit lui-même la valeur dans le fichier : gather.rate dispenser Wood 3 (dispenser désigne les ressources que l'on récolte en les frappant, comme les arbres et le minerai).

Si un fichier enfreint les règles du JSON, le plugin risque de ne pas se charger ou de revenir à ses réglages par défaut. Les erreurs fréquentes sont une virgule en trop ou manquante, un guillemet, une accolade ou un crochet non fermé et l'emploi de guillemets simples ('). Le texte s'écrit entre guillemets doubles, tandis que les nombres et true/false s'écrivent sans guillemets ; le séparateur décimal est le point (2.5). Après l'enregistrement, appliquez la modification :

oxide.reload GatherManager

Certains plugins réécrivent leurs réglages sur le disque lorsqu'ils sont déchargés ; dans ce cas, oxide.reload peut écraser votre modification. Si un réglage revient sans cesse à son ancienne valeur, exécutez d'abord oxide.unload GatherManager, modifiez ensuite le fichier, puis chargez le plugin avec oxide.load GatherManager.

4. Configurez les permissions et les groupes

Les permissions Oxide sont des noms de la forme pluginname.permission (nom du plugin, puis permission), par exemple autodoors.use. Une permission n'existe que tant que le plugin qui la définit est chargé ; si le plugin n'est pas chargé, oxide.grant ne trouve pas la permission. Oxide est fourni avec deux groupes : default regroupe toutes les personnes qui se connectent au serveur, et admin les admins définis avec ownerid.

L'exemple ci-dessous crée un groupe VIP, y ajoute un joueur et distribue des permissions. Saisir le joueur par son identifiant Steam64 plutôt que par son nom évite les confusions avec des joueurs aux noms similaires :

oxide.group add vip "VIP" 0
oxide.usergroup add 76561198123456789 vip
oxide.grant group vip autodoors.use
oxide.grant group default nteleportation.home
oxide.grant group admin kits.admin

Auto Doors ne tient compte de cette permission que si le fichier AutoDoors.json contient le réglage "Use permissions": true ; avec la valeur par défaut false, tout le monde peut l'utiliser. Commandes de vérification et d'annulation :

oxide.show groups
oxide.show group vip
oxide.show user 76561198123456789
oxide.show perm autodoors.use
oxide.show perms
oxide.revoke group vip autodoors.use
oxide.usergroup remove 76561198123456789 vip

Les groupes peuvent hériter des permissions les uns des autres : si vous créez un groupe avec oxide.group add moderator, puis tapez oxide.group parent moderator vip, les modérateurs reçoivent aussi toutes les permissions du groupe VIP. Le caractère générique (*) accorde plusieurs permissions à la fois ; oxide.grant group admin kits.* active toutes les permissions du plugin Kits. En revanche, oxide.grant group default * donne à chaque joueur toutes les permissions, outils d'administration compris ; ne l'utilisez pas. Toutes les commandes sont décrites dans la documentation d'Oxide sur les permissions.

5. Traduisez les messages des plugins en français

Les plugins qui prennent en charge la localisation écrivent leurs messages dans un fichier qui porte leur nom, oxide/lang/en/PluginName.json. Pour le français, créez dans oxide/lang un dossier fr, copiez-y le fichier anglais et traduisez uniquement les valeurs :

{
  "Hello": "Bonjour",
  "WelcomeMessage": "Bienvenue sur le serveur {0} !"
}

Ne touchez pas aux clés de gauche ni aux espaces réservés comme {0}. Enregistrez le fichier en UTF-8 ; sinon, les lettres accentuées comme é, è, à ou ç risquent de s'afficher de façon illisible. Vous définissez la langue par défaut du serveur avec oxide.lang fr dans la console du serveur ; les joueurs peuvent choisir leur propre langue en tapant /lang fr dans le chat.

6. Maintenez les plugins et Oxide à jour

Pour mettre à jour un plugin, il suffit de remplacer l'ancien fichier .cs par le nouveau ; Oxide détecte la modification et recharge le plugin, et les fichiers de configuration et de données sont conservés. Sous Linux, utilisez toujours wget avec -O : sans cette option, si le fichier existe déjà, la nouvelle version est enregistrée sous le nom AutoDoors.cs.1, Oxide ne la voit pas et l'ancienne version continue de tourner.

Chaque mise à jour du serveur Rust publiée par Facepunch s'accompagne d'une nouvelle version d'Oxide, et les deux doivent être compatibles. Une mise à jour SteamCMD remet les fichiers du serveur dans leur état d'origine (vanilla) ; vos plugins et vos réglages restent dans le dossier oxide, mais ils ne se chargent pas tant qu'Oxide n'est pas réinstallé. Après chaque mise à jour de Rust, installez la nouvelle version d'Oxide, puis vérifiez dans la sortie de oxide.plugins si des plugins n'ont pas pu être chargés ; une nouvelle version du plugin en échec est peut-être déjà disponible.

Pour supprimer un plugin, déplacez son fichier .cs hors du dossier plugins ; Oxide décharge alors le plugin. Les fichiers de configuration et de données restent en place. Exemple sous Linux :

mkdir -p /home/rust/disabled
mv /home/rust/rustserver/oxide/plugins/AutoDoors.cs /home/rust/disabled/

7. Lisez les erreurs dans le journal d'Oxide

Chaque jour, Oxide ouvre un nouveau journal dans le dossier oxide/logs, nommé oxide_YYYY-MM-DD.txt. Les erreurs de compilation, les erreurs que génèrent les plugins pendant leur exécution et les avertissements de lenteur y sont consignés ; le journal détaillé du compilateur se trouve dans le fichier oxide.compiler_YYYY-MM-DD.log du même dossier. Sous Linux, pour suivre en direct le journal du jour et rechercher les erreurs passées :

tail -n 50 -f /home/rust/rustserver/oxide/logs/oxide_$(date +%F).txt
grep -i "error" /home/rust/rustserver/oxide/logs/oxide_*.txt | tail -n 30

Sous Windows, pour suivre les dernières lignes du journal le plus récent avec PowerShell :

Get-ChildItem C:\Rust\Server\oxide\logs\oxide_*.txt | Sort-Object LastWriteTime | Select-Object -Last 1 | Get-Content -Tail 50 -Wait

Les lignes que l'on recherche le plus souvent dans le journal sont Error while compiling (le plugin n'a pas pu être compilé), Failed to call hook (le plugin a généré une erreur pendant son exécution) et requires missing dependency (une dépendance est manquante).

8. Mesurez l'impact des plugins sur les performances

Les plugins fonctionnent en se greffant sur les événements du jeu grâce à des hooks : un joueur qui subit des dégâts, une structure qui est construite, etc. Dans la sortie de oxide.plugins, deux valeurs apparaissent entre parenthèses à côté de chaque plugin : le temps total passé dans ses hooks (en secondes) et la mémoire allouée par ces hooks. Consultez la liste lorsque le serveur a tourné un moment avec des joueurs ; un plugin qui a accumulé nettement plus de temps que les autres est votre premier suspect.

Oxide écrit aussi dans le journal un avertissement de la forme suivante chaque fois qu'un seul appel de hook dure plus de 100 millisecondes :

Calling 'OnEntityTakeDamage' on 'ExamplePlugin v1.0.0' took 150ms

Un avertissement occasionnel n'est pas un problème, mais des avertissements répétés pour le même plugin peuvent se traduire par du lag pour les joueurs. Arrêtez temporairement le plugin suspect avec oxide.unload et observez la différence, supprimez les plugins que vous n'utilisez pas et ne faites pas tourner deux plugins qui font le même travail. Vous pouvez suivre l'utilisation du CPU et de la mémoire dans les graphiques d'utilisation en temps réel de l'Espace client. Si les mesures révèlent un manque de ressources, envisagez de passer à une offre supérieure pour votre serveur Rust ; pour les réglages côté serveur, consultez le guide sur les performances d'un serveur Rust.

Exemple de configuration : types de plugins populaires

Les plugins ci-dessous sont des exemples de types courants sur uMod. Les noms des permissions peuvent changer d'une version à l'autre ; après l'installation, vérifiez-les avec oxide.show perms.

TypePlugin (fichier)RôlePermission / commande
Taux de récolteGather Manager (GatherManager.cs)Multiplicateurs pour la récolte, les carrières (quarries) et le ramassagePas de permission ; gather.rate nécessite les droits d'administrateur
TéléportationNTeleportation (NTeleportation.cs)/sethome, /home ; demande avec /tpr, acceptation avec /tpanteleportation.home, nteleportation.tpr
Kit de départKits (Kits.cs)Menu /kit ; création de kits avec /kit newkits.admin ; une permission distincte par kit, comme kits.vip
Chat et titresBetter Chat (BetterChat.cs)Titres et couleurs dans le chat selon les groupes Oxidebetterchat.admin (commande /chat)
ConfortAuto Doors (AutoDoors.cs)Ferme les portes après quelques secondes ; /adautodoors.use (si l'utilisation des permissions est activée)

Dans le fichier oxide/oxide.config.json, deux réglages de la section Options sont importants : PluginWatchers (par défaut true) surveille le dossier plugins et charge automatiquement les plugins ; Modded (par défaut true) signale votre serveur comme moddé dans la liste des serveurs. Lorsque Modded est désactivé, Oxide écrit dans le journal que Facepunch n'autorise, dans la catégorie « Community » (serveurs communautaires), que les outils d'administration qui n'influent pas sur le gameplay ; laissez true pour les plugins qui modifient le gameplay.

Erreurs fréquentes

  • Error while compiling AutoDoors : le plugin est incompatible avec la version actuelle de Rust ou d'Oxide, ou le fichier est corrompu ; la ligne suivante indique où se situe le problème. Téléchargez la dernière version du plugin et vérifiez qu'Oxide est lui aussi à jour.
  • Plugin filename AutoDoors (1).cs must match the main class AutoDoors : le nom du fichier ne correspond pas au nom de classe du plugin. Renommez le fichier avec le nom proposé à la fin de la ligne (AutoDoors.cs).
  • Lignes contenant plugin requires missing dependency : le plugin a besoin d'un autre plugin, dont le nom figure à la fin de la ligne ; ajoutez-le lui aussi au dossier plugins.
  • Permission 'autodoors.use' doesn't exist : le nom de la permission est mal orthographié ou le plugin n'est pas chargé. Vérifiez avec oxide.plugins et oxide.show perms.
  • Group 'vip' doesn't exist : créez le groupe avec oxide.group add vip avant d'accorder des permissions.
  • Multiple players were found, please specify : le nom du joueur correspond à plusieurs personnes. Saisissez l'identifiant Steam64 au lieu du nom.
  • Permissions must start with the 'kits.' prefix : la permission que vous attribuez à un kit dans l'éditeur de Kits doit commencer par le nom du plugin ; au lieu de vip, écrivez kits.vip.
  • Compiler may not be set as executable sous Linux : le compilateur d'Oxide n'est pas exécutable. Exécutez chmod +x /home/rust/rustserver/Oxide.Compiler et redémarrez le serveur.

Questions fréquentes

Faut-il redémarrer le serveur pour installer un plugin ?

Non. Les plugins .cs s'ajoutent, se mettent à jour et se suppriment pendant que le serveur tourne. Les extensions sont un cas à part : elles se présentent sous forme de fichiers .dll, se placent dans le dossier RustDedicated_Data/Managed et, pour la plupart, ne se chargent qu'au redémarrage du serveur.

Les données des plugins sont-elles supprimées lors d'un wipe de map ?

La suppression des fichiers de la map ne touche pas au dossier oxide/data. Certains plugins ont leur propre réglage à ce sujet : Wipe player data when the server is wiped dans Kits et Clear data on map wipe dans Auto Doors. Vérifiez ces réglages avant un wipe ; si vous ne voulez pas que les données soient réinitialisées, laissez-les sur false.

Combien de plugins puis-je installer ?

Oxide n'impose pas de limite fixe ; ce qui compte, c'est la quantité de travail effectuée par les plugins. Quelques plugins lourds peuvent ajouter plus de charge que de nombreux plugins légers. Ajoutez les nouveaux plugins un par un et vérifiez les mesures de l'étape 8.

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é.