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

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

[PlayDrop Connector](https://www.playdrop.ai/es/docs/connectors) 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

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.

```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"]
  }]
}
```

## 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](https://www.playdrop.ai/es/docs/server-sdk). 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í.