# catalogue.json: PlayDrop-Spielmetadaten und Lokalisierung

Referenz für Spieltitel, Beschreibungen, Genre-Tags, Bilder und Videos des Spieleintrags, Übersetzungen und das optionale Feld server im Format von PlayDrop Connector.

Source: https://www.playdrop.ai/de/docs/catalogue-json

[PlayDrop Connector](https://www.playdrop.ai/de/docs/connectors) veröffentlicht Ihr Spiel mit einer kleinen `catalogue.json`: einem JSON-Objekt mit `apps`, das genau ein Spiel enthält. Nur `name` ist erforderlich. Der Agent sendet sie als Katalog-Argument zusammen mit den Spieldateien; ein Kommandozeilentool ist nicht nötig. PlayDrop Cloud pflegt diese Metadaten für Sie.

## Minimales Beispiel für die Veröffentlichung

Lassen Sie den kleingeschriebenen Slug bei Updates unverändert. Ergänzen Sie nach Bedarf einen Anzeigetitel, eine zutreffende Beschreibung, die Steuerung, die Ausgangssprache und bekannte Tags. Das folgende Beispiel verwendet das vorhandene Genre-Tag für Plattformer.

```json
{
  "apps": [{
    "name": "moon-jump",
    "displayName": "Moon Jump",
    "description": "Jump between lunar platforms and reach the finish.",
    "controls": "Arrow keys to move. Space to jump.",
    "sourceLocale": "en",
    "tags": ["game-genre/platformer"]
  }]
}
```

## Unterstützte Felder und Grenzwerte

`name`: 1–100 Kleinbuchstaben, Ziffern oder Bindestriche, beginnend mit einem Buchstaben oder einer Ziffer. `displayName`: nicht leerer Titel. `subtitle`: bis zu 120 Zeichen. `description`: bis zu 3.000 Zeichen Markdown, ohne H1-Überschriften, eingebettete Medien oder Tabellen. `inspirationPrompt`: bis zu 400 Zeichen einzeiliger Klartext. Textlimits werden in JavaScript-UTF-16-Codeeinheiten gezählt.

Zu den optionalen Feldern gehören `controls`, `releaseNotes`, `makingOf`, `emoji`, `color`, `sourceRepository`, `license`, `tags`, `sourceLocale`, `listingLocalizations`, `listingMedia` und `server`. Tags verwenden bestehende Referenzen im Format `group-slug/tag-slug`; zulässig sind höchstens 20 verschiedene Tags. `server` listet die Colyseus-Rooms einer hochgeladenen `server.js` auf, zum Beispiel `"server": { "rooms": ["game"] }`; siehe [Server-SDK](https://www.playdrop.ai/de/docs/server-sdk). Fragen Sie vor der Veröffentlichung beim Connector die aktuell akzeptierten Lizenzwerte und die vollständigen Feldregeln ab.

## Bilder und Videos für den Spieleintrag

Laden Sie die Medien des Spieleintrags als Dateien neben `index.html` hoch, benannt nach ihrem Pfad: `listing/icon.png`, `listing/hero-landscape.png` (16:9) und `listing/hero-portrait.png` (9:16) mit dem Spieltitel im Bild, Screenshots wie `listing/screenshots/landscape/0.png` sowie die Videos `listing/videos/landscape/0.mp4` (der Trailer) und `listing/videos/portrait/0.mp4` (der Mobile-Teaser). Videos laufen stumm auf Spielkarten und der Spielseite, der Trailer auf Computern und Fernsehern, der Teaser auf Smartphones. So zeigen Sie am schnellsten das Gameplay und gewinnen einen ersten Spielstart. Bilder sind PNG-, Videos MP4-Dateien.

## Spieleintrag korrekt übersetzen

Veröffentlichen Sie immer Englisch und zusätzlich Ihre eigene Sprache, falls diese abweicht. Setzen Sie `sourceLocale` auf die Originalsprache. `listingLocalizations` unterstützt Englisch, Französisch, Deutsch, Spanisch, brasilianisches Portugiesisch, Indonesisch, Japanisch, Koreanisch, traditionelles Chinesisch und vereinfachtes Chinesisch. Jede Übersetzung benötigt `locale` und `displayName`; wenn Sie sie zusammen mit ihrer Quelle hochladen, ergänzt PlayDrop `sourceHash`. Laden Sie übersetzte Bilder unter `listing/locales/<locale>/` hoch, zum Beispiel `listing/locales/fr/hero-landscape.png` mit dem französischen Titel; sie werden automatisch der passenden Übersetzung zugeordnet. Aktualisieren Sie die Übersetzungen nach Änderungen an der Quelle. Die Übersetzung des Spieleintrags übersetzt nicht das Spiel selbst.