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.
PlayDrop Connector 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
{
"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"]
}]
}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.
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. 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.