Metadata - Jaksam's Scripts

Wie man Spielern Metadaten anzeigt

Spielern bestimmte Metadaten anzuzeigen ist einfach. Zuerst musst du wissen, wie der Metadaten-Key heißt, den du anzeigen willst. Dazu kannst du im /inventory-Einstellungsmenü den “Debug-Modus” aktivieren und dann mit der Maus über das gewünschte Item fahren.

Für ein einzelnes Item hinzufügen

Um Spielern die Metadaten eines einzelnen Items anzuzeigen, kannst du diesen Code in der jeweiligen Item-Definition anpassen, in der Datei jaksam_inventory/_data/items.lua:

displayFields = {
    { field = 'YOUR_METADATA_KEY_HERE', label = 'TEXT YOU WANT HERE: ${value}'}, -- Zufälliges Beispiel
    { field = 'ammo', label = 'Ammo: ${value}'}, -- Nützlich bei Waffen (standardmäßig schon eingebaut)
    { field = 'plate', label = 'Plate: ${value}'}, -- Nützlich bei Fahrzeugschlüsseln
},

Für alle Item-Typen hinzufügen

Um Spielern die Metadaten eines ganzen Item-Typs anzuzeigen, ist die Methode zu 100 % identisch, nur dass du es in der Script.defaultsByType-Tabelle einträgst, in der Datei jaksam_inventory/_data/defaults.lua.

Optional: Metadatenwerte schöner darstellen

Manchmal willst du Metadaten Spielern in einer schöneren Form zeigen. Zum Beispiel, statt “weapon_pistol” anzuzeigen, willst du “Pistol” zeigen. Hier kommen Formatter ins Spiel!

Ein Formatter ist wie ein Übersetzer: er nimmt den Originalwert (z.B. weapon_pistol) und wandelt ihn in etwas Schöneres um (z.B. Pistol).

Du kannst eingebaute Formatter nutzen oder eigene in jaksam_inventory/_data/formatter.lua erstellen. So werden sie genutzt:

displayFields = {
    { field = 'item', label = 'Label: ${value}', formatterId = "itemNameToLabel"}, -- Ein Beispiel mit eingebautem Formatter
},

Wie man Standard-Metadaten für Items festlegt

Sollen Items bei der Erstellung bestimmte Standard-Metadatenwerte haben? Zum Beispiel sollen neue Waffen mit 50 % Haltbarkeit starten? So geht’s:

Adminmenü öffnen

Gib /inventory im Spiel ein, um das Adminmenü zu öffnen.

Item finden

Finde und klicke auf das Item, das du bearbeiten willst.

Metadata-Tab öffnen

Klicke auf den Tab “metadata”.

Werte setzen

Setze die gewünschten Metadatenwerte.

Erweitert – Templates für dynamische Metadaten nutzen

Manchmal willst du Metadaten, die sich abhängig von bestimmten Bedingungen ändern. Dafür kannst du Templates nutzen:

Metadata-Tab öffnen

Gehe zum selben Metadata-Tab im Item-Editor.

Zum Template-Typ wechseln

Ändere den Metadaten-Typ zu template.

Template wählen oder erstellen

Wähle entweder ein bestehendes Template oder erstelle dein eigenes in jaksam_inventory/_data/metadata_templates.lua.

Mit Templates kannst du Metadaten erstellen, die sich automatisch nach deinen eigenen Regeln aktualisieren!

Beispiel

Ein paar Beispiele, was mit dynamischen Metadata-Templates möglich ist:

Einem Personalausweis-Item eines Spielers Name, Geburtsdatum, Größe usw. zuweisen
Einer Waffe eine zufällige Haltbarkeit zuweisen
Einem Item das Erstellungsdatum zuweisen (beim ersten Erstellen des Items)

​Wie man Spielern Metadaten anzeigt

​Für ein einzelnes Item hinzufügen

​Für alle Item-Typen hinzufügen

​Optional: Metadatenwerte schöner darstellen

​Wie man Standard-Metadaten für Items festlegt

​Erweitert – Templates für dynamische Metadaten nutzen

​Beispiel

Wie man Spielern Metadaten anzeigt

Für ein einzelnes Item hinzufügen

Für alle Item-Typen hinzufügen

Optional: Metadatenwerte schöner darstellen

Wie man Standard-Metadaten für Items festlegt

Erweitert – Templates für dynamische Metadaten nutzen

Beispiel