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