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.
- ✔ Estúdio verificado
- ✔ Página da loja aprovada
- ✔ Build enviada, revisada e assinada
- ✔ Branch default apontando para a build
- ✔ 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
- Crie uma conta Decoy (a mesma do launcher) e entre no portal.
- Clique em Cadastrar estúdio: nome público, identificador, e-mail de contato e dados legais (CNPJ para empresa, CPF para pessoa física).
- Aceite o contrato de distribuição.
- 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:
| Papel | Pode |
|---|---|
| Owner | Tudo, inclusive membros e chaves de API |
| Admin | Tudo menos remover o owner; publica na branch default |
| Desenvolvedor | Enviar builds e apontar branches beta |
| Marketing | Página da loja e keys |
| Financeiro | Relató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:
| Imagem | Tamanho sugerido |
|---|---|
| Banner | 1920 × 620 (JPG) |
| Ícone | 512 × 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.
- Windows (x86_64)
- Linux (x86_64)
- SHA256SUMS: confira o arquivo baixado antes de usar.
# 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 SHA2564. 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 branchdefaultsó 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,.loge.tmpsã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-jogo7. 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
defaultde volta para a build anterior. Nada é reenviado.
9. Em breve e lançamento
| Estado | Jogadores | Exige |
|---|---|---|
| Oculto | Não veem | — |
| Em breve | Veem a página, não adquirem | Página aprovada |
| Lançado | Adquirem e baixam | Página aprovada e branch default com build pronta |
| Fora da loja | Quem 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ável | Conteúdo |
|---|---|
DECOY_USERNAME | Nome do jogador logado |
DECOY_USER_ID | ID estável do jogador |
DECOY_SESSION_TICKET | Ticket de sessão (JWT, 12 h, válido só para o seu jogo). Seu servidor valida em POST /api/tickets/verify |
DECOY_GAME_ID | ID do app em execução |
DECOY_API_URL | Endereço da API Decoy |
DECOY_SDK_ENDPOINT / DECOY_LAUNCHER_IPC_TOKEN | Canal local e segredo do SDK (amigos, convites, overlay) |
- Servidores dedicados: valide o jogador com
POST https://decoy-backend.onrender.com/api/tickets/verifyenviando oDECOY_SESSION_TICKET. - Convites: quando um amigo aceita um convite, o jogo abre com
+connect ip:porta. - SDK: crate Rust
decoy-sdke 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_statestore_stats. Jogos competitivos podem marcar “só servidor” e gravar pelo servidor com uma chavestats: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>”.