Dragon Fusion — Guia Técnico Master para Unity 6

Guia completo de produção: arquitetura, JSON, regras de negócio/liberação, implementação de UI (Canvas/Panel), prefabs por tela, pipeline e sprints.

1) Stack e padrões obrigatórios

Engine: Unity 6, URP, Addressables, Input System.
UI: uGUI (Canvas + Panel + Prefabs) para produtividade e compatibilidade mobile.
Arquitetura: Service Layer + Feature Modules + ScriptableObjects + Events.
Dados: JSON versionado + migração + servidor autoritativo para economia/ranking.
Estado: State Machine para boot, home, battle, reward flow.

2) Estrutura de projeto Unity (pastas)

Assets/_Game/
  Art/{Sprites,VFX,UIAtlases}
  Audio/{Music,SFX}
  Prefabs/
    Core/
    UI/
    Gameplay/
    Meta/
  Scenes/
    Boot.unity
    Home.unity
    Map.unity
    Battle.unity
    Meta.unity
  Scripts/
    Core/{Bootstrap,StateMachine,EventBus,Config}
    Data/{Save,DTO,Migrations}
    Services/{Economy,Inventory,Missions,Ads,IAP,Leaderboard,CloudSave}
    Features/
      Home/
      Map/
      Battle/
      Rewards/
      Missions/
      Collection/
      Hatchery/
      Evolution/
      Ranking/
      Offers/
      Support/
    UI/{Views,Presenters,Widgets}
  Data/ScriptableObjects/
    Balance/
    Levels/
    Missions/
    Rewards/
    Offers/
Addressables/

3) Contratos JSON canônicos

3.1 SaveGame.json (cliente)

{
  "schemaVersion": 4,
  "playerId": "uuid",
  "profile": {"name": "Player", "level": 12, "xp": 18450},
  "economy": {
    "gold": 25430,
    "gems": 320,
    "energy": {"current": 20, "max": 20, "regenSec": 900, "lastTickUtc": 1773087000}
  },
  "progress": {
    "world": 3,
    "stage": 18,
    "starsByStage": {"W1-S1":3, "W2-S16":2},
    "lockedRulesState": {"world4Unlocked": false}
  },
  "inventory": {"boosters": {"shuffle": 1, "mix": 2, "undo": 5, "hint": 3}},
  "hatchery": {
    "slots": [
      {"slotId":1,"eggId":"egg_common_green","startUtc":1773086500,"endUtc":1773093700,"speed":2}
    ]
  },
  "collection": {"found": ["creature_001","creature_002"], "progress": {"total":34,"max":36}},
  "missions": {
    "daily": [{"id":"d_play_20m","progress":8,"target":20,"claimed":false}],
    "weekly": [{"id":"w_open_2_chests","progress":1,"target":2,"claimed":false}]
  },
  "season": {"seasonId":"S01","rank":59,"score":2450,"claimed":false},
  "settings": {"music":0.6,"sfx":0.8,"vibration":"medium","quality":"low","language":"pt-BR"},
  "consent": {"termsAccepted":true,"adsPersonalized":false,"termsVersion":"2026-03"},
  "meta": {"updatedAtUtc":"2026-03-09T22:30:00Z","serverNonce":"abc123"}
}

3.2 Regras de sincronização

Servidor vence para: economy, purchases, leaderboard, season claims.
Cliente vence (cache): settings, tutorialProgress visual.
Conflito: validar updatedAtUtc + serverNonce + txnId.
Transações críticas usam txnId idempotente.

4) Regras de negócio globais (liberação/bloqueio)

Regra	Condição	Ação
Entrada no jogo	termsAccepted == true	Permitir Home
Jogar fase	energy.current >= cost	Consumir energia e abrir Battle
Mundo 4	starsTotal >= 45	Unlock world4
Claim diário	not claimedToday	Conceder reward diário
Claim season	seasonClosed && !claimed	Conceder payout por faixa
Reviver	adAvailable \|\| itemAvailable	+3 moves, retomar board

5) UI técnica — Canvas / Panels / Prefabs

5.1 Padrão de cenas

SceneRoot
  Canvas_Root (ScreenSpace-Camera)
    Panel_Background
    Panel_HUD
    Panel_Content
    Panel_PopupLayer
    Panel_ToastLayer
  EventSystem

5.2 Prefabs base reutilizáveis

PF_ButtonPrimary, PF_ButtonSecondary, PF_BadgeCounter
PF_CurrencyBar (gold/gems/energy)
PF_TimerLabel, PF_RewardCard, PF_ChestSlot
PF_ModalBase (title/body/actions)
PF_StageNode (locked/open/completed/boss)
PF_CollectionCard, PF_BoosterButton

6) Implementação por tela (enviadas no ZIP)

Para cada tela: Objetivo, Hierarquia de UI, Componentes, Regras, Scripts Unity.

6.1 01 Carregamento

UI: Panel_Background + Logo + ProgressBar + Label.
Script: BootPresenter, BootstrapService.
Regra: timeout 12s com retry.

6.2 02 Consentimento

UI: PF_ModalBase com toggles e links.
Script: ConsentPresenter, ConsentService.
Regra: termos obrigatório, ads opcional.

6.3 03 Home

UI: PF_CurrencyBar, atalhos laterais, CTA JOGAR, bottom nav, baús.
Script: HomePresenter, ChestTimerService.
Regra: badge para pendências e timers sincronizados com UTC.

6.4 04 Mapa

UI: lista/grade de PF_StageNode por mundo + progress bars.
Script: MapPresenter, UnlockRulesService.
Regra: desbloqueio por estrelas e chefão.

6.5 05/06 Battle

UI: HUD jogadas/score, grid board, boosters, preview drops.
Script: BoardManager, MatchResolver, BattlePresenter.
Regra: move válida decrementa jogadas; score server-verifiable.

6.6 07 Vitória / 08 Derrota

UI: modal resultado + botões NEXT/REVIVER.
Script: ResultPresenter, RewardService.
Regra: claim idempotente; continue mantém snapshot do board.

6.7 09 Missões, 11 Diário

UI: lista de tarefas, barra de progresso, claim all.
Script: MissionPresenter, DailyRewardPresenter.
Regra: reset por UTC; claim 1x por janela.

6.8 12/12a/13/14b Ranking e premiações

UI: leaderboard list + brackets + tela de resultado final.
Script: LeaderboardService, SeasonRewardService.
Regra: tie-break determinístico e payout por faixa.

6.9 13a Ofertas, 14/14a Challenge

UI: cards de oferta com timer; tela VS/ghost.
Script: OfferService, MirrorChallengeService, GhostReplayService.
Regra: IAP validado; seed espelhada para fairness.

6.10 15/15a Coleção, 16 Chocagem, 17 Evoluir, 20 Modais

UI: collection cards, hatch slots, evolution cards, modais utilitários.
Script: CollectionService, HatcheryService, EvolutionService, SettingsPresenter, SupportPresenter.
Regra: timers incubação via UTC servidor; evolução consome materiais.

7) Esqueleto de scripts (Unity C#)

public interface IGameService { void Initialize(); }

public sealed class EconomyService : IGameService {
  public event Action OnBalanceChanged;
  public int Gold { get; private set; }
  public bool TrySpendGold(int value, string txnId) { /* valida + idempotência */ }
  public void AddGold(int value, string reason) { /* ... */ }
}

public sealed class UnlockRulesService {
  public bool IsWorldUnlocked(int worldId, int stars) => worldId switch {
    1 => true,
    2 => stars >= 15,
    3 => stars >= 30,
    4 => stars >= 45,
    _ => false
  };
}

8) Backlog técnico por sprint (12 semanas)

Sprint	Foco	Entregáveis	Prioridade
1-2	Fundação	Boot, Consent, Home, Save v4, serviços base	P0
3-4	Core gameplay	Board match/cascade, map unlock, vitória/derrota	P0
5-6	Meta loop	Missões, diário, coleção v1, chocagem	P0
7-8	Progressão avançada	Evolução, season pass, ranking base	P1
9-10	Monetização	Ofertas, reviver, IAP validation, rewarded ads	P1
11-12	Competitivo + polimento	Mirror/ghost, premiação final, otimização mobile QA	P1

9) Checklist de pronto para soft launch

D1 >= 35%, D7 >= 12%
Crash free >= 99.2%
Sem duplicidade de rewards/claims em 10k sessões teste
Tempo de boot < 8s em device médio
Toda compra validada server-side