Guia do publisher

Do cadastro ao lançamento

O fluxo é parecido com o da Steam: o estúdio é verificado, cada jogo é um app, as versões são builds imutáveis e os jogadores recebem a build para a qual a branch default aponta. Tudo é feito noportal de publishers e na ferramenta de linha de comando decoy-publish-tool.

  1. ✔ Estúdio verificado
  2. ✔ Página da loja aprovada
  3. ✔ Build enviada, revisada e assinada
  4. ✔ Branch default apontando para a build
  5. ✔ App "Em breve" e depois "Lançado"

O portal mostra essa lista em cada app (“Primeiros passos”), com o próximo passo destacado.

1. Cadastro do estúdio

  1. Crie uma conta Decoy (a mesma do launcher) e entre no portal.
  2. Clique em Cadastrar estúdio: nome público, identificador, e-mail de contato e dados legais (CNPJ para empresa, CPF para pessoa física).
  3. Aceite o contrato de distribuição.
  4. Ative a verificação em duas etapas (Google Authenticator, Authy, 1Password…). Ela é obrigatória para quem publica e guarda os códigos de recuperação.

A Decoy analisa o cadastro (até 3 dias úteis) e você recebe uma notificação. Enquanto isso você já pode preparar a página da loja.

Equipe

Em Membros, convide pessoas da sua equipe pelo nome de usuário Decoy:

PapelPode
OwnerTudo, inclusive membros e chaves de API
AdminTudo menos remover o owner; publica na branch default
DesenvolvedorEnviar builds e apontar branches beta
MarketingPágina da loja e keys
FinanceiroRelatórios (quando houver vendas)

2. App e página da loja

Com o estúdio verificado, clique em Novo app. Ele recebe um número (ex.: 1003) e nasce oculto.

Em Página da loja, preencha título, chamada, descrição, tags, requisitos e envie as imagens direto pelo portal:

ImagemTamanho sugerido
Banner1920 × 620 (JPG)
Ícone512 × 512 (PNG, pode ter transparência)
Screenshots (até 20)1920 × 1080

PNG, JPG ou WebP até 10 MB. A Decoy reprocessa cada imagem (remove metadados como GPS e limita a 2560 × 1440).

Clique em Enviar para revisão. A equipe aprova ou pede ajustes com um comentário. Depois de aprovada, cada alteração passa por revisão de novo.

3. Ferramenta de publicação

O decoy-publish-tool divide os arquivos do jogo em blocos, comprime, criptografa e envia só o que o servidor ainda não tem.

# Linux
sha256sum -c --ignore-missing SHA256SUMS
chmod +x decoy-publish-tool-linux-x86_64

# Windows (PowerShell)
Get-FileHash .\decoy-publish-tool-windows-x86_64.exe -Algorithm SHA256

4. Chave de API

Em Chaves de API (owner/admin, com 2FA), crie uma chave:

  • builds:upload: enviar builds (o suficiente para a maioria dos casos).
  • branches:beta: apontar branches beta pelo CI (a branch default só pelo portal).

Limite a chave aos apps necessários e, se quiser, defina validade. A chave aparece uma única vez: guarde como segredo do CI. Se vazar, revogue no portal.

5. Enviar uma build

Coloque cada plataforma numa pasta com tudo o que o jogo precisa para rodar e informe o executável relativo a essa pasta:

export DECOY_API_KEY=dpk_...        # nunca coloque a chave direto no comando
decoy-publish-tool upload-build \
  --api https://decoy-backend.onrender.com \
  --app 1003 \
  --version 1.2.0 \
  --description "Correções do multiplayer" \
  --windows-src ./dist/windows --windows-exec MeuJogo.exe \
  --linux-src   ./dist/linux   --linux-exec   meu-jogo
  • A versão é única por app: builds nunca são sobrescritas. Para corrigir, envie uma nova versão.
  • Arquivos .pdb, .log e .tmp são ignorados.
  • Na segunda build, só os blocos que mudaram sobem (e os jogadores baixam só esses blocos).
  • Ao terminar, a build aparece no portal como Aguardando assinatura da Decoy.

6. Publicar pelo CI

Exemplo com GitHub Actions publicando a cada tag v*. Guarde a chave em Settings → Secrets → DECOY_API_KEY.

# .github/workflows/decoy.yml
name: Publicar na Decoy
on:
  push:
    tags: ['v*']
jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      # ... compile o jogo para ./dist/windows e ./dist/linux ...
      - name: Baixar decoy-publish-tool
        run: |
          curl -fsSLo decoy-publish-tool https://pub-f4d0b0f3a2af421eaabb0283762ea60c.r2.dev/tools/decoy-publish-tool-linux-x86_64
          curl -fsSLo SHA256SUMS https://pub-f4d0b0f3a2af421eaabb0283762ea60c.r2.dev/tools/SHA256SUMS
          grep linux-x86_64 SHA256SUMS | sed 's/decoy-publish-tool-linux-x86_64/decoy-publish-tool/' | sha256sum -c -
          chmod +x decoy-publish-tool
      - name: Enviar build
        env:
          DECOY_API_KEY: ${{ secrets.DECOY_API_KEY }}
        run: |
          ./decoy-publish-tool upload-build --api https://decoy-backend.onrender.com --app 1003 \
            --version "${GITHUB_REF_NAME#v}" \
            --windows-src dist/windows --windows-exec MeuJogo.exe \
            --linux-src dist/linux --linux-exec meu-jogo

7. Revisão e assinatura

A Decoy confere cada build e a assina com a chave da plataforma. O launcher verifica essa assinatura antes de instalar: se alguém alterar um arquivo no caminho, o download é recusado. Quando a build fica Pronta, você recebe uma notificação.

8. Branches, betas e rollback

  • default: o que todos os jogadores recebem. Só owner/admin alteram, com 2FA.
  • Betas (ex.: beta, testes): opcionalmente com senha, para testes fechados.
  • Rollback: aponte a default de volta para a build anterior. Nada é reenviado.

9. Em breve e lançamento

EstadoJogadoresExige
OcultoNão veem—
Em breveVeem a página, não adquiremPágina aprovada
LançadoAdquirem e baixamPágina aprovada e branch default com build pronta
Fora da lojaQuem já tem continua jogando—

10. Keys do jogo

Em cada app, Keys gera códigos XXXXX-XXXXX-XXXXX que valem uma cópia do jogo. O jogador ativa em Ativar produto no site ou no launcher.

  • Lotes de até 500 keys (e até 2.000 por mês) saem na hora. Pedidos maiores são aprovados pela Decoy.
  • Keys funcionam com o jogo oculto ou em breve, para imprensa e testes antes do lançamento.
  • Baixe o lote em CSV (pede 2FA) e acompanhe quantas já foram resgatadas.
  • Se um lote vazar, revogue: as keys não usadas param de funcionar.
  • Se o jogador já tem o jogo, a key não é gasta.

Regras: não venda keys por menos do que o preço na loja Decoy, não ofereça keys em troca de avaliações e não use keys para burlar a revisão.

11. Integração com o launcher

Ao abrir o jogo, o launcher passa as informações do jogador em variáveis de ambiente. Nenhuma delas é a senha ou o token da conta.

VariávelConteúdo
DECOY_USERNAMENome do jogador logado
DECOY_USER_IDID estável do jogador
DECOY_SESSION_TICKETTicket de sessão (JWT, 12 h, válido só para o seu jogo). Seu servidor valida em POST /api/tickets/verify
DECOY_GAME_IDID do app em execução
DECOY_API_URLEndereço da API Decoy
DECOY_SDK_ENDPOINT / DECOY_LAUNCHER_IPC_TOKENCanal local e segredo do SDK (amigos, convites, overlay)
  • Servidores dedicados: valide o jogador com POST https://decoy-backend.onrender.com/api/tickets/verify enviando o DECOY_SESSION_TICKET.
  • Convites: quando um amigo aceita um convite, o jogo abre com +connect ip:porta.
  • SDK: crate Rust decoy-sdk e interface em C (decoy_sdk.h) para Unreal, Unity e Godot — amigos, presença, convites, overlay e conquistas. Estúdios verificados recebem acesso pelo suporte.
  • Conquistas e estatísticas: defina no portal (app → Conquistas); no jogo, set_achievement / set_stat e store_stats. Jogos competitivos podem marcar “só servidor” e gravar pelo servidor com uma chave stats:write.
  • Saves na nuvem: no portal (app → Nuvem), informe as pastas de save por sistema. O launcher sincroniza antes de abrir e depois de fechar o jogo; nada muda no código.
  • Betas: jogadores escolhem betas abertas em Propriedades → Betas, ou digitam o código de acesso das betas com senha.

12. Regras e boas práticas

  • Envie só conteúdo cujos direitos você tem. Malware, coleta de dados sem aviso e conteúdo ilegal levam à remoção e suspensão do estúdio.
  • Mantenha o 2FA ativo em todas as contas da equipe e use chaves de API separadas por CI, com o menor escopo possível.
  • Teste em uma branch beta antes de mudar a default.
  • Dúvidas ou problemas: central de suporte.

13. Avaliações, desejos e suporte

  • Lista de desejos: o app aparece na loja como “Em breve” e os jogadores adicionam à lista; o portal mostra o total. Quem desejou é avisado no lançamento e em promoções.
  • Avaliações: só quem tem o jogo e jogou 15 minutos avalia. A nota conta só compras (avaliações de quem ativou key aparecem, mas ficam fora da nota). Responda publicamente em app → Avaliações.
  • Suporte: a Decoy atende os jogadores e encaminha ao estúdio os tickets sobre o jogo. Eles aparecem em Suporte no portal (você vê só o nome de usuário) e sua resposta aparece como “Equipe <seu estúdio>”.