Configurer le CDN

Le CDN KLMSTUDIO héberge les images que votre serveur génère : vêtements, véhicules, emotes, photos d'identité, logos d'entreprise et miniatures d'intérieurs.

Chaque licence possède son propre espace CDN, identifié par un space ID. Les envois partent toujours dans votre espace, mais la base a besoin de cet identifiant pour aller relire les images en jeu. C'est tout le rôle du fichier configs/addons/cdn/sh_config.lua.

1. Récupérer votre space ID

Rendez-vous sur panel.klmstudios.fr
Cliquez sur l'onglet CDN dans la barre latérale
Sélectionnez votre licence
Copiez l'ID affiché dans le header (cliquez dessus pour copier)

2. Modifier le fichier

Chemin : core/configs/addons/cdn/sh_config.lua

Config.CDN = {
    animations = "VOTRE_ID",
    character = "VOTRE_ID",
    garage = "VOTRE_ID",
    society = "cmnmwae9601cmy1wkvjepawgy",
    shellbuilder = "VOTRE_ID",
    furniture = "VOTRE_ID",
    property = "VOTRE_ID",
}

Remplacez chaque VOTRE_ID par l'ID copié à l'étape précédente, puis redémarrez la ressource core.

3. Ce que contrôle chaque clé

Clé	Images concernées	Où elles apparaissent
`character`	Vêtements, accessoires, overlays de visage, et les photos d'identité	Magasins de vêtements, créateur de personnage, MDT
`garage`	Véhicules, un fichier par modèle	Garage, concessionnaire, MDT
`animations`	Aperçus des emotes	Menu d'animations
`shellbuilder`	Miniatures des shells	ShellBuilder
`property`	Miniatures des intérieurs de propriété	Immobilier, propriétés
`furniture`	Aperçus des meubles	Éditeur de mobilier
`society`	Logos d'entreprise livrés avec la base	Menus entreprise, MDT

Les clés sont séparées pour pouvoir pointer une catégorie vers un autre espace, par exemple garder les véhicules de KLMSTUDIO pendant que vous capturez vos propres vêtements. Dans la très grande majorité des cas, le même ID va dans toutes les clés sauf society.

Pour property, le jeton demandé au backend fait foi sur l'espace réellement utilisé : la valeur du fichier ne sert que de repli tant qu'aucun jeton n'a été obtenu.

4. Le cas de society

Les logos que vous importez depuis le SocietyBuilder partent automatiquement dans votre espace : il n'y a rien à configurer pour eux.

La clé society désigne un espace de repli, consulté uniquement quand un logo est absent du vôtre. C'est là que vivent les logos livrés avec la base. Y écrire votre propre ID supprime ce repli et fait disparaître ces logos d'origine.

5. D'où viennent les images

Clé	Génération
`character`, vêtements	Ressource `imagecapture` : `/capture-all`, `/capture-clothing`, `/capture-ped-props`, `/capture-headoverlays`
`character`, photos d'identité	Automatique, à la connexion du joueur
`garage`	Ressource `imagecapture` : `/captureveh`
`animations`	Ressource `imagecapture` : `/capture-emotes`
`shellbuilder`	Automatique, à l'enregistrement d'un intérieur
`society`	Automatique, à l'import d'un logo
`property`	Automatique, à l'enregistrement d'un intérieur de propriété
`furniture`	Ressource `imagecapture` : `/capture-furniture`

Changer les images des magasins de vêtements

6. Vérifier

Ouvrez cette adresse dans un navigateur, en remplaçant VOTRE_ID :

/klm-assets/cdn/VOTRE_ID/male_11_0.webp

Si l'image s'affiche, l'ID est bon. Sinon, reprenez dans l'ordre :

l'ID a été copié en entier, sans espace ni guillemet en trop ;
la ressource core a été redémarrée après la modification ;
la capture correspondante a bien été lancée : une image jamais générée reste introuvable, même avec le bon ID ;
la clé API est présente dans config.cfg, sans elle aucun envoi vers le CDN n'est autorisé, voir Clé API.