🐢 TMNT2 — Desmontagem Profissional (NES)

Código-fonte do Teenage Mutant Ninja Turtles II: The Arcade Game (NES), organizado no padrão profissional, comentado e pronto pra criar mods.

Base: desmontagem do AaronBottegal (jogo todo, com nomes de variável), reorganizada no padrão cyneprepou4uk/NES-Games-Disassembly com sistema de build, CHR separado e docs em português.

---

📁 Estrutura

TMNT2-Disassembly/
├── src/                       ← CÓDIGO (32 bancos + variáveis)
│   ├── TMNT2.bank00..31.asm   ← os bancos de PRG (código+dados)
│   ├── TMNT2.variables.asm    ← TODAS as variáveis de RAM (nomeadas!)
│   └── TMNT2.project.asm      ← include de tudo
├── gfx/                       ← GRÁFICOS (CHR) separados por banco
│   ├── chr_00.chr ... chr_1F.chr   ← 32 bancos de 8KiB (edite no YY-CHR)
│   └── chr_all.bin            ← CHR inteiro (pro build)
├── docs/                      ← Documentação em PT-BR
│   ├── COMO_COMPILAR.md       ← como montar a ROM (passo a passo)
│   ├── MAPA_DO_JOGO.md        ← o que é o quê / onde mexer
│   └── MODS_LEGAIS.md         ← ideias de mod + onde alterar
├── tools/
│   └── extract_assets.py      ← extrai header + CHR da sua ROM
├── build/                     ← sai a ROM montada aqui
├── header.bin                 ← cabeçalho iNES (16 bytes)
├── ld65.cfg                   ← config do linker (MMC3, 256K PRG/CHR)
├── assemble.bat               ← MONTA com 1 clique (Windows)
├── assemble.sh                ← MONTA com 1 clique (Linux/Mac)
└── preparations.lua           ← limpa o prefixo antes de montar

---

🚀 COMPILAR — 1 CLIQUE (TUDO INCLUSO, não baixa nada)

# 1) Coloque sua ROM original nesta pasta com o nome:
#      original.nes
# 2) Dê 2 cliques em:
recompilar.bat        # Windows
# 3) ROM recompilada sai em:
#      build/_tmnt2_recompilado.nes

Tudo já tá incluso em tools/: ca65.exe, ld65.exe, lua53.exe, lua53.dll. A única coisa sua é a ROM (original.nes). O .bat faz tudo: extrai gráficos

• header, divide o código em bancos, monta, linka e junta. Se aparecer "BATEU!" = build perfeito (SHA-1 idêntico ao original). Daí é só editar e recompilar.

Como funciona: ele divide o PRG em bancos de bytes crus (.byte) que recompilam idênticos (round-trip testado). Os bancos editáveis (instruções reais + comentários PT) estão em src/ pra você entender onde mexer. Pra gráficos, edite gfx/*.chr no YY-CHR. Detalhes em docs/COMO_COMPILAR.md.

---

🎨 Onde mexer (resumo — detalhes em docs/MODS_LEGAIS.md)

Quero mudar...	Onde	Risco
Cores (paleta)	gfx + paletas $06D9	🟢 seguro
Sprites dos personagens	gfx/chr_XX.chr	🟢 seguro
Vidas iniciais	src (lógica de lives)	🟢 seguro
Música do select	$92EB (mapper bank)	🟡 médio
Força das armas	rotina de dano	🟡 médio
Mais inimigos / boss rush	spawns $05DB	🟠 cuidado
Jogar como chefe	motor de objeto	🔴 complexo

---

🗺️ Comece aqui

1. docs/MAPA_DO_JOGO.md — entenda a estrutura (bancos, variáveis, objetos)
2. docs/MODS_LEGAIS.md — ideias de mods seguros e legais
3. docs/COMO_COMPILAR.md — quando for montar e testar

Divirta-se! 🐢🍕