Aller au contenu
← Toute la documentation

/// PLUGIN TIERS PRIS EN CHARGE

Image Library

Guide gratuit pour configurer ce plugin tiers dans le Hub. Le plugin s’installe séparément depuis sa source officielle.

Version
2.0.65
Framework
oxide
Fichier cible
oxide/config/ImageLibrary.json
Ouvrir le configurateur →Voir la fiche de configuration →Voir la source officielle ↗

Préparer votre fichier

  1. Vérifiez la version installée

    Ce guide décrit Image Library 2.0.65. Le configurateur doit utiliser cette même version.

  2. Importez votre configuration

    Ouvrez le configurateur et importez le JSON actuel. Pour une nouvelle installation, vous pouvez partir de l’exemple proposé.

  3. Modifiez et téléchargez

    Ajustez les réglages, corrigez les erreurs signalées et téléchargez le JSON. Gardez une copie de votre ancien fichier avant de le remplacer.

Votre configuration n’est pas sauvegardée sur le site. Conservez le fichier exporté ; il permet aussi de reprendre plus tard.

Réglages de cette version

Général 6
Stocker les avatars joueurs
Activé / désactivé · obligatoire

Télécharge et stocke les images d’avatar des joueurs.

Chemin JSONAvatars - Store player avatars
Clé API Steam
Texte · obligatoire

Clé API Web Steam utilisée pour les skins Workshop et les avatars. Traitez-la comme un secret.

Chemin JSONSteam API key (get one here https://steamcommunity.com/dev/apikey)
URL de base des icônes
Texte · obligatoire

Dossier web de base utilisé pour récupérer les icônes d’objets.

Chemin JSONURL to web folder containing all item icons
Afficher la progression
Activé / désactivé · obligatoire

Affiche la progression du chargement des images dans la console serveur.

Chemin JSONProgress - Show download progress in console
Intervalle des mises à jour
Nombre entier · obligatoire

Temps entre les notifications de progression dans la console.

Chemin JSONProgress - Time between update notifications
Images utilisateur
Valeur JSON · obligatoire

Associez chaque nom d’image à son URL source. Les noms déjà présents dans un fichier importé sont conservés.

Chemin JSONUser Images - Manually define images to be loaded
Version de configuration 3
Major
Nombre entier · obligatoire

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

Chemin JSONVersion → Major
Minor
Nombre entier · obligatoire

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

Chemin JSONVersion → Minor
Patch
Nombre entier · obligatoire

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

Chemin JSONVersion → Patch

Instructions du plugin

Image Library 2.0.65

Image Library télécharge et stocke des images pour d’autres plugins Rust. Il n’a pas de dépendance plugin obligatoire, mais il est souvent installé parce qu’un autre plugin dépend de son API. Exécutez-le avec Oxide.

Configuration

  • Avatars - Store player avatars active le téléchargement des avatars ; cela augmente les requêtes externes et les données d’image stockées.
  • Steam API key (get one here https://steamcommunity.com/dev/apikey) active les recherches de skins Steam Workshop et d’avatars. Gardez cette clé privée et ne placez jamais de vraie clé dans un exemple partagé.
  • URL to web folder containing all item icons choisit la source des icônes d’objets. Un endpoint indisponible ou non fiable peut casser ou remplacer les images téléchargées.
  • Progress - Show download progress in console contrôle les messages de progression. Progress - Time between update notifications règle leur intervalle ; des messages trop fréquents peuvent encombrer la console.
  • User Images - Manually define images to be loaded est une table dynamique nom-vers-URL. Elle reste lossless en JSON ; chaque entrée peut provoquer un téléchargement distant, donc vérifiez les destinations et la taille de la liste.
  • Version.Major, Version.Minor et Version.Patch sont gérés par le plugin. Laissez-les à 2.0.65 ; des marqueurs plus anciens peuvent déclencher une migration et le remplacement de réglages.

Fichier cible : oxide/config/ImageLibrary.json. Les fichiers de données d’images et les files de téléchargement ne font pas partie de ce bundle de configuration.

Installer le fichier

Après avoir conservé une copie de l’ancien fichier, placez le JSON exporté à cet emplacement sur votre serveur :

oxide/config/ImageLibrary.json

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