> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jaksam-scripts.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Metadata

> Item-Metadaten für Spieler anzeigen und Standard- oder dynamische Metadatenwerte festlegen

## 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.

<Columns cols={2}>
  <Frame>
    <img src="https://mintcdn.com/jaksam/CFF8PxdulGaP6e6O/images/metadata-debug-settings.png?fit=max&auto=format&n=CFF8PxdulGaP6e6O&q=85&s=904f67f1891cac22409ad36b4cc8e1f2" alt="Item debug settings screenshot" width="599" height="491" data-path="images/metadata-debug-settings.png" />
  </Frame>

  <Frame>
    <img src="https://mintcdn.com/jaksam/CFF8PxdulGaP6e6O/images/metadata-debug-item.png?fit=max&auto=format&n=CFF8PxdulGaP6e6O&q=85&s=37ebea9038e695660b268ab44c7f9647" alt="Item debug metadata screenshot" width="323" height="336" data-path="images/metadata-debug-item.png" />
  </Frame>
</Columns>

### 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`:

```lua theme={null}
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
},
```

<Frame>
  <img src="https://mintcdn.com/jaksam/CFF8PxdulGaP6e6O/images/metadata-single-item-example.png?fit=max&auto=format&n=CFF8PxdulGaP6e6O&q=85&s=6858d303f7d559e89eb8cd1a896bd567" alt="Single item display fields example" width="1130" height="645" data-path="images/metadata-single-item-example.png" />
</Frame>

### 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!

<Tip>
  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`).
</Tip>

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

```lua theme={null}
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:

<Steps>
  <Step title="Adminmenü öffnen">
    Gib `/inventory` im Spiel ein, um das Adminmenü zu öffnen.
  </Step>

  <Step title="Item finden">
    Finde und klicke auf das Item, das du bearbeiten willst.
  </Step>

  <Step title="Metadata-Tab öffnen">
    Klicke auf den Tab "metadata".
  </Step>

  <Step title="Werte setzen">
    Setze die gewünschten Metadatenwerte.
  </Step>
</Steps>

### 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:

<Steps>
  <Step title="Metadata-Tab öffnen">
    Gehe zum selben Metadata-Tab im Item-Editor.
  </Step>

  <Step title="Zum Template-Typ wechseln">
    Ändere den Metadaten-Typ zu `template`.
  </Step>

  <Step title="Template wählen oder erstellen">
    Wähle entweder ein bestehendes Template oder erstelle dein eigenes in `jaksam_inventory/_data/metadata_templates.lua`.
  </Step>
</Steps>

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)


## Related topics

- [Set item metadata in slot](/de/jaksam-inventory/functions/server/set-item-metadata-in-slot.md)
- [Get total item amount](/de/jaksam-inventory/functions/client/get-total-item-amount.md)
- [Register usable item](/de/jaksam-inventory/functions/server/register-usable-item.md)
- [Remove item](/de/jaksam-inventory/functions/server/remove-item.md)