Aller au contenu
← Toute la documentation

/// PLUGIN TIERS PRIS EN CHARGE

Backpacks

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 Backpacks 3.17.8. 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 3
Déposer à la mort
Activé / désactivé · obligatoire

Déposer le sac à dos dans le monde à la mort du joueur. Si l’effacement à la mort est activé, l’effacement est prioritaire et le contenu est perdu.

Chemin JSONDrop on Death (true/false)
Effacer à la mort
Activé / désactivé · obligatoire

Effacer le contenu du sac à dos à chaque mort. C’est destructif et prioritaire sur le dépôt du sac à la mort.

Chemin JSONErase on Death (true/false)
Délai minimal de disparition (secondes)
Nombre · obligatoire

Délai minimum avant disparition d’un sac déposé, en secondes. Il donne aux joueurs du temps pour récupérer le contenu après une mort.

Chemin JSONMinimum Despawn Time (Seconds)

Minimum : 0

Taille du sac à dos 4
Emplacements par défaut
Nombre entier · obligatoire

Nombre d’emplacements accordé en l’absence d’une permission de taille plus grande. Comptez les emplacements, pas les lignes de six cases.

Chemin JSONBackpack size → Default size

Minimum : 1

Emplacements maximum par page
Nombre entier · obligatoire

Nombre maximum d’emplacements sur chaque page du sac, jusqu’à 48. Un sac plus grand utilise plusieurs pages, il n’est pas réduit à cette taille.

Chemin JSONBackpack size → Max size per page

Minimum : 1 · Maximum : 48

Activer les anciennes permissions de lignes
Activé / désactivé · obligatoire

Reconnaître les anciennes permissions backpacks.use.1 à .8, exprimées en lignes. Désactivez si vous utilisez uniquement les permissions de taille actuelles.

Chemin JSONBackpack size → Enable legacy backpacks.use.1-8 row permissions
Tailles par permission
Liste · obligatoire

Créer des capacités de sac attribuables par permission backpacks.size.<nombre>, en emplacements. Avec plusieurs permissions de taille, la plus grande capacité est retenue ; ajouter un nombre ici n’accorde pas la permission aux joueurs.

Chemin JSONBackpack size → Permission sizes
Effacement au wipe 3
Activer l’effacement au wipe
Activé / désactivé · obligatoire

Appliquer les règles de nettoyage des sacs lors du wipe. Vérifiez ce qui est conservé avant activation : le nettoyage peut supprimer les objets.

Chemin JSONClear on wipe → Enabled
Activer l’ancienne permission keeponwipe
Activé / désactivé · obligatoire

Reconnaître l’ancienne permission backpacks.keeponwipe qui permet de conserver le contenu au wipe, en plus du système de règles actuel.

Chemin JSONClear on wipe → Enable legacy keeponwipe permission
Règles de conservation par permission
Valeur JSON · obligatoire

Attribuer des règles de conservation au wipe avec backpacks.keeponwipe.<Name>. Si plusieurs permissions correspondent, la dernière règle de la liste est retenue ; les règles ne se fusionnent pas. Sans correspondance, les règles par défaut s’appliquent.

Chemin JSONClear on wipe → Rulesets by permission
Pagination du sac 2
Boutons de page sur la barre
Activé / désactivé · obligatoire

Placer les boutons de changement de page sur la barre du conteneur du sac plutôt qu’à leur autre emplacement.

Chemin JSONContainer UI → Show page buttons on container bar
Nombre maximal de boutons de page
Nombre entier · obligatoire

Limiter le nombre de boutons numérotés autour de la page active du sac. Les flèches permettent de parcourir les pages non montrées ; une valeur négative montre toutes les pages. Cela ne réduit pas la capacité du sac.

Chemin JSONContainer UI → Max page buttons to show
Bouton du sac 5
Activer le bouton
Activé / désactivé · obligatoire

Autoriser le bouton d’ouverture du sac dans l’interface. Le joueur doit toujours avoir les permissions nécessaires pour l’utiliser.

Chemin JSONGUI Button → Enabled
Affiché par défaut
Activé / désactivé · obligatoire

Afficher le bouton par défaut pour les joueurs autorisés, avant leur choix personnel d’affichage.

Chemin JSONGUI Button → Enabled by default (for players with permission)
ID du skin
Nombre entier · obligatoire

Afficher le skin de sacoche choisi sur le bouton d’ouverture du sac. Toute valeur non nulle utilise ce skin et ignore Image ; mettez 0 pour utiliser l’image distante à la place.

Chemin JSONGUI Button → Skin Id

Minimum : 0

URL de l’image
Texte · obligatoire

Remplacer l’illustration du bouton d’ouverture du sac par une image distante, seulement si Skin Id vaut 0. Utilisez une adresse directe d’image accessible aux joueurs ; sinon ce champ n’a pas d’effet visible.

Chemin JSONGUI Button → Image
Couleur d’arrière-plan
Texte · obligatoire

Teinter le fond du bouton d’ouverture du sac, sans recolorer son illustration. Les quatre valeurs Rust sont rouge, vert, bleu et opacité entre 0 et 1 ; une opacité de 0 cache le fond.

Chemin JSONGUI Button → Background Color
Restrictions d’objets 4
Activer les restrictions
Activé / désactivé · obligatoire

Vérifier les règles autorisant ou interdisant le stockage d’objets dans le sac. Désactivez pour ne pas appliquer ce filtrage.

Chemin JSONItem restrictions → Enabled
Activer l’ancienne permission noblacklist
Activé / désactivé · obligatoire

Reconnaître l’ancienne permission backpacks.noblacklist permettant de contourner les restrictions d’objets.

Chemin JSONItem restrictions → Enable legacy noblacklist permission
Effet de refus d’objet
Texte · obligatoire

Chemin de l’effet Rust joué lorsqu’un objet est refusé par les restrictions. Utilisez un effet existant du jeu, pas une adresse d’image.

Chemin JSONItem restrictions → Feedback effect
Règles par permission
Valeur JSON · obligatoire

Attribuer des règles de stockage avec backpacks.restrictions.<Name>. Si plusieurs permissions correspondent, la dernière règle de la liste est retenue ; les règles ne se fusionnent pas. Sans correspondance, les règles par défaut s’appliquent.

Chemin JSONItem restrictions → Rulesets by permission
Mode Softcore 1
Proportion récupérée
Nombre · obligatoire

Part du contenu récupérable par le système Softcore après une mort. 0 = rien, 0.5 = moitié, 1 = totalité ; ne concerne que ce mode de jeu.

Chemin JSONSoftcore → Reclaim Fraction

Minimum : 0 · Maximum : 1

Taille dynamique (expérimental) 2
Activer la taille dynamique
Activé / désactivé · obligatoire

Activer les profils de capacité qui peuvent évoluer pour chaque joueur. Fonction expérimentale : les capacités acquises sont des données du plugin, pas de ce JSON.

Chemin JSONBackpack size → Dynamic Size (EXPERIMENTAL) → Enabled
Profils de taille
Valeur JSON · obligatoire

Chaque profil crée une permission backpacks.size.profile.<suffixe>. La capacité gagnée par chaque joueur est enregistrée séparément par le plugin.

Chemin JSONBackpack size → Dynamic Size (EXPERIMENTAL) → Size profiles
Règles de wipe par défaut 8
Suffixe de permission
Texte

Nom de cette règle de conservation au wipe. Les règles nommées servent aussi à identifier les permissions de règle.

Chemin JSONClear on wipe → Default ruleset → Name
Emplacements maximum à conserver
Nombre entier · obligatoire

Nombre maximum d’emplacements à conserver après le nettoyage au wipe. -1 signifie sans limite ; 0 ne conserve aucun emplacement.

Chemin JSONClear on wipe → Default ruleset → Max slots to keep

Minimum : -1

Catégories autorisées
Valeur JSON · obligatoire

Catégories Rust pouvant être conservées au wipe. All autorise toutes les catégories sous réserve des exclusions. Une liste vide n’autorise aucun objet par catégorie : il faut alors une autorisation par objet ou skin.

Chemin JSONClear on wipe → Default ruleset → Allowed item categories
Catégories bloquées
Valeur JSON · obligatoire

Catégories d’objets à supprimer au wipe selon cette règle. Utilisez les noms exacts des catégories Rust.

Chemin JSONClear on wipe → Default ruleset → Disallowed item categories
Noms courts d’objets autorisés
Liste · obligatoire

Autoriser ces objets par leur nom court avant les contrôles de catégorie, sauf interdiction prioritaire par skin ou par ce même nom court. Cela peut autoriser un objet d’une catégorie interdite.

Chemin JSONClear on wipe → Default ruleset → Allowed item short names
Noms courts d’objets interdits
Liste · obligatoire

Noms courts d’objets à exclure de la conservation au wipe. Ne saisissez pas leurs noms affichés traduits.

Chemin JSONClear on wipe → Default ruleset → Disallowed item short names
IDs de skins autorisés
Liste · obligatoire

Autoriser les objets portant ces skins avant les contrôles de nom court et de catégorie, sauf si le même skin est explicitement interdit. Une autorisation de skin peut donc passer outre une catégorie interdite.

Chemin JSONClear on wipe → Default ruleset → Allowed skin IDs
IDs de skins interdits
Liste · obligatoire

Identifiants de skins interdits par cette règle. Laissez vide si aucune variante de skin ne doit être exclue.

Chemin JSONClear on wipe → Default ruleset → Disallowed skin IDs
Position du bouton GUI 4
Coin bas gauche
Texte · obligatoire

Place ce coin dans l’écran. X : gauche (0) à droite (1). Y : bas (0) à haut (1). Les deux coins déterminent la taille de la zone.

Chemin JSONGUI Button → GUI Button Position → Anchors Min
Coin haut droit
Texte · obligatoire

Place ce coin dans l’écran. X : gauche (0) à droite (1). Y : bas (0) à haut (1). Les deux coins déterminent la taille de la zone.

Chemin JSONGUI Button → GUI Button Position → Anchors Max
Décalage bas gauche
Texte · obligatoire

Décale ce coin en pixels. X positif déplace vers la droite, Y positif vers le haut.

Chemin JSONGUI Button → GUI Button Position → Offsets Min
Décalage haut droit
Texte · obligatoire

Décale ce coin en pixels. X positif déplace vers la droite, Y positif vers le haut.

Chemin JSONGUI Button → GUI Button Position → Offsets Max
Règles d’objets par défaut 7
Suffixe de permission
Texte

Nom de cette règle de stockage. Les règles nommées servent aussi à identifier les permissions de règle.

Chemin JSONItem restrictions → Default ruleset → Name
Catégories autorisées
Valeur JSON · obligatoire

Catégories Rust admises dans le sac. All autorise toutes les catégories sous réserve des exclusions. Une liste vide n’autorise aucun objet par catégorie : il faut alors une autorisation par objet ou skin.

Chemin JSONItem restrictions → Default ruleset → Allowed item categories
Catégories bloquées
Valeur JSON · obligatoire

Catégories d’objets interdites dans le sac. Utilisez les noms exacts des catégories Rust.

Chemin JSONItem restrictions → Default ruleset → Disallowed item categories
Noms courts d’objets autorisés
Liste · obligatoire

Autoriser ces objets par leur nom court avant les contrôles de catégorie, sauf interdiction prioritaire par skin ou par ce même nom court. Cela peut autoriser un objet d’une catégorie interdite.

Chemin JSONItem restrictions → Default ruleset → Allowed item short names
Noms courts d’objets interdits
Liste · obligatoire

Noms courts d’objets interdits dans le sac. Ne saisissez pas leurs noms affichés traduits.

Chemin JSONItem restrictions → Default ruleset → Disallowed item short names
IDs de skins autorisés
Liste · obligatoire

Autoriser les objets portant ces skins avant les contrôles de nom court et de catégorie, sauf si le même skin est explicitement interdit. Une autorisation de skin peut donc passer outre une catégorie interdite.

Chemin JSONItem restrictions → Default ruleset → Allowed skin IDs
IDs de skins interdits
Liste · obligatoire

Identifiants de skins interdits par cette règle. Laissez vide si aucune variante de skin ne doit être exclue.

Chemin JSONItem restrictions → Default ruleset → Disallowed skin IDs
Réinitialisation de la taille dynamique au wipe 1
Réinitialiser au wipe
Activé / désactivé · obligatoire

Réinitialiser la capacité dynamique acquise au wipe. Cela concerne la taille gagnée, indépendamment des règles de conservation des objets.

Chemin JSONBackpack size → Dynamic Size (EXPERIMENTAL) → Reset dynamic size on wipe → Enabled

Instructions du plugin

Backpacks 3.17.8

Configurez gratuitement Backpacks sous Oxide avec le fichier oxide/config/Backpacks.json. Ce guide correspond à la version officielle uMod 3.17.8 observée le 2026-10-11, sous licence MIT.

Backpacks ajoute de l’espace d’inventaire avec une capacité par permission, des restrictions optionnelles et des règles de mort/wipe. Avec un serveur connecté en SFTP, Installer récupère la version proposée depuis uMod. Modifier ou exporter sa configuration n’accorde pas de permissions et ne change pas les objets des joueurs.

Revu le 2026-10-11, avec la source officielle exacte 3.17.8. Cette version adapte les callbacks d’inventaire à Rust ; la configuration, les valeurs par défaut, permissions, commandes et les 33 messages de langue restent identiques à 3.17.6. Vos configurations 3.17.6 n’ont pas besoin de conversion. Le guide officiel de WhiteThunder décrit l’installation et l’utilisation.

Taille du sac à dos

Backpack size contient Default size, Max size per page (maximum 48), l’option des anciennes permissions de lignes et Permission sizes. Chaque taille génère une permission backpacks.size.<nombre>.

Le groupe avancé Dynamic Size (EXPERIMENTAL) contient Enabled, Reset dynamic size on wipe > Enabled et Size profiles. Chaque profil possède Permission suffix, Initial size et Max size, et génère backpacks.size.profile.<suffixe>.

Mort, interface et Softcore

  • Drop on Death (true/false), Erase on Death (true/false) et Minimum Despawn Time (Seconds) contrôlent la gestion de la mort.
  • GUI Button contrôle l’activation, le défaut des nouveaux joueurs, Skin Id, Image, Background Color et les quatre chaînes d’ancrage/décalage de GUI Button Position.
  • Container UI détermine si les boutons de page partagent la barre du conteneur et combien sont visibles.
  • Softcore > Reclaim Fraction accepte les valeurs de 0 à 1.

Ces réglages décrivent l’interface Rust propre à Backpacks. Modifiez-les dans le configurateur, pas dans PimpMyCUI Editor ; ils ne sont pas au format PimpMyCUI.

Restrictions d’objets

Item restrictions contient Enabled, l’option de l’ancienne permission noblacklist, Feedback effect, Default ruleset et Rulesets by permission. Chaque règle contient les catégories Rust, shortnames et IDs de skins autorisés/interdits. Les règles par permission exigent aussi Name et génèrent backpacks.restrictions.<nom>.

Effacement au wipe

Clear on wipe contient Enabled, l’option de l’ancienne permission keeponwipe, Default ruleset et Rulesets by permission. Les règles de wipe ajoutent Max slots to keep ; -1 signifie sans limite. Les entrées nommées génèrent backpacks.keeponwipe.<nom>.

Configuration et données des joueurs

Les tailles de permission, profils de taille et règles nommées sont des listes de configuration de longueur variable, mais les données des joueurs ne sont pas stockées ici. Le contenu des sacs est enregistré par joueur dans le répertoire de données Oxide Backpacks ; les préférences d’interface et la capacité dynamique acquise sont également conservées dans des fichiers séparés. Le configurateur modifie uniquement Backpacks.json, pas les identifiants des joueurs, le contenu des sacs, leurs préférences ou leur capacité acquise.

Source officielle : https://umod.org/plugins/backpacks

Migration

Les anciennes clés des versions antérieures à 3.9 servent uniquement à la migration par Backpacks. La version 3.17.8 ne les écrit plus dans sa configuration ; le configurateur ne les propose donc pas.

Recette : commencer avec 18 emplacements

  1. Réglez Backpack size > Default size à 18, gardez Max size per page à 48 et laissez la taille dynamique désactivée.
  2. Après application du fichier exporté, accordez backpacks.use au groupe choisi. Accordez séparément backpacks.gui pour afficher le bouton activé.
  3. Rechargez Backpacks et testez /backpack avec un joueur ordinaire sans permission de taille concurrente.

Pour une capacité propre à un groupe, vérifiez plutôt que 18 existe dans Permission sizes et accordez backpacks.size.18. Les permissions s’appliquent sur le serveur, pas par l’export JSON.

Recette : déposer les objets à la mort

  1. Réglez Drop on Death (true/false) à true et Erase on Death (true/false) à false.
  2. Gardez initialement Minimum Despawn Time (Seconds) à 300 et vérifiez les exemptions voulues via backpacks.keepondeath.
  3. Sur un serveur de test, placez un objet jetable dans le sac et vérifiez la mort, la récupération et la disparition avec un joueur non exempté.

Si les deux options valent true, l’effacement est prioritaire. backpacks.keepondeath exempte le joueur du dépôt et de l’effacement. Ces tests peuvent perdre des objets ; n’utilisez pas ceux de joueurs actifs.

Permissions et limites

  • backpacks.use : ouvrir son sac ; backpacks.gui : voir le bouton activé.
  • backpacks.size.<emplacements> : utiliser une capacité de Permission sizes.
  • backpacks.keepondeath : conserver les objets malgré les règles de mort.
  • backpacks.admin : commandes d’administration et modification des sacs d’autres joueurs. Réservez-la au personnel de confiance ; des permissions admin plus ciblées existent en amont.

Une page contient au plus 48 emplacements. La taille dynamique est expérimentale, sans progression intégrée ; les intégrations de progression sont séparées. Oxide est le framework vérifié ; ce guide ne prouve pas la compatibilité Carbon ou avec de futures versions Rust. Cette revue éditoriale n’a pas exécuté le plugin en jeu.

Questions

Pourquoi un joueur a-t-il plus d’emplacements que le défaut ?

La permission backpacks.size.<emplacements> la plus élevée prime sur le défaut. En mode dynamique, les profils accordés priment sur les tailles fixes ; plusieurs profils utilisent les capacités initiale et maximale les plus élevées.

L’export efface-t-il les sacs ?

Non. L’export télécharge seulement Backpacks.json. Clear on wipe > Enabled vaut false par défaut ; l’activer change les prochains wipes selon les règles et exemptions. Les objets, préférences et capacités acquises ne sont pas exportés.

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 →