Publicar na Guebly Store

---

Visão Geral do Fluxo

Seu jogo (pasta com project.json + scripts Lua)
    ↓
python tools/export_game.py seu_jogo/
    ↓
dist/NomeDoJogo-v1.0.0/   ← pacote standalone com runtime embutido
    ↓
python tools/publish.py seu_jogo/ SEU_TOKEN
    ↓
Guebly Store API  →  Cloudflare R2 (CDN)
    ↓
Jogo aparece na loja para compra/download

---

1. Estrutura do Projeto

Seu jogo deve ter um project.json na raiz:

{
  "name": "Meu Jogo",
  "slug": "meu-jogo",
  "description": "Descrição do jogo para a loja.",
  "version": "1.0.0",
  "price": 0,
  "currency": "BRL",
  "genres": ["Action", "Platformer"],
  "platforms": ["WINDOWS"],
  "author": "Seu Nome",
  "entry": "main.lua",
  "company": "Seu Estúdio",
  "window": {
    "title": "Meu Jogo",
    "width": 1280,
    "height": 720,
    "fullscreen": false,
    "resizable": true
  },
  "settings": {
    "target_fps": 60,
    "physics_enabled": false,
    "audio_enabled": true
  }
}

Campos do project.json

Campo	Tipo	Descrição
name	string	Nome de exibição do jogo
slug	string	Identificador URL (letras minúsculas, hífens)
description	string	Descrição para a página da loja
version	string	Versão semântica
price	number	Preço em centavos (0 = gratuito)
currency	string	Moeda ("BRL")
genres	string[]	Gêneros (ex: ["Action", "RPG"])
platforms	string[]	Plataformas (["WINDOWS"])
author	string	Nome do desenvolvedor
entry	string	Script Lua de entrada

---

2. Exportar Standalone

O script tools/export_game.py cria um pacote executável com o runtime embutido:

python tools/export_game.py templates/engine-demo

Saída em dist/engine-demo-v1.0.0/:

dist/engine-demo-v1.0.0/
├── guebly_runtime.exe      ← runtime embutido
├── SDL2.dll                ← dependências
├── main.lua                ← seus scripts
├── assets/                 ← seus assets
└── RODAR.bat               ← launcher Windows

info

O script export_game.py procura o guebly_runtime.exe em build/Release/. Compile o projeto antes de exportar.

---

3. Obter Token de Desenvolvedor

1. Acesse dev.games.guebly.com.br
2. Crie uma conta com perfil DEVELOPER
3. Vá em Configurações → Tokens de API
4. Gere um novo token e copie

---

4. Publicar na Store

python tools/publish.py templates/engine-demo SEU_TOKEN_AQUI

O script:

1. Chama export_game.py → cria o pacote standalone
2. Comprime dist/ em .zip
3. Faz POST multipart para https://api.games.guebly.com.br/api/games/publish
4. Aguarda confirmação da API

Após publicar, o jogo passa por revisão do admin antes de aparecer publicamente na store.

---

5. Publicar pelo Editor

Arquivo → Publicar na Loja…

1. Insira seu token no campo de texto
2. Clique em Publicar
3. Acompanhe o status no diálogo

---

6. Atualizar um Jogo Publicado

Incremente a versão no project.json e repita o processo de publicação. A API cria uma nova entrada de versão associada ao mesmo slug.

---

Troubleshooting

"Runtime não encontrado"

Compile o projeto primeiro:

cmake --preset release && cmake --build --preset release

"Token inválido"

Verifique se o token não expirou em dev.games.guebly.com.br. Tokens expiram após 90 dias.

"Slug já existe"

O slug no project.json já está registrado para outro jogo. Escolha um slug único.