Dragon Fusion — Documento de Design (GDD v1)

1) Visão do produto e pilares

One-liner: Puzzle de combinação com ovos e evolução de dragões, onde estratégia de merge + progressão constante = sensação de poder sem pay-to-win.

Público: jogadores casuais/intermediários de mobile (sessões 3–10 min), com versão PC para retenção longa.

Pilares:

2) Telas e arquitetura de UX (com base no que já existe)

3) Mecânica principal de tabuleiro

3.1 Configuração base

• Grid: 8x8
• Tipos: 6 ovos elementais (Fogo, Água, Terra, Vento, Luz, Sombra)
• Input: drag para trocar com vizinho
• Jogada válida: forma match 3+; inválida volta

3.2 Regras de match

3.3 Spawn/RNG controlado

• Distribuição inicial uniforme dos 6 tipos.
• Regra anti-frustração: após 5 jogadas sem combo 4+, aumentar peso de chance de jogada útil.
• Se sem jogada possível: reshuffle() automático com animação + aviso curto.

4) Pontuação, combos e dificuldade (com cálculos)

4.1 Fórmula de pontuação por jogada

score_total = (base_match + bonus_especial) * multiplicador_cascata * multiplicador_fase

• base_match: 100 (3), 180 (4), 300 (5+)
• bonus_especial: +250 (Ovo Potente), +500 (Ovo Lendário)
• multiplicador_cascata: 1.0, 1.2, 1.5, 2.0, ... cap 3.0
• multiplicador_fase: 1.0 a 1.4 (escala por reino/fase)

4.2 Alvos de dificuldade

• Taxa de vitória ideal early game: 70–80%
• Mid game: 60–70%
• Late game: 50–60%

Se vitória cair abaixo do alvo por 2 versões seguidas: reduzir obstáculos, aumentar power-up drop, ou baixar pontuação-alvo.

5) Sistema de ovos, incubação e chocagem

5.1 Tempos base de chocagem

5.2 Fórmula de aceleração

tempo_final = tempo_base / multiplicador

• x2: 6h → 3h
• x4: 24h → 6h

5.3 Fontes de ovo

• Recompensa de fase
• Missões diárias/semanais
• Eventos de tempo limitado
• Loja (com limite diário em soft currency)
• Doação/atividade de clã

6) Dragões, fusão e progressão

6.1 Escada de raridade

Comum → Raro → Épico → Lendário → Mítico

6.2 Regra de fusão

3 dragões iguais (mesma estrela/nível) = 1 dragão de tier acima

6.3 Stats de dragão (modelo)

6.4 Time ativo

• 3 dragões equipáveis por fase
• 1 líder (passiva principal) + 2 suporte

7) Economia completa

7.3 Loja (não P2W)

• Cosméticos, aceleração, conveniência.
• Evitar venda direta de poder impossível via gameplay.
• Bundles com valor claro (mostrar economia %).

8) Meta-sistemas: missões, ranking, clã, eventos

8.1 Missões

8.2 Ranking

• Ligas por faixa de poder/nível para justiça.
• Reset semanal com recompensa por tier alcançado.

8.3 Clã

• Doação de recursos com limite diário.
• Meta coletiva (clã) para liberar baú semanal.

8.4 Eventos (72h)

• Mutadores de gameplay (ex.: fogo duplica score).
• Passo de entrada simples: jogar normalmente já progride.

9) Conteúdo: 12 reinos, 7–14 fases por reino

9.1 Curva recomendada

• Reinos 1–3: 7–8 fases
• Reinos 4–8: 9–11 fases
• Reinos 9–12: 12–14 fases

9.2 Tipos de fase

• Meta de pontuação
• Coleta de tipo específico
• Quebra de obstáculos
• Boss stage (fim de reino)

9.3 Estrelas

• 1 estrela: concluir fase
• 2 estrelas: meta secundária
• 3 estrelas: tempo/jogadas ideais

10) LiveOps, telemetria e KPIs

10.1 Eventos a instrumentar

• level_start, level_fail, level_complete
• match_3/4/5plus, cascade_count
• egg_start_hatch, egg_finish_hatch
• mission_claim, shop_purchase, ad_reward_claim

10.2 KPIs alvo (primeiro mês)

10.3 Ciclo de balance

Ciclo semanal: coletar dados → identificar gargalo (onboarding, fase, economia) → testar 1 variável por vez → validar impacto em D1/D7.

11) Implementação prática, backlog e decisões pendentes

11.1 Backlog Must/Should/Could

11.2 Decisões que você precisa fechar agora

1. Será 100% retrato (portrait) em todas as telas?
2. Energia inicial 5 ou 10?
3. Passe temporada terá 28 ou 35 dias?
4. Clã entra no MVP ou no patch 1?
5. Qual tema do Reino 1 para amarrar arte + tutorial?

11.3 Critério de “pronto para soft launch”

• Crash free > 99%
• Tutorial completion > 85%
• Tempo de loading inicial < 8s em device médio
• D1 mínimo 30% antes de escalar aquisição

12) GDD v1.1 técnico (Unity 6)

12.1 Estrutura de pastas sugerida

Assets/
  _Game/
    Art/
    Audio/
    Prefabs/
    Scenes/
      Boot.unity
      Home.unity
      Board.unity
      Hatchery.unity
    Scripts/
      Core/
      Gameplay/
      UI/
      Meta/
      Economy/
      Analytics/
      Save/
    Data/
      ScriptableObjects/
        Eggs/
        Dragons/
        Levels/
        Missions/
        Shop/
        SeasonPass/
  Addressables/

12.2 Classes principais (resumo)

12.3 ScriptableObjects (dados)

• EggDefinitionSO: id, elemento, raridade, tempoBase, recompensa
• DragonDefinitionSO: id, raridade, stats base, passivas, custo de upgrade
• LevelDefinitionSO: objetivo, obstáculos, seed, limite de jogadas/tempo
• MissionDefinitionSO: tipo, meta, janela, recompensa
• ShopItemSO: sku, moeda, preço, limites, conteúdo
• SeasonPassTierSO: nível, recompensa free, recompensa premium
• BalanceConfigSO: multiplicadores globais e caps

12.4 Ordem de implementação por sprint (8 semanas)

12.5 Regras técnicas obrigatórias

• Separar lógica de gameplay de UI (evitar acoplamento direto).
• Tudo configurável por dados (SO/Remote Config), sem números hardcoded.
• Pool para efeitos/partículas e objetos recorrentes.
• Sem alocação por frame em loops críticos (evitar GC spikes).
• Eventos de analytics já no MVP para evitar "voo cego" de balance.

13) v1.2 — Diagrama de estados + contrato JSON de save (local, servidor, Firebase, Supabase)

13.1 Diagrama de estados de gameplay (alto nível)

Boot
 └─> Home
      ├─> BoardLoading
      │    └─> InLevel
      │         ├─> Paused
      │         │    └─> InLevel
      │         ├─> Victory
      │         │    └─> RewardFlow
      │         │         └─> Home
      │         └─> Defeat
      │              └─> RetryOrHome
      │                   ├─> InLevel
      │                   └─> Home
      ├─> Hatchery
      │    └─> Home
      ├─> Shop
      │    └─> Home
      ├─> Missions
      │    └─> Home
      └─> Clan
           └─> Home

13.2 Máquina de estado da fase (detalhado)

LevelInit -> PlayerTurn -> SwapResolve -> MatchResolve -> CascadeResolve -> ObjectiveCheck
   ^                                                                     |
   |---------------------------------------------------------------------|

ObjectiveCheck:
- if objectiveComplete -> Victory
- else if noMovesAvailable -> Reshuffle -> PlayerTurn
- else if outOfMovesOrTime -> Defeat
- else -> PlayerTurn

13.3 Contrato JSON — versão canônica de save

Use versionamento explícito e migração por versão. Nunca quebrar compatibilidade sem migrator.

{
  "schemaVersion": 3,
  "playerId": "uuid",
  "createdAt": "2026-03-09T20:00:00Z",
  "updatedAt": "2026-03-09T21:00:00Z",
  "profile": {
    "name": "Player",
    "level": 12,
    "xp": 18450,
    "vip": 0
  },
  "economy": {
    "gold": 125000,
    "gems": 340,
    "energy": {
      "current": 8,
      "max": 20,
      "regenSeconds": 900,
      "lastTickUnix": 1773086000
    }
  },
  "progress": {
    "currentKingdom": 3,
    "currentStage": 7,
    "starsByStage": {
      "K1-S1": 3,
      "K1-S2": 2
    },
    "bestScoreByStage": {
      "K1-S1": 15320
    }
  },
  "boardMeta": {
    "lastPlayedStageId": "K3-S7",
    "lastSeed": 843219,
    "tutorialStep": 5
  },
  "dragons": {
    "owned": [
      {"dragonId": "fire_whelp", "rarity": "common", "level": 7, "stars": 2, "count": 1}
    ],
    "activeTeam": ["fire_whelp", "wind_drake", "light_drake"]
  },
  "eggs": {
    "inventory": [
      {"eggId": "egg_fire_common", "qty": 3}
    ],
    "hatchingSlots": [
      {
        "slot": 1,
        "eggId": "egg_rare_water",
        "startUnix": 1773082000,
        "endUnix": 1773096400,
        "speedMultiplier": 2
      }
    ]
  },
  "missions": {
    "daily": [{"id": "d_combo_10", "progress": 6, "target": 10, "claimed": false}],
    "weekly": [{"id": "w_clear_25", "progress": 11, "target": 25, "claimed": false}],
    "seasonXp": 820
  },
  "seasonPass": {
    "seasonId": "S01",
    "premium": false,
    "claimedFree": [1,2,3],
    "claimedPremium": []
  },
  "shop": {
    "lastDailyRefreshUnix": 1773072000,
    "purchases": [{"sku": "bundle_starter", "qty": 1}]
  },
  "ads": {
    "rewardedToday": 4,
    "lastRewardUnix": 1773085800
  },
  "settings": {
    "sfx": 0.8,
    "music": 0.6,
    "language": "pt-BR",
    "haptics": true
  },
  "antiCheat": {
    "serverNonce": "abc123",
    "lastServerSyncUnix": 1773086400
  }
}

13.4 Regras de sincronização (single source of truth)

• Cliente local: cache de leitura rápida e jogo offline limitado.
• Servidor remoto: autoridade final para economia, compra e progresso sensível.
• Conflito de save: usar updatedAt + serverNonce + política server-wins para campos críticos.
• Auto-sync: no login, no fim de fase, após compra, ao voltar do background e a cada 120s em sessão ativa.

13.5 Backend genérico (servidor próprio)

13.6 Firebase (opção)

• Auth: Firebase Auth (anônimo + upgrade para conta).
• Database: Firestore em players/{playerId} com subcoleções leves.
• Cloud Functions: validar economia, recompensas e IAP (não confiar no cliente).
• Remote Config: ajustar balance sem update de app.

// documento principal (Firestore)
players/{playerId}
  profile: {...}
  economy: {...}
  progress: {...}
  updatedAt: serverTimestamp

13.7 Supabase (opção)

• Auth: Supabase Auth (guest + social/email).
• DB: Postgres com tabelas normalizadas e row-level security.
• RPC/Edge Functions: transações de economia e validações críticas.
• Storage: snapshots de save e assets leves de perfil.

tables:
- players(id, created_at, updated_at)
- player_profile(player_id, level, xp, vip)
- player_economy(player_id, gold, gems, energy_current, energy_max, last_tick)
- player_progress(player_id, kingdom, stage, stars_jsonb)
- player_inventory(player_id, item_id, qty)
- player_dragons(player_id, dragon_id, rarity, level, stars, count)
- player_missions(player_id, mission_id, progress, target, claimed)

13.8 Política offline/online recomendada

• Permitido offline: jogar fase, progresso visual local, missões temporárias.
• Exigir online: compras, ranking, clã, recompensas de anúncio, eventos competitivos.
• No retorno online: aplicar fila de deltas local->server com validação.