Ce guide explique comment installer le framework de modding Oxide/uMod ou Carbon sur votre serveur Rust, ajouter des plugins communautaires et les gérer via la console. Pour la configuration générale du serveur et les variables de démarrage, consultez le Guide de configuration du serveur Rust.

Installation de Oxide/uMod ou Carbon

Oxide (maintenant maintenu sous le nom uMod) et Carbon sont des frameworks de modding pour Rust qui vous permettent d'installer des plugins créés par la communauté. Ces frameworks ajoutent des fonctionnalités telles que des systèmes économiques, des kits personnalisés, des récompenses de vote, des zones de protection PvE, et bien plus encore.

Vous n'avez pas besoin de téléverser de fichiers manuellement. Le framework de modding est installé automatiquement en définissant une seule variable de démarrage :

1. Arrêtez votre serveur depuis l'onglet Console de GPanel.
2. Connectez-vous à GPanel et allez dans l'onglet Startup.
3. Trouvez la variable FRAMEWORK et réglez-la sur :
   • oxide — pour Oxide/uMod (le framework le plus utilisé, avec la plus grande bibliothèque de plugins)
   • carbon — pour le framework Carbon (une alternative avec son propre écosystème de plugins)
   • vanilla — pour fonctionner sans framework de modding
4. Démarrez le serveur. Les fichiers du framework sont téléchargés et appliqués automatiquement. Au premier démarrage avec Oxide, la structure de répertoires oxide/ est générée.
5. Vérifiez dans le journal de la console qu'une ligne telle que Loaded plugin Oxide.Core apparaît pour confirmer qu'Oxide est actif.

Installation de plugins

Les plugins sont distribués sous forme de fichiers .cs (code source C#). Oxide les compile sur le serveur au moment de l'exécution — aucune pré-compilation n'est nécessaire.

1. Téléchargez le fichier .cs du plugin depuis umod.org ou une autre source de confiance.
2. Téléversez le fichier .cs dans le répertoire oxide/plugins/ de votre serveur en utilisant SFTP ou le gestionnaire de fichiers GPanel. Pour de l'aide avec SFTP, consultez Comment transférer des fichiers via SFTP.
3. Si le serveur est en cours d'exécution, le plugin sera détecté et compilé automatiquement en quelques secondes. Vous verrez une sortie dans la console confirmant son chargement, par ex. Loaded plugin MyPlugin v1.2.3 by Author.
4. Si le serveur n'est pas en cours d'exécution, le plugin sera chargé au prochain démarrage.

Structure des répertoires Oxide

oxide/
  plugins/
    MyPlugin.cs       <- place plugin files here
    AnotherPlugin.cs
  config/             <- auto-generated plugin config files
  data/               <- plugin data files
  logs/               <- plugin log files

Configuration des plugins

La plupart des plugins génèrent un fichier de configuration JSON dans oxide/config/ lors de leur premier chargement. Pour personnaliser un plugin :

1. Laissez le plugin se charger au moins une fois pour qu'il génère son fichier de configuration par défaut.
2. Arrêtez votre serveur (ou notez que certains plugins supportent le rechargement de configuration à chaud).
3. Ouvrez le fichier de configuration du plugin dans oxide/config/PluginName.json en utilisant le gestionnaire de fichiers GPanel ou SFTP.
4. Modifiez les paramètres et enregistrez le fichier.
5. Rechargez le plugin avec oxide.reload PluginName ou redémarrez le serveur.

Gestion des plugins via la console

Ces commandes peuvent être exécutées depuis la console GPanel ou via un client RCON. Pour la configuration RCON, consultez Accès RCON et commandes d'administration Rust.

Mise à jour des plugins

Pour mettre à jour un plugin vers une version plus récente :

1. Téléchargez le fichier .cs mis à jour depuis la page du plugin sur umod.org.
2. Téléversez le nouveau fichier dans oxide/plugins/, en écrasant le fichier existant.
3. Si le serveur est en cours d'exécution, Oxide détecte le changement de fichier et recompile et recharge automatiquement le plugin. Vous pouvez aussi exécuter oxide.reload PluginName.
4. Vérifiez la console pour d'éventuelles erreurs. Certaines mises à jour de plugins peuvent nécessiter des modifications du fichier de configuration dans oxide/config/.

Suppression de plugins

Pour supprimer complètement un plugin :

1. Exécutez oxide.unload PluginName pour décharger le plugin pendant que le serveur est en cours d'exécution.
2. Supprimez le fichier .cs de oxide/plugins/.
3. Supprimez éventuellement le fichier de configuration du plugin dans oxide/config/ et les fichiers de données dans oxide/data/ si vous n'en avez plus besoin.

Plugins populaires

Résolution des problèmes de plugins

Si vos plugins ne se chargent pas, vérifiez les points suivants :

• Confirmez qu'Oxide est installé et actif. Dans l'onglet Startup de GPanel, la variable FRAMEWORK doit être réglée sur oxide. Le journal de la console devrait afficher Loaded plugin Oxide.Core au démarrage.
• Les fichiers de plugins doivent être placés directement dans oxide/plugins/ avec l'extension exacte .cs. Les fichiers dans des sous-répertoires ou avec des extensions incorrectes sont ignorés.
• Vérifiez la console et oxide/logs/ pour les erreurs de compilation. Un plugin avec une erreur de syntaxe ne se chargera pas et le message d'erreur décrira le problème.
• Certains plugins ont des dépendances sur d'autres plugins (par ex. de nombreux plugins de boutique nécessitent Economics). Installez d'abord toutes les dépendances requises.

Pour d'autres problèmes courants de serveur, consultez Résolution des problèmes du serveur Rust.

Besoin d'aide ?

Si vous rencontrez un problème non couvert dans ce guide, notre équipe de support est disponible pour vous aider. Soumettez un ticket de support en incluant l'ID de votre serveur, une description du problème et toute sortie console pertinente.