Skip to main content

​
Comment afficher les métadonnées aux joueurs

Afficher des métadonnées spécifiques aux joueurs est simple. Tout d’abord, tu dois connaître la clé de métadonnée que tu veux afficher. Pour cela, tu peux activer le “Debug mode” dans le menu de paramètres /inventory, puis survoler l’item dont tu veux voir les métadonnées.
Item debug settings screenshot
Item debug metadata screenshot

​
L’ajouter à un seul item

Pour montrer aux joueurs les métadonnées d’un seul item, tu peux ajouter et adapter ce code dans la définition de l’item, dans le fichier jaksam_inventory/_data/items.lua :
Single item display fields example

​
L’ajouter à tous les types d’items

Pour montrer aux joueurs les métadonnées de tout un type d’item, c’est exactement la même méthode, mais place-le dans la table Script.defaultsByType, dans le fichier jaksam_inventory/_data/defaults.lua.

​
Optionnel : rendre les valeurs de métadonnées plus jolies

Parfois tu veux afficher les métadonnées de manière plus jolie aux joueurs. Par exemple, au lieu d’afficher “weapon_pistol”, tu veux afficher “Pistol”. C’est là qu’interviennent les formatters !
Un formatter est comme un traducteur : il prend la valeur d’origine (par exemple weapon_pistol) et la convertit en quelque chose de plus joli (par exemple Pistol).
Tu peux utiliser les formatters intégrés ou en créer des personnalisés dans jaksam_inventory/_data/formatter.lua. Voici comment les utiliser :

​
Comment définir des métadonnées par défaut pour les items

Tu veux que les items aient certaines valeurs de métadonnées lors de leur création ? Par exemple, peut-être veux-tu que les nouvelles armes commencent avec 50% de durabilité. Voici comment faire :
1

Ouvre le menu admin

Tape /inventory en jeu pour ouvrir le menu admin.
2

Trouve l'item

Trouve et clique sur l’item que tu veux modifier.
3

Ouvre l'onglet metadata

Clique sur l’onglet “metadata”.
4

Définis les valeurs

Définis les valeurs de métadonnées que tu veux.

​
Avancé - Utiliser des templates pour des métadonnées dynamiques

Parfois tu veux des métadonnées qui changent selon certaines conditions. Pour cela, tu peux utiliser des templates :
1

Ouvre l'onglet metadata

Va dans le même onglet metadata dans l’éditeur d’item.
2

Passe au type template

Change le type de métadonnée en template.
3

Choisis ou crée un template

Sélectionne un template existant, ou crée le tien dans jaksam_inventory/_data/metadata_templates.lua.
Les templates te permettent de créer des métadonnées qui se mettent à jour automatiquement selon des règles que tu définis !

​
Exemple

Quelques exemples de ce que tu peux faire avec des templates de métadonnées dynamiques :
  • Attribuer à la carte d’identité d’un joueur son nom, sa date de naissance, sa taille, etc.
  • Attribuer une durabilité aléatoire à une arme
  • Attribuer la date de création à un item (la première fois qu’il est créé)