Aller au contenu
← Toute la documentation

/// PLUGIN TIERS PRIS EN CHARGE

Image Library

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 Image Library 2.0.67. 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 6
Stocker les avatars joueurs
Activé / désactivé · obligatoire

Télécharger et conserver les avatars Steam pour les plugins qui les demandent. Une clé API Steam est nécessaire ; sans elle, aucun avatar n’est récupéré. L’activation augmente les requêtes externes et les images stockées.

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

Changer la source des icônes d’objets fournies aux autres plugins. Image Library ajoute le nom court de l’objet et .png à cette adresse : conservez le / final. Une source indisponible peut empêcher l’affichage des icônes.

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

Espacer les messages de progression du stockage des images dans la console, en secondes. Cela ne ralentit pas les téléchargements ; le réglage n’agit que si l’affichage de progression est activé.

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

Précharger des images nommées que les autres plugins peuvent récupérer dans Image Library. Chaque nom est associé à une adresse directe d’image ; une entrée vide est ignorée. Vérifiez les destinations externes avant d’ajouter une grande liste.

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

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

Chemin JSONVersion → Major
Version mineure
Nombre entier · obligatoire

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

Chemin JSONVersion → Minor
Version corrective
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.67

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.67 ; 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 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 →