# catalogue.json: metadados e localização de jogos no PlayDrop

Referência para títulos de jogos, descrições, tags de gênero, imagens e vídeos da listagem, traduções e o campo opcional de servidor no formato do PlayDrop Connector.

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

O [PlayDrop Connector](https://www.playdrop.ai/pt-br/docs/connectors) publica seu jogo com um pequeno `catalogue.json`: um objeto JSON com `apps`, contendo exatamente um jogo. Somente `name` é obrigatório. O agente o envia como argumento de catálogo junto com os arquivos do jogo; nenhuma ferramenta de linha de comando é necessária. O PlayDrop Cloud mantém esses metadados para você.

## Exemplo mínimo de publicação

Mantenha estável o slug em minúsculas ao atualizar. Adicione um título de exibição, uma descrição precisa, os controles, o idioma de origem e tags conhecidas, conforme necessário. O exemplo abaixo usa a tag existente do gênero plataforma.

```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 aceitos e limites

`name`: 1–100 letras minúsculas, dígitos ou hifens, começando com uma letra ou um dígito. `displayName`: título não vazio. `subtitle`: até 120 caracteres. `description`: até 3.000 caracteres de Markdown, sem títulos H1, mídia incorporada ou tabelas. `inspirationPrompt`: até 400 caracteres de texto simples em uma única linha. Os limites de texto contam unidades de código UTF-16 do JavaScript.

Os campos opcionais incluem `controls`, `releaseNotes`, `makingOf`, `emoji`, `color`, `sourceRepository`, `license`, `tags`, `sourceLocale`, `listingLocalizations`, `listingMedia` e `server`. As tags usam referências `group-slug/tag-slug` existentes, com no máximo 20 tags distintas. `server` lista as salas Colyseus de um `server.js` enviado, por exemplo `"server": { "rooms": ["game"] }`; consulte o [SDK de servidor](https://www.playdrop.ai/pt-br/docs/server-sdk). Antes da publicação, peça ao conector os valores de licença aceitos atualmente e as regras completas dos campos.

## Imagens e vídeos da listagem

Envie a mídia da listagem como arquivos ao lado do `index.html`, nomeados pelo caminho: `listing/icon.png`, `listing/hero-landscape.png` (16:9) e `listing/hero-portrait.png` (9:16), com o título do jogo na arte, capturas de tela como `listing/screenshots/landscape/0.png` e os vídeos `listing/videos/landscape/0.mp4` (o trailer) e `listing/videos/portrait/0.mp4` (o teaser para celular). Os vídeos são reproduzidos sem som nos cards de jogo e na página do jogo (o trailer em computadores e TVs, o teaser em celulares), por isso são a forma mais rápida de mostrar a jogabilidade e conquistar uma primeira partida. As imagens são PNG e os vídeos, MP4.

## Traduza a listagem com precisão

Publique sempre em inglês e também no seu idioma, se for diferente. Defina `sourceLocale` como o idioma original. `listingLocalizations` aceita inglês, francês, alemão, espanhol, português do Brasil, indonésio, japonês, coreano, chinês tradicional e chinês simplificado. Cada tradução precisa de `locale` e `displayName`; quando você a envia junto com a origem, o PlayDrop preenche o `sourceHash`. Envie a arte traduzida em `listing/locales/<locale>/`, por exemplo `listing/locales/fr/hero-landscape.png` com o título em francês; ela é associada automaticamente à sua tradução. Atualize as traduções depois de alterações na origem. A tradução da listagem não traduz o jogo em si.