Aller au contenu
← Toute la documentation

/// PLUGIN TIERS PRIS EN CHARGE

Rust Kits

Guide gratuit pour configurer ce plugin tiers dans le Hub. Pour l’installer, utilisez sa fiche ou sa source officielle.

Préparer votre fichier

  1. Vérifiez la version installée

    Ce guide décrit Rust Kits 4.4.9. Le configurateur doit utiliser cette même version.

  2. Récupérez les réglages

    Cliquez sur Importer, puis Depuis mon serveur. Choisissez les fichiers et confirmez leur chargement. Sélectionner un serveur ne remplace pas le document ouvert. Vous pouvez aussi importer des fichiers de cet appareil ou une configuration depuis Mes projets.

  3. Modifiez et envoyez

    Ajustez les réglages, corrigez les erreurs, puis utilisez Envoyer pour transmettre les fichiers au serveur choisi. Un conflit bloque l’envoi jusqu’à votre décision. Vous pouvez toujours exporter seulement les fichiers dont vous avez besoin.

Les envois au serveur disposent de sauvegardes privées. Enregistrer conserve votre travail dans Mes projets ; cette action n’envoie rien au serveur. Un téléchargement permet aussi de reprendre sans connexion.

Réglages de cette version

Général 14
Commande chat des kits
Texte · obligatoire

Commande chat qui ouvre les kits, sans / initial. Choisissez un nom qui ne soit pas déjà utilisé par un autre plugin.

Chemin JSONKit chat command
Monnaie d’achat
Choix · obligatoire

Monnaie utilisée pour les kits payants : objets scrap, solde Economics ou points ServerRewards. Les deux dernières nécessitent leur plugin installé.

Chemin JSONCurrency used for purchase costs (Scrap, Economics, ServerRewards)

Valeurs possibles : Scrap, Economics, ServerRewards

Journaliser les kits distribués
Activé / désactivé · obligatoire

Journaliser les distributions de kits pour faciliter le suivi des réclamations et le diagnostic.

Chemin JSONLog kits given
Effacer les usages joueurs au wipe
Activé / désactivé · obligatoire

Effacer au wipe les données d’usage des joueurs, notamment les usages et délais des kits. Cela ne supprime pas les définitions des kits.

Chemin JSONWipe player data when the server is wiped
Utiliser l’interface Kits
Activé / désactivé · obligatoire

Ouvrir le menu graphique des kits. Désactivé, le plugin utilise son parcours de commandes/chat.

Chemin JSONUse the Kits UI menu
Filtrer les skins des joueurs
Activé / désactivé · obligatoire

Vérifier les droits du joueur avant de montrer ou distribuer un skin de kit, et remplacer les variantes d’objets non possédées lorsque PlayerDLCAPI le permet. Sans PlayerDLCAPI chargé, activer ce réglage n’effectue pas le contrôle.

Chemin JSONOnly show/give players skins that they are allowed to use (requires PlayerDLCAPI)
Autoriser les skins des kits pour les PNJ
Activé / désactivé · obligatoire

Autoriser les objets avec skin dans les kits attribués aux PNJ. Ce réglage ne remplace pas le contrôle des skins autorisés pour les joueurs.

Chemin JSONAllow NPCs to use skins in kits
Autoriser le choix des auto-kits
Activé / désactivé · obligatoire

Permettre aux joueurs de choisir si les auto-kits leur sont distribués à l’apparition. Cela ne crée pas de nouvel auto-kit.

Chemin JSONAllow players to toggle auto-kits on spawn
Afficher les kits sans permission
Activé / désactivé · obligatoire

Montrer aussi les kits auxquels un joueur n’a pas accès. Ils restent soumis à leur permission : visible ne signifie pas récupérable.

Chemin JSONShow kits with permissions assigned to players without the permission
Ignorer les restrictions pour les admins
Activé / désactivé · obligatoire

Permettre aux administrateurs de contourner les restrictions d’usage des kits. Ils doivent toujours disposer d’assez de place dans leur inventaire.

Chemin JSONPlayers with the admin permission ignore usage restrictions
Auto-kits par priorité
Liste · obligatoire

Noms exacts des kits à essayer automatiquement à l’apparition, dans l’ordre de priorité. Le plugin sélectionne le premier kit admissible ; l’ordre est important.

Chemin JSONAutokits ordered by priority
Délais après wipe
Valeur JSON · obligatoire

Empêcher la récupération de chaque kit nommé jusqu’à ce délai après le dernier wipe, en secondes. Ce n’est pas le délai entre deux récupérations : 3600 rend le kit indisponible pendant la première heure du wipe.

Chemin JSONPost wipe cooldowns (kit name | seconds)
Paramètres CopyPaste
Liste · obligatoire

Arguments transmis à CopyPaste pour les kits contenant une construction, par paires option/valeur. Ils nécessitent CopyPaste et un fichier de construction existant.

Chemin JSONParameters used when pasting a building via CopyPaste
Menus de kits HumanNPC
Valeur JSON · obligatoire

Choisir les kits proposés lorsqu’un joueur utilise chaque PNJ HumanNPC configuré. Les noms doivent désigner des kits existants ; leurs permissions et restrictions restent contrôlées. Cette table ne crée ni PNJ ni kit.

Chemin JSONKit menu items when opened via HumanNPC (NPC user ID | Items)
Options de l’interface 2
URL de l’image de kit par défaut
Texte · obligatoire

Illustrer les cartes de kits qui n’ont pas leur propre image. L’adresse directe est chargée via Image Library ; elle ne change pas les objets distribués.

Chemin JSONUI Options → Default kit image URL
URL de l’icône d’affichage du kit
Texte · obligatoire

Changer l’icône du petit bouton qui ouvre le détail d’un kit. L’adresse directe est chargée via Image Library ; le comportement du bouton reste inchangé.

Chemin JSONUI Options → View kit icon URL
Version de configuration 3
Version majeure
Choix · obligatoire

Repère interne du format de configuration. Conservez la valeur fournie pour cette version du plugin.

Chemin JSONVersion → Major

Valeurs possibles : 4

Version mineure
Choix · obligatoire

Repère interne du format de configuration. Conservez la valeur fournie pour cette version du plugin.

Chemin JSONVersion → Minor

Valeurs possibles : 4

Version corrective
Choix · obligatoire

Repère interne du format de configuration. Conservez la valeur fournie pour cette version du plugin.

Chemin JSONVersion → Patch

Valeurs possibles : 9

Pagination et titres de section 2
Couleur du fond (hexadécimal)
Texte · obligatoire

Recolorer les fonds des boutons de pagination et des titres de section, sans changer leurs actions. Saisissez une couleur #RRGGBB ; Alpha règle séparément la transparence.

Chemin JSONUI Options → Color 1 → Hex
Opacité
Nombre · obligatoire

Opacité de 0 à 1 pour les fonds des boutons de pagination et des titres de section. 0 rend le fond transparent, sans désactiver les actions ni nécessairement masquer le texte.

Chemin JSONUI Options → Color 1 → Alpha
Actions disponibles 2
Couleur du fond (hexadécimal)
Texte · obligatoire

Recolorer les fonds des boutons de récupération, achat, création, édition, sauvegarde et copie d’inventaire, sans changer leurs actions. Saisissez une couleur #RRGGBB ; Alpha règle séparément la transparence.

Chemin JSONUI Options → Color 2 → Hex
Opacité
Nombre · obligatoire

Opacité de 0 à 1 pour les fonds des boutons de récupération, achat, création, édition, sauvegarde et copie d’inventaire. 0 rend le fond transparent, sans désactiver les actions ni nécessairement masquer le texte.

Chemin JSONUI Options → Color 2 → Alpha
Fermer, revenir et effacer 2
Couleur du fond (hexadécimal)
Texte · obligatoire

Recolorer les fonds des boutons de fermeture, retour et effacement, sans changer leurs actions. Saisissez une couleur #RRGGBB ; Alpha règle séparément la transparence.

Chemin JSONUI Options → Color 3 → Hex
Opacité
Nombre · obligatoire

Opacité de 0 à 1 pour les fonds des boutons de fermeture, retour et effacement. 0 rend le fond transparent, sans désactiver les actions ni nécessairement masquer le texte.

Chemin JSONUI Options → Color 3 → Alpha
Noms de kit et zones de champs 2
Couleur du fond (hexadécimal)
Texte · obligatoire

Recolorer les fonds des noms de kit, sous-titres d’inventaire, libellés de champs et fenêtres contextuelles, sans changer leurs actions. Saisissez une couleur #RRGGBB ; Alpha règle séparément la transparence.

Chemin JSONUI Options → Color 4 → Hex
Opacité
Nombre · obligatoire

Opacité de 0 à 1 pour les fonds des noms de kit, sous-titres d’inventaire, libellés de champs et fenêtres contextuelles. 0 rend le fond transparent, sans désactiver les actions ni nécessairement masquer le texte.

Chemin JSONUI Options → Color 4 → Alpha
Fond des récupérations indisponibles 2
Couleur du fond (hexadécimal)
Texte · obligatoire

Recolorer les fonds des boutons de récupération indisponibles, sans changer leurs actions. Saisissez une couleur #RRGGBB ; Alpha règle séparément la transparence.

Chemin JSONUI Options → Disabled Color → Hex
Opacité
Nombre · obligatoire

Opacité de 0 à 1 pour les fonds des boutons de récupération indisponibles. 0 rend le fond transparent, sans désactiver les actions ni nécessairement masquer le texte.

Chemin JSONUI Options → Disabled Color → Alpha
Fond des cartes et barre supérieure 2
Couleur du fond (hexadécimal)
Texte · obligatoire

Recolorer les fonds des cartes et de la barre supérieure du menu des kits, sans changer leurs actions. Saisissez une couleur #RRGGBB ; Alpha règle séparément la transparence.

Chemin JSONUI Options → Panel Color → Hex
Opacité
Nombre · obligatoire

Opacité de 0 à 1 pour les fonds des cartes et de la barre supérieure du menu des kits. 0 rend le fond transparent, sans désactiver les actions ni nécessairement masquer le texte.

Chemin JSONUI Options → Panel Color → Alpha

Instructions du plugin

Rust Kits 4.4.9

Créez vos kits et configurez leur distribution sous Oxide. Le configurateur gère deux fichiers : les réglages dans oxide/config/Kits.json et le catalogue dans oxide/data/Kits/kits_data.json.

Créer un kit

  1. Dans Catalogue des kits, saisissez son nom puis cliquez sur Créer un kit.
  2. Ajoutez ses objets dans l’inventaire principal, les vêtements ou la ceinture. Le sélecteur d’objets fournit les noms Rust.
  3. Réglez sa description, son délai de réutilisation, son coût et ses restrictions si nécessaire. Le crayon permet de renommer le kit.
  4. Exportez les fichiers ou envoyez-les au serveur connecté. Rechargez Kits pour charger le catalogue.

Un emplacement ne peut accueillir qu’un objet : 24 emplacements dans l’inventaire principal, 8 pour les vêtements et 6 dans la ceinture. Les emplacements natifs commencent à 0. Les options avancées donnent accès aux skins, aux munitions et à la durabilité. Pour un nouvel objet, les deux valeurs de durabilité sont initialisées à 100 ; adaptez-les si votre kit exige une autre valeur. Les valeurs importées restent intactes.

Le bouton Exemples propose un kit de départ quotidien et un kit de construction utilisable avec /kit builder. Ces exemples comprennent le catalogue et ses réglages, prêts à exporter.

Menu, apparence et distribution

L’onglet Réglages contient la commande de chat, l’économie, les journaux, les auto-kits et les délais après wipe. Les listes d’auto-kits et les menus PNJ doivent utiliser les noms exacts de votre catalogue. Un auto-kit remplace l’inventaire de réapparition : vérifiez ce choix avant de l’activer. Pour bloquer un kit pendant une heure après le wipe, ajoutez son nom dans les délais après wipe avec la valeur 3600 (secondes).

Dans Apparence, modifiez les couleurs et images du menu. L’aperçu utilise les kits de votre catalogue ; son sélecteur permet de voir leur liste ou le contenu d’un kit. Les droits et délais restants d’un joueur ne sont pas simulés comme des données réelles.

Import et synchronisation

Importez votre fichier existant avant de modifier un catalogue de serveur : remplacer kits_data.json remplace l’ensemble des définitions. Le JSON seul et les archives ZIP avec leurs dossiers natifs sont pris en charge. La synchronisation utilise les mêmes fichiers, avec vérification des conflits.

Les utilisations et délais des joueurs dans oxide/data/Kits/player_data.json sont exclus de l’éditeur. La capture de votre inventaire ou d’un bâtiment CopyPaste nécessite toujours le serveur Rust.

Dépendances

ImageLibrary est obligatoire pour cette version. Economics ou ServerRewards sont requis si vous sélectionnez cette monnaie. PlayerDLCAPI sert au filtre de possession des skins ; CopyPaste et HumanNPC restent des intégrations optionnelles.

Référence : source uMod 4.4.9, licence MIT. Le catalogue et ses fichiers ont été revus le 15 octobre 2026. Cette documentation ne certifie pas la compatibilité Carbon.

Installer les fichiers

Avec un serveur connecté, cliquez sur Envoyer dans le configurateur. Le résultat indique si les fichiers ont été envoyés et si le plugin a été rechargé. Sans RCON, rechargez le plugin depuis votre panneau serveur après l’envoi.

Sans serveur connecté : Conservez une copie des fichiers actuels. Placez chaque fichier exporté dans le dossier indiqué avant l’export, ou reprenez les chemins du ZIP. Ne placez pas les données ou les traductions dans le dossier config.

Suivez les instructions du plugin ci-dessus pour ses dépendances et son rechargement. L’export ne connecte pas le site à votre serveur.

Guide de configuration et d’envoi →