Catalogue de tatouages

Le catalogue rassemble les tatouages de CXG Base et des packs que vous avez installés. Les packs externes sont facultatifs : vous pouvez choisir de n’en activer aucun, un seul ou plusieurs. Si un pack manque ou est arrêté, ses tatouages sont masqués dans la boutique et le catalogue CXG Base reste disponible.

Consultez aussi Introduction, Installation, Configuration, Intégrations et Interface.

Packs facultatifs

La configuration initiale comprend les sources facultatives suivantes :

ID	Ressource	Fichier du catalogue
`xgc-classic`	`xgc_TattooClasic`	`tatoo_clasic_full_packconfigdump.json`
`xgc-gangs`	`xgc_TattooGangs`	`gangs_full_packconfigdump.json`
`xgc-japanese-mafia`	`xgc_TattooJapaneseMafia`	`japanese_mafia_full_packconfigdump.json`
`xgc-police`	`xgc_TattooPolice`	`police_full_packconfigdump.json`
`xgc-world-countries`	`xgc_TattooWorldCountries`	`world_country_full_packconfigdump.json`
`cxg-blackout`	`CXGtatoo_balckout`	`blackout_full_packconfigdump.json`

Installez uniquement les packs que vous possédez et démarrez-les avant cxg-tattoos. Conservez le nom de la ressource et son chemin tels qu’ils existent sur votre serveur, en respectant les majuscules et minuscules. Pour masquer temporairement une source, définissez enabled sur false ; pour la réafficher, repassez-le à true et vérifiez que la ressource est démarrée.

CXG Base utilise shared/tattoos.json dans la ressource. La source native-game récupère les modèles des tatouages natifs du jeu et est désactivée par défaut. Pour l’utiliser, configurez également les sources de validation de native.serverMetas avec les ressources et fichiers réels de votre serveur. L’entrée d’exemple pointe vers tatto et shop_tattoo.meta ; elle ne suppose pas que cette ressource est installée. Activer enabled ne garantit pas à lui seul que ces modèles pourront être achetés.

Ajouter une source JSON

Chaque objet de Config.TattooCatalog.sources configure une source. Cet exemple suit la structure des ressources de pack et peut être adapté au nom réel de la ressource et à son fichier :

Code

{
    id = 'mi-pack',
    label = 'Mi Pack',
    color = '#62b6cb',
    enabled = true,
    resource = 'mi_pack',
    path = 'tattoos.json',
    thumbnailPattern = 'miniatures/{Name}.webp',
    root = { mode = 'auto', field = 'Overlays' },
    defaults = {
        collection = 'mi_pack_overlays',
        zone = 'ZONE_TORSO',
        price = 5000,
        requiredLevel = 1,
        overlayTarget = 'male',
    },
}

id doit identifier la source de manière stable ; label et color permettent de la reconnaître dans l’interface. resource et path pointent vers le JSON. Le fichier doit se trouver dans une ressource disponible. N’ajoutez pas deux fois le même modèle dans des sources différentes, sauf si vous voulez l’afficher en double ; deduplicateAcrossSources permet de supprimer les doublons entre sources.

Ces réglages généraux se trouvent dans Config.TattooCatalog :

Champ	Valeur initiale	Utilisation
`deduplicate`	`true`	Supprime les modèles en double dans une source.
`deduplicateAcrossSources`	`false`	Permet de conserver séparés les modèles de sources différentes.
`serverFallback`	`true`	Demande au serveur une source que le client ne peut pas lire.
`serverFallbackTimeoutMs`	`7000`	Délai d’attente maximal de cette requête, en millisecondes.

La lecture de secours ne rend pas disponible un pack arrêté.

Format de chaque tatouage

Le fichier peut être un tableau JSON ou un objet dont une propriété contient le tableau. Avec root.mode = 'auto', le lecteur accepte les deux formats ; avec root.mode = 'field', root.field indique où se trouve la liste. root.mode = 'array' impose un tableau à la racine.

Ce tableau montre le format JSON. La collection et les hashes de l’exemple sont fictifs : remplacez-les par les noms réels du pack installé. Ajouter une entrée JSON n’installe pas les overlays graphiques.

Code

[
  {
    "Collection": "mi_pack_overlays",
    "Name": "Rosa del desierto",
    "HashNameMale": "MP_MI_PACK_ROSE_M",
    "HashNameFemale": "MP_MI_PACK_ROSE_F",
    "Zone": "ZONE_TORSO",
    "Price": 5000,
    "Xp": 15,
    "RequiredLevel": 2
  }
]

Collection et au moins un hash d’overlay sont nécessaires pour identifier le modèle. Incluez HashNameMale et HashNameFemale si le tatouage possède une variante pour chaque personnage. Utilisez l’une de ces zones : ZONE_HEAD, ZONE_TORSO, ZONE_LEFT_ARM, ZONE_RIGHT_ARM, ZONE_LEFT_LEG ou ZONE_RIGHT_LEG. Name est le nom affiché à l’acheteur. Si vous omettez Price, le prix par défaut de la source est utilisé ; si vous omettez RequiredLevel, defaults.requiredLevel est utilisé, dont la valeur initiale est 1. L’XP peut être définie par le tatouage ou par la configuration des niveaux.

Pour les fichiers utilisant d’autres noms de champs, réglez fields dans Config.TattooCatalog. Chaque entrée de cette table est une liste d’alias consultés pour trouver la valeur correspondante. Par exemple, un fichier qui utilise OverlayHash, Cost et BodyZone peut être mappé ainsi :

Code

fields = {
    collection = { 'Collection', 'CollectionName' },
    name = { 'Name', 'DisplayName' },
    overlay = { 'OverlayHash' },
    hashNameMale = { 'MaleOverlay' },
    hashNameFemale = { 'FemaleOverlay' },
    zone = { 'BodyZone' },
    price = { 'Cost' },
    xp = { 'Xp', 'Experience' },
    requiredLevel = { 'RequiredLevel' },
}

Vous pouvez également attribuer des valeurs communes depuis rootFields, par exemple un nom de collection ou une zone définis une seule fois dans l’objet racine. Les defaults de chaque source complètent les valeurs manquantes. Si votre JSON contient un seul champ générique, comme OverlayHash, defaults.overlayTarget indique s’il doit être traité comme un tatouage masculin (male) ou féminin (female).

Les formats très différents peuvent être transformés à l’aide des fonctions facultatives converters.decode(decoded, settings) ou converters.entry(entry, context) dans la configuration. La première adapte le document entier ; la seconde adapte chaque modèle. Renvoyez une table contenant les champs préparés pour le mappage normal.

Miniatures

Pour utiliser les images fournies dans le même pack, conservez le dossier miniatures/ dans cette ressource et définissez un modèle tel que :

Code

thumbnailPattern = 'miniatures/{Name}.webp'

{Name}, {HashNameMale}, {HashNameFemale} et {HashName} sont remplacés par les données du tatouage. Le fichier obtenu doit exister dans la ressource, par exemple miniatures/Rosa del desierto.webp, et la ressource doit être démarrée. L’interface demande chaque miniature lorsqu’elle en a besoin ; ne copiez pas les images dans le paquet CXG.

Vous pouvez également définir Thumbnail ou ThumbnailUrl dans une entrée pour indiquer une image précise. Les URL http://, https:// et data: sont utilisées telles quelles. Le chemin d’une miniature locale d’un pack doit correspondre à son thumbnailPattern ; le fichier doit exister et la ressource doit pouvoir le servir à la NUI. Les ressources externes doivent conserver leur fichier dans le pack.

Modifications depuis la configuration et l’administration

Modifiez la configuration pour ajouter des sources, changer leur lecture, activer ou désactiver des packs et régler leurs valeurs par défaut. Utilisez l’administration du catalogue pour changer le nom, le prix, le niveau et la disponibilité des tatouages sans modifier le JSON. Les modifications administratives sont enregistrées et résistent aux synchronisations du catalogue. L’action de réinitialisation rétablit les valeurs de ce tatouage telles qu’elles sont définies par sa source.

Les tatouages déjà achetés par un joueur restent associés à son personnage même si le pack qui les fournissait est temporairement désactivé. Le pack reste absent de la boutique jusqu’à ce qu’il soit de nouveau disponible.