catalogue.json: metadatos y localización de juegos de PlayDrop
Referencia sobre títulos de juegos, descripciones, etiquetas de género, imágenes y videos de la ficha, traducciones y el campo opcional server en el formato de PlayDrop Connector.
PlayDrop Connector publica tu juego con un pequeño catalogue.json: un objeto JSON con apps, que contiene exactamente un juego. Solo name es obligatorio. El agente lo envía como argumento de catálogo junto con los archivos del juego; no necesitas ninguna herramienta de línea de comandos. PlayDrop Cloud mantiene estos metadatos por ti.
Ejemplo mínimo de publicación
{
"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"]
}]
}Mantén estable el slug en minúsculas al actualizar. Añade según sea necesario un título visible, una descripción precisa, los controles, el idioma de origen y etiquetas conocidas. El ejemplo siguiente usa la etiqueta de género de plataformas existente.
Campos admitidos y límites
name: 1–100 letras minúsculas, dígitos o guiones, empezando por una letra o un dígito. displayName: título no vacío. subtitle: hasta 120 caracteres. description: hasta 3,000 caracteres de Markdown, sin encabezados H1, contenido multimedia incrustado ni tablas. inspirationPrompt: hasta 400 caracteres de texto sin formato en una sola línea. Los límites de texto se cuentan en unidades de código UTF-16 de JavaScript.
Entre los campos opcionales se incluyen controls, releaseNotes, makingOf, emoji, color, sourceRepository, license, tags, sourceLocale, listingLocalizations, listingMedia y server. Las etiquetas usan referencias group-slug/tag-slug existentes, con un máximo de 20 etiquetas únicas. server enumera las salas de Colyseus de un server.js subido, por ejemplo "server": { "rooms": ["game"] }; consulta el SDK de servidor. Antes de publicar, pide al conector los valores de licencia aceptados actualmente y las reglas completas de los campos.
Imágenes y videos de la ficha
Sube el contenido multimedia de la ficha como archivos junto a index.html, nombrados según su ruta: listing/icon.png, listing/hero-landscape.png (16:9) y listing/hero-portrait.png (9:16) con el título del juego en la ilustración, capturas de pantalla como listing/screenshots/landscape/0.png, y los videos listing/videos/landscape/0.mp4 (el tráiler) y listing/videos/portrait/0.mp4 (el teaser para móviles). Los videos se reproducen sin sonido en las tarjetas de juego y en la página del juego: el tráiler en ordenadores y TV, y el teaser en teléfonos. Son la forma más rápida de mostrar la jugabilidad y conseguir una primera partida. Las imágenes son PNG y los videos, MP4.
Traduce la ficha con precisión
Publica siempre en inglés y también en tu propio idioma si es distinto. Indica en sourceLocale el idioma original. listingLocalizations admite inglés, francés, alemán, español, portugués de Brasil, indonesio, japonés, coreano, chino tradicional y chino simplificado. Cada traducción necesita locale y displayName; cuando la subes junto con su contenido de origen, PlayDrop completa sourceHash. Sube las ilustraciones traducidas en listing/locales/<locale>/, por ejemplo listing/locales/fr/hero-landscape.png con el título en francés; se asocian automáticamente a su traducción. Actualiza las traducciones cuando cambie el contenido de origen. Traducir la ficha no traduce el juego en sí.