catalogue.json : métadonnées et localisation des jeux PlayDrop
Référence pour les titres de jeux, les descriptions, les tags de genre, les images et vidéos de fiche, les traductions et le champ facultatif server, au format PlayDrop Connector.
PlayDrop Connector publie votre jeu avec un petit fichier catalogue.json : un objet JSON comportant apps, qui contient exactement un jeu. Seul name est obligatoire. L’agent l’envoie en tant qu’argument catalogue, avec les fichiers du jeu ; aucun outil en ligne de commande n’est nécessaire. PlayDrop Cloud tient ces métadonnées à jour pour vous.
Exemple minimal de publication
{
"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"]
}]
}Gardez le même slug en minuscules lors des mises à jour. Ajoutez selon vos besoins un titre d’affichage, une description précise, les commandes, la langue source et des tags connus. L’exemple ci-dessous utilise le tag de genre existant pour les jeux de plateforme.
Champs pris en charge et limites
name : de 1 à 100 lettres minuscules, chiffres ou traits d’union, commençant par une lettre ou un chiffre. displayName : titre non vide. subtitle : jusqu’à 120 caractères. description : jusqu’à 3 000 caractères en Markdown, sans titres H1, médias intégrés ni tableaux. inspirationPrompt : jusqu’à 400 caractères de texte brut sur une seule ligne. Les limites de texte sont calculées en unités de code UTF-16 JavaScript.
Les champs facultatifs comprennent controls, releaseNotes, makingOf, emoji, color, sourceRepository, license, tags, sourceLocale, listingLocalizations, listingMedia et server. Les tags utilisent des références existantes au format group-slug/tag-slug, dans la limite de 20 tags uniques. server liste les salles Colyseus d’un fichier server.js envoyé, par exemple "server": { "rooms": ["game"] } ; consultez le SDK serveur. Avant la publication, demandez au connecteur les valeurs de licence actuellement acceptées et l’ensemble des règles applicables aux champs.
Images et vidéos de la fiche
Envoyez les médias de la fiche sous forme de fichiers placés à côté de index.html et nommés selon leur chemin : listing/icon.png, listing/hero-landscape.png (16:9) et listing/hero-portrait.png (9:16) avec le titre du jeu dans l’illustration, des captures d’écran comme listing/screenshots/landscape/0.png, ainsi que les vidéos listing/videos/landscape/0.mp4 (la bande-annonce) et listing/videos/portrait/0.mp4 (le teaser mobile). Les vidéos sont lues sans le son sur les cartes de jeu et sur la page du jeu, la bande-annonce sur ordinateur et TV et le teaser sur téléphone : c’est le moyen le plus rapide de montrer le gameplay et de décrocher une première partie. Les images sont au format PNG et les vidéos au format MP4.
Traduisez fidèlement la fiche
Publiez toujours la fiche en anglais, et aussi dans votre langue si elle est différente. Définissez sourceLocale sur la langue d’origine. listingLocalizations prend en charge l’anglais, le français, l’allemand, l’espagnol, le portugais du Brésil, l’indonésien, le japonais, le coréen, le chinois traditionnel et le chinois simplifié. Chaque traduction doit contenir locale et displayName ; lorsque vous l’envoyez avec sa source, PlayDrop renseigne sourceHash. Envoyez les illustrations traduites dans listing/locales/<locale>/, par exemple listing/locales/fr/hero-landscape.png avec le titre en français ; elles sont automatiquement associées à leur traduction. Actualisez les traductions après toute modification de la source. La traduction de la fiche ne traduit pas le jeu lui-même.