La réponse rapide
Envoyez les fichiers de plugin .cs dans oxide/plugins. Leurs
réglages apparaissent dans oxide/config après la première exécution. Utilisez
oxide.reload PluginName pour appliquer des changements sans redémarrer, et
accordez les permissions à des groupes avec oxide.grant group (GROUP) (PERMISSION) plutôt qu'à des individus.
Points clés
- Trois dossiers : plugins, config, data. Chacun a un rôle précis.
- Les fichiers de config n'apparaissent qu'après la première exécution du plugin. Ne les créez pas à la main.
oxide.reloadbat le redémarrage pour presque tous les changements de plugin.- Accordez aux groupes, pas aux personnes. Cela s'adapte et reste vérifiable.
- La documentation propre à chaque plugin liste ses permissions. Lisez-la avant de deviner.
Les trois dossiers
uMod crée trois dossiers sur votre serveur, et savoir ce que fait chacun évite beaucoup de confusion par la suite.
oxide/plugins- Les fichiers de plugin eux-mêmes, en
.cs. Déposer un fichier ici le charge automatiquement. oxide/config- Les fichiers de configuration de la plupart des plugins. Ils sont générés par le plugin à la première exécution, pas fournis par vous.
oxide/data- Les données que certains plugins conservent entre les redémarrages, comme les fiches joueurs ou les soldes d'économie. Considérez cela comme la mémoire du plugin plutôt que quelque chose à modifier à la légère.
Un fichier de config manquant n'est pas un problème à corriger. Si vous venez d'envoyer un
plugin et que oxide/config n'a rien pour lui, c'est parce que le plugin n'a pas
encore tourné. Démarrez le serveur, laissez-le charger, et le fichier sera là.
Envoyer des plugins
-
Récupérez le fichier du plugin
Téléchargez le fichier
.csdepuis la bibliothèque de plugins uMod ou l'endroit où l'auteur le distribue. -
Envoyez-le dans oxide/plugins
Via le gestionnaire de fichiers ou en FTP. Envoyez le fichier
.cslui-même, pas une archive zip. -
Laissez-le charger
uMod détecte automatiquement les nouveaux fichiers. Surveillez la console pour une confirmation de chargement ou une erreur.
-
Configurez-le
Son fichier de config existera maintenant dans
oxide/config. Modifiez-le, puis exécutezoxide.reload PluginNamepour appliquer.
Chaque plugin sur le site uMod vient avec une description couvrant son installation, ses options de configuration et les permissions qu'il définit. Lisez cette page avant de commencer à deviner les réglages, car la plupart des questions que vous allez vous poser y trouvent déjà une réponse.
Les commandes dont vous avez besoin
| Commande | Ce qu'elle fait |
|---|---|
oxide.reload (PLUGIN NAME) | Recharge le plugin indiqué. |
oxide.unload (PLUGIN NAME) | Décharge le plugin indiqué. |
oxide.reload * | Recharge tous les plugins d'un coup. |
oxide.usergroup add (GROUP NAME) | Crée un nouveau groupe d'utilisateurs Oxide. |
oxide.grant group (GROUP NAME) (PERMISSION) | Accorde une permission à un groupe. |
oxide.grant user (USERNAME/STEAM64 ID) (PERMISSION) | Accorde une permission à un seul utilisateur. |
oxide.reload est celle qui change votre façon de travailler. Modifier une config
et recharger un seul plugin prend quelques secondes et ne déconnecte personne. Redémarrer le
serveur pour obtenir le même résultat coûte à vos joueurs un chargement de map et, si le seed a
changé, jusqu'à dix minutes.
Les groupes de permissions en pratique
Les permissions Oxide peuvent être accordées à un utilisateur individuel ou à un groupe. Les deux fonctionnent. Utilisez les groupes.
La raison, c'est la maintenance. Accordez dix permissions directement à cinq VIP et vous avez
cinquante attributions à suivre, et quand quelqu'un cesse d'être VIP, vous devez vous souvenir
des dix. Accordez les dix permissions à un groupe VIPs et ajouter ou retirer une
personne devient une seule commande.
-
Créez le groupe
oxide.usergroup add VIPs -
Accordez ses permissions au groupe
oxide.grant group VIPs kits.vip -
Ajoutez des personnes au groupe
Plutôt que de leur accorder des permissions individuellement. Leur accès suit alors la définition du groupe.
Exemples concrets
- Recharger un plugin que vous venez de mettre à jour
- Vous avez remplacé le fichier BetterChat, alors exécutez
oxide.reload BetterChat. Aucun redémarrage nécessaire. - Donner le noclip aux admins
oxide.grant group Admins noclip.usedonne cette permission à tout le monde dans le groupe Admins.- Créer un palier VIP
oxide.usergroup add VIPs, puis accordez-lui tout ce que le palier payant doit inclure.- Accorder quelque chose temporairement à une personne
oxide.grant user 76561198000000000 kits.event. Utilisez ceci avec parcimonie, et rappelez-vous que vous l'avez accordé.- Désactiver immédiatement un plugin qui pose problème
oxide.unload PluginName. Plus rapide et moins perturbant qu'un redémarrage, et cela vous dit immédiatement si ce plugin était le problème.
Des habitudes à prendre
- Sauvegardez avant de modifier les plugins
- Faites une copie de
oxide/avant d'ajouter ou de retirer quoi que ce soit. Restaurer un dossier est plus rapide que de reconstruire une configuration de mémoire. - Ajoutez un plugin à la fois
- Ajoutez, rechargez, surveillez la console et le FPS serveur, puis passez au suivant. Ajouter six plugins d'un coup et constater que le serveur ne va pas bien vous laisse avec six suspects.
- Surveillez la performance au fur et à mesure
- Les plugins sont l'influence principale sur la performance d'un serveur Rust, et un plugin qui a l'air anodin peut quand même vous coûter à chaque tick.
- Gardez les plugins à jour
- Vérifiez uMod après chaque mise à jour de Rust. Un plugin obsolète échoue à la compilation et l'erreur le nomme, ce qui est au moins facile à diagnostiquer.
- Lisez la console
- uMod est particulièrement bon pour vous dire ce qui a mal tourné. La plupart des problèmes de plugin sont déjà expliqués dans la sortie que vous n'avez pas encore fait défiler pour lire.
Pour approfondir le framework lui-même, la documentation officielle d'uMod est la source de référence. Si vous ne l'avez pas encore installé, commencez par notre guide sur l'installation d'uMod sur un serveur Rust.