Skip to content

feat(combate): combate por turnos, HUD do combate e NPCs - #59

Merged
Ak4ai merged 79 commits into
mainfrom
feat/combate-turnos
Nov 18, 2026
Merged

Ak4ai merged 79 commits into
mainfrom
feat/combate-turnos

Conversation

@Ak4ai

@Ak4ai Ak4ai commented Nov 18, 2026

Copy link
Copy Markdown
Owner

Combate por turnos trazido do mod Ak4ai/RPG e melhorado, mais os NPCs.

  • Regras em src/combat (iniciativa, ações, itens, habilidades, bestiário) e a cola com o mundo no CombatController.
  • HUD do combate no visual das telas de entrada e configurações: ordem dos turnos, menu deitado com as ações em grade e ícones, registro da luta no chat do jogo, hover com cursor de ataque nos inimigos.
  • /criar npc: a tela do /skin abre com a aba NPC (nome, lado, corpo, ficha do bestiário e fala). NPCs hostis lutam; amigáveis conversam e entram nas lutas como aliados. Ficam salvos no mundo.
  • Documentação em docs/combate.md.

Testes: 1437 passaram, 5 pulados.

Ak4ai added 30 commits November 10, 2026 10:55
…atual

Porta a feature da branch local de setembro para o main atual, adaptada ao
TexturedMesh e aos shaders que já existem:

- src/world/schematic.py: parser de Sponge Schematic v1/v2/v3 (NBT + VarInt),
  com leitura do grid em NumPy, ids fora da palette viram ar e is_air que
  reconhece só air/cave_air/void_air (antes qualquer nome com "air").
- src/world/structure_mesher.py: face culling por máscara de sólidos, tabela
  de faces no lugar de seis blocos copiados; build_arrays não usa OpenGL.
  Centraliza pelo meio dos blocos ((dim-1)/2): o centramento antigo
  deslocava meio bloco.
- src/rendering/schematic_atlas.py: atlas por nome de bloco (SchematicAtlas,
  separado do TextureAtlas do mundo), com texturas animadas em tira reduzidas
  ao primeiro quadro e blocos derivados (degrau, laje, cerca, placa, botão)
  usando a textura do material.
- scripts/demo_schematic.py: visualizador, com --frames e --capture.
- tests/test_schematic.py: 19 testes (parser, culling, sentido das faces,
  centramento, atlas), sem precisar de GPU.
/schem load <nome|caminho> [x y z] abre a construção como holograma
translúcido na frente do jogador. As setas movem na horizontal (seguindo a
câmera), Shift+↑/↓ muda a altura, Enter fixa e Esc cancela. Fixada, a
construção passa a ter colisão e raycast, sem alterar os chunks.

Também: /schem list, place, cancel, remove, clear, info (apelidos em
português e /schematic); autocompletar com os nomes de assets/schematics.

- src/world/structure_layer.py: camada de construções fixadas; wrap_lookup
  faz a colisão enxergar os blocos sólidos como pedra.
- src/interactive/schematic_tool.py: prévia, teclado, fixação e desenho.
- src/main.py: ferramenta no modo --terrain; as construções são limpas ao
  trocar de mundo ou gerar nova seed.
- tests: 21 testes do fluxo, das teclas, da colisão e dos comandos; o teste
  do autocompletar passa a esperar /schem.
No lugar do corte por altura, o terreno passa a mostrar apenas o espaço em
que o jogador está: o teto, as paredes da frente e a terra por cima somem
(casa de bonecas) e o que fica fora escurece.

- src/world/room_reveal.py (sem OpenGL): janela de 48x32x48 células com o
  que é sólido (chunks e construções /schem); inundação do ar coberto a
  partir do jogador, que para onde o céu começa; decisão "dentro" pela
  fração do espaço aberta ao céu, com histerese (alpendre e marquise não
  contam; a copa de árvore não é teto); máscara 255 interior / 128 casca de
  1 bloco / 0 fora. Recálculo de ~1,5 ms, só quando o jogador ou o mundo muda.
- src/rendering/room_reveal.py: textura 3D da máscara, suavização do efeito
  (meia-vida de 0,12 s) e uniforms; ao sair, a máscara antiga fica na GPU
  até o efeito apagar.
- world_textured.frag: escurece o fora (brilho exterior) e descarta, com
  dither, o fragmento cujo raio da câmera chega ao interior do espaço. O
  espaço desenhado é girado pelo modelo do tabuleiro, então o shader volta
  ao mundo pela inversa do modelo.
- Shader: u_RoomMask ganha unidade 2 ao linkar, para não dividir a unidade 0
  com o atlas (o OpenGL recusa dois samplers de tipos diferentes na mesma).
- /revelar [on|off|escuro <0-1>].
- O corte antigo por altura continua como reserva fora de espaços fechados.
- 18 testes (cômodo, porta, alpendre, folhagem, histerese, construção /schem,
  janela, suavização e direção da câmera).
O raio que decide se um fragmento tapa a vista do espaço partia do pixel,
então uma parede fina com mais espaço do mesmo cômodo atrás era cortada em
escada no meio da face (uns pixels acertavam o espaço atrás, outros não).
Agora o raio parte do centro do bloco desenhado e todas as faces dele
ficam ou somem juntas, com o contorno em degraus de voxel.
Os malhadores já descartam a face de um bloco que encosta em outro opaco.
Quando o shader esconde o bloco da frente (teto, parede, terra por cima),
o bloco atrás ficava sem a face que encostava e se via o vazio por dentro:
blocos sem tampa, grandes áreas pretas na caverna e pontas de parede ocas.

- src/world/room_caps.py (sem OpenGL): repete na CPU a regra do shader para
  achar os blocos escondidos e gera só as faces que faltam, as dos blocos à
  vista voltadas para um bloco escondido. Como o raio parte do centro do
  bloco, o passo i cai num deslocamento inteiro igual para todas as células;
  desloca-se a máscara do espaço por passo distinto em vez de um raio por
  célula (resultado idêntico, 3 ms em vez de 40 a 96 ms).
- Tampas separadas por atlas: as do terreno usam uv_table/color_table do
  TextureAtlas; as das construções usam a tabela de faces do StructureMesher
  e o SchematicAtlas.
- room_reveal: extract_window_cells guarda o tipo de bloco e o dono de cada
  célula; RoomMask guarda a janela.
- Renderizador: refaz as tampas quando a máscara ou a direção da câmera muda
  (~3,5 ms por quadro enquanto o tabuleiro gira).
- 10 testes, inclusive a comparação do deslocamento inteiro com o raio
  calculado célula a célula em 4 direções de câmera.
Até aqui o /schem desenhava tudo como cubo inteiro. Agora cada bloco tem uma
forma, no estilo dos modelos de caixas do Minecraft.

- src/world/block_shapes.py (sem OpenGL): a lista de caixas de cada bloco, em
  1/16 de bloco, a partir do nome e das propriedades. Lajes (bottom/top/
  double), degraus (facing, half e os cantos interno e externo), alçapões
  (fechado e aberto), cercas e portões, muros (post e braços baixos e altos),
  barras e vidraças, placas de parede, portas (fechada e aberta), botões,
  placas de pressão, tochas (de pé e de parede), lanternas, correntes, velas,
  tapetes, vasos, bigorna, bolo e escada de mão. Cubo continua sendo None.
- A UV acompanha o recorte da caixa (uma laje mostra metade da textura).
- Corte de faces: só um cubo inteiro esconde a face do vizinho. Uma laje ou
  uma cerca ao lado não esconde mais a parede.
- Schematic: occupied_mask (desenhado), solid_mask (barra o personagem: tochas,
  tapetes, placas, botões, velas e vasos não barram nem selam um cômodo) e
  full_cube_mask.
- Revelar o espaço: a janela guarda occupied e culls; as tampas valem também
  para blocos com forma (a face inteira que encosta no limite da célula) e só
  cubos inteiros escondidos deixam o vizinho sem tampa.
- Vitrine com cerca de 30 formas: python scripts/demo_schematic.py --formas
  (e --zoom, --olhar).
- 35 testes: geometria por família, rotação por facing, UV recortada, sentido
  das faces, colisão, corte de faces, máscaras e tampas.
…ras do sol

- Grade: modo contorno (padrão), só onde a altura muda, como fita fina; G alterna contorno, grade completa e desligado.
- ChunkMesher: oclusão ambiente por vértice (cantos escurecem), com a diagonal do quad virada.
- Shader: brilho por face do Minecraft, sol quente, escurecimento por cota e mais saturação (u_WorldStyle).
- Sombras do sol por raio na textura 3D de sólidos (/sombras on|off|forca); ainda sem conferência visual.
…a mais próxima, fonte infinita), superfície inclinada e /agua
… em volta (critério do Isocraft)

- src/world/doors.py: acha a porta ao alcance e troca open nas duas metades; a porta aberta não barra
- as portas viram uma malha pequena à parte (refazer a casa inteira levava ~780 ms)
- interact_prompt: a tecla E em pixel ao lado da cabeça, com Abrir/Fechar; perto de porta o E não gira a câmera
- room_reveal: teto cobrindo >= 80% em volta e alguma parede conta como dentro, mesmo com lados abertos;
  sai abaixo de 45% (StructuralRoomClassifier do Isocraft)
- --keys=quadro:TECLA para conferências automáticas
…onagem (StoryBand e CameraCorridor do Isocraft)

- room_reveal.story_ceiling: o teto mais baixo acima da cabeça (com teto em >= 45% da volta) é o corte
- shader: do teto do andar para cima some num círculo de 24 blocos, com fade; o cilindro entre a câmera e o
  personagem (raio 2,6) some do nível dos pés para cima
- /revelar off desliga o corte do andar
- --pos=x,y,z para conferências
…ar no Minecraft); removida, ele volta

- WorldManager.clear_box/restore_box: caixas cortadas valem também para chunks gerados depois (sob a trava)
- restore_box gera de novo pela semente só a caixa, mantendo os outros cortes
- SchematicTool.on_place/on_remove ligados no main
…me só o que fica entre a câmera e o andar

- acima do teto do andar, a metade da frente some; a de trás só se tapa o andar do personagem
- o teste de 'tapa o espaço' conta só o andar do personagem (o de cima, ligado pela escada, não corta o fundo)
- abaixo do teto, o que fica atrás do personagem (mezanino, pilar, móveis) fica de pé
…s atrás do piso sem ficar pretos

- o corte do andar e a revelação passam a depender do cômodo, não da posição do personagem: some só a borda
  do cômodo virada para a câmera que o tapa; pilar, mezanino e móveis no meio ficam
- num cômodo o corredor da câmera só corta o que tapa o cômodo (nunca uma parede do fundo)
- o teto do andar é o mais alto em volta (um mezanino junto à parede não baixa o corte)
- máscara ganha a borda pela quina (64), iluminada como o cômodo: some o preto nos cantos, atrás do piso do
  mezanino e na altura do teto
…edor) e o fundo fica inteiro

- cut_cells espelha o shader: metade da frente pelo centro do cômodo, corte do andar, corredor da câmera; portas ficam
- shader: a parede do fundo só some se estiver virada para a câmera fora do cômodo
- teto do andar ignora colunas de parede/móvel na altura do corpo
- testes de cut_cells e das tampas
- máscara ganha OBJECT (192): sólido cuja coluna termina com o espaço do jogador em cima (degrau, móvel, piso)
- revelação do cômodo nunca corta OBJECT; o corredor só poupa o que está no chão (o piso de cima na frente sai)
- tampas seguem a mesma regra; teste com sala de dois andares e escada
Ak4ai and others added 25 commits November 11, 2026 10:22
…n modelo e seção Modelo na tela de criação)

O token desenha e anima o CustomModel no lugar do corpo montado; /skin modelo importa
(copia para saves/modelos), lista, troca perfil/altura/giro e volta ao personagem montado;
a escolha é gravada em saves/modelo.json e restaurada ao abrir (--sem-modelo ignora).
…péis dos ossos ajustados à mão

O leitor guarda os clipes dos ossos (TRS, LINEAR/STEP); ClipAnimator escolhe andar e parado pelo nome, mistura
conforme o personagem anda e trava o deslize horizontal da raiz. Arquivo com clipes toca os clipes por padrão
(/skin modelo perfil <procedural> força o procedural). /skin modelo papeis salvar|off|arquivo grava,
confere e usa os papéis em saves/modelos/<nome>.papeis.json.
…lizado e botão de importar .glb

Personalizado mostra Importar modelo (janela do sistema), os modelos guardados e os ajustes (andar, altura, giro,
papéis); com ele em uso as abas do corpo montado ficam com um aviso. /skin modelo modo e /skin modelo importar.
…sos na cor do papel e um clique troca

Aba Modelo: Mostrar os ossos, escolha do papel (perna, braço, cabeça, coluna, cauda, nenhum) e clique no osso
desenhado. Refaz as cadeias, grava saves/modelos/<nome>.papeis.json e anima já com elas.
…s pelo gerador, como mão e coxa)

mesh_repair pose o modelo em um ciclo de andar e marca triângulos com aresta > 1,8x e +1,5 cm; CustomModel.repair_stretch
tira e devolve. Ligado por padrão; /skin modelo reparar on|off e botão na aba Modelo; demo_modelo --sem-reparo.
…l-editor (merge manual)

Soma dos 9 commits de Rafael Adolfo Silva Ferreira (10 a 11/11/2026) sobre o histórico atual:
- 96a216f feat(editor): implementa editor de mapa e objetos voxel
- f06e2b3 feat(editor): objetos independentes, mapa jogavel e ferramentas de autoria
- d0c6f15 feat(mundo): coloca objetos no terreno procedural com persistencia por seed
- 2f2d562 feat(mundo): botao Colocar no HUD do mundo procedural
- c455c46 feat(exemplo): casa oca com portas abertas e interior jogavel
- 051abf5 feat(cutaway): revela personagem dentro de casas e mapas
- 36a4978 fix(input): evita empilhamento acidental e adiciona debounce de clique
- 57e28b5 feat(objetos): nomear objeto e exportar por nome de arquivo
- ac114aa feat(hud): paleta de cores clicavel estilo paint

O main.py foi integrado à mão com o terreno desta branch: o menu e o /schem, a revelação de cômodo e o cursor de contexto
convivem com o modo --map-editor, o mapa jogável (--map) e os objetos colocados no terreno (por seed). O mapa jogável
pula o rastreador de cômodos e o streaming de chunks. O ramo do editor ganhou shadow_renderer = None.
…o merge do editor

O merge manual deixou o bloco do corte translúcido (u_CutawayPass) duplicado e partido: o terreno era desenhado
uma vez a mais por quadro e, no subterrâneo, a transparência ficava com o estado trocado. Volta a ser o bloco
único de antes; o resto do main.py do terreno é igual ao da exp/camera-perspective (conferido linha a linha).
… leva o tom da água

O modo subterrâneo (corte do que está acima do jogador) passa a ignorar a água ao procurar o chão sobre o jogador
(get_top_solid_block(skip_water=True)): só um teto de verdade, como o de uma caverna, ativa o corte, inclusive uma
caverna sob um lago. Com o jogador na água, o personagem é desenhado com u_WaterMode, no mesmo tom azul do resto da cena.
…o) em vez da caixa de tábuas

make_chest_tiles.py recorta de textures/entity/chest (pacote, pasta ou client.jar) os ladrilhos chest_<variante>_<tipo>_<peça>.png
para o baú simples, o duplo (left/right), o de ender e o de armadilha; _chest monta corpo, tampa, chapa do topo e fecho com a
UV certa, sem sobrepor peças. O topo de fora é o 2º quadrado da folha (o 1º é o interior, visto com o baú aberto). Sem os
ladrilhos (arte da Mojang, fora do git) volta à caixa de tábuas. A amostra --formas ganha uma fileira de baús.
…sonagem para (sem inventário ainda)

find_chest acha o baú mais perto (como as portas); ChestSession guarda qual está aberto e o escurecimento suave; no main,
F fecha o baú aberto ou abre o mais perto (porta e baú: vale o mais perto; a porta sob o cursor tem preferência), o teclado
de movimento fica mudo com o baú aberto, Esc fecha, e o rótulo da tecla mostra Abrir/Fechar.
…go vale também para os objetos e o mapa do editor

Remove o corte por altura que o Rafael havia ligado ao editor (cutaway em MapWorld, WorldObjectRenderer e o teste do token dentro do objeto).
Os objetos colocados e o mapa viram construções só para o rastreador de cômodos (room_structures.py): o cômodo se revela, o resto escurece,
o corredor da câmera abre e as tampas dos cortes levam a cor do voxel. Os objetos e o mapa são desenhados dentro da revelação (antes da água
e da grade); a prévia e a seleção ficam fora. No mapa jogável o rastreador também roda, e --pos vale no mapa.
…tos/mapa do editor ganham as tampas dos cortes

Um vão de porta (ou janela sem vidro) é ar coberto colado ao céu: agora termina o cômodo como uma porta de verdade, em vez de entrar
no espaço do jogador e fazer sumir a parede em volta, que o tapava na vista da câmera (o buraco crescia além da porta). Só vale para
um cômodo quase fechado e a coluna de quem está no vão fica. As tampas dos cortes usam o atlas das construções, que só nascia no
primeiro /schem: a cena só com objetos ou mapa do editor nunca o criava e ficava sem tampas; agora main.py o pede (ensure_atlas).
O painel (colocar com o mouse, girar, selecionar, remover, nomear, lista) abre
só com /schem. Objetos do editor viram construções, salvas por mundo/seed.
Remove WorldObjectEditor. Inclui também as otimizações de mundo/água/cômodos,
a tela de configurações e as mudanças de baús desta sessão.
…vez de remontar a roupa a cada início

O CharacterModel guarda em saves/cache/personagem_montado.pkl o estado montado e as texturas, com uma chave
SHA-256 do save, das escolhas, das configurações, dos modelos em assets/models e do código de src/clothing.
Qualquer mudança nisso remonta e regrava; o tempo e a origem (cache ou montado) saem no console.
…o Minecraft

mc_font lê a folha de bitmap textures/font/ascii.png do jogo do jogador (assets/fonts/ascii.png ou o client.jar), mede cada
letra como o jogo (até a última coluna acesa, 1 pixel entre as letras, espaço de 4) e desenha com a sombra do jogo. O
overlay usa o texto em escala 2 (X: 0.5  Y: 13.0  Z: 0.5); sem a folha cai no desenho de segmentos de antes.

(cherry picked from commit 8a5efed6a55f0087e35adb5952e67b2960dca243)
Preferência show_fps (padrão False, guardada em saves/preferences.json), uma linha em Gráficos > Tela da
tela de configurações, e o contador do HUD (na fonte do Minecraft) sob as coordenadas, lido a cada meio segundo.

(cherry picked from commit 3623def309038e798e8eb6bd4ba8e02381e6dfca, adaptado para a tela de configurações nova)
A regra fica em src/combat/ (pura, sem OpenGL): dados com semente, atributos, CA e
redução de dano por categoria de armadura, efeitos por rodada, uma só resolução de
golpe para Atacar/Golpe Pesado/Ataque Furtivo, a sessão (iniciativa, ação e movimento
por vez, entrada no meio da luta, fuga por teste ou distância, vitória/derrota), IA por
situação no lugar do sorteio 70/30 e o bestiário.

No jogo: /inimigo põe criaturas como miniaturas no tabuleiro; clicar numa (luta de
surpresa) ou chegar perto abre o combate; o WASD gasta o movimento da vez, as teclas
1-6 escolhem a ação, Tab troca o alvo e Enter encerra a vez. O HUD mostra a ordem, o
menu, o registro com a conta de cada rolagem, a vida sobre as cabeças e os anéis de
movimento e alcance. /ficha e /atributo mexem na ficha, que é salva com o mundo.
Regras e diferenças em relação ao mod em docs/combate.md.
…submenus apagados

- durante o combate a caixa do chat vira o registro (título com a rodada, borda dourada,
  linhas coloridas com quebra por palavra) e se estica da margem esquerda até o menu de combate;
  [T] continua abrindo o chat normal, também limitado à borda do menu
- sai o painel de registro separado do HUD
- rastro de pontos ao andar na sua vez, recomeçando a cada turno
- com a ação gasta, os submenus aparecem apagados com o motivo
- com o mouse em cima de um inimigo o cursor de contexto vira o de ataque e o bloco não é destacado
- anel claro no inimigo sob o mouse, também fora da luta
- dica sobre a cabeça: nome, vida, CA e o que o clique faria (ataque de surpresa, mirar,
  atacar com a chance de acerto, ou o motivo de não poder)
…configurações

- novo combat_style: pergaminho com cantos de metal, Georgia nos títulos e Segoe UI no texto,
  botões em relevo, selos dourados das teclas e a paleta das telas
- ordem dos turnos em cartões (quem age em verde-escuro, o alvo com borda vermelha)
- menu da vez com movimento, pílula da ação, cartão do alvo e ações em botões
- etiquetas sobre as cabeças, dica do hover, faixa do fim e números que sobem no mesmo estilo
- o registro no chat vira um pergaminho, com as cores da luta passadas para tinta
- textos da faixa com acento (Vitória!, Você fugiu)
- à esquerda o estado da vez (movimento, ação, alvo); à direita os ladrilhos das ações em 3 colunas
- ícones vetoriais no traço das telas para cada ação, habilidade e item; a tecla num selo pequeno
  no canto de cima; submenus com a setinha e itens com a quantidade no canto
- o motivo curto no ladrilho apagado e o inteiro no rodapé
- o menu mais baixo deixa o chat (registro) só com a largura que sobra
- na passagem para a vez do jogador o cartão diz Sua vez
… mundo

- /criar npc <nome> <hostil|amigavel> <masculino|feminino> [molde] abre a tela do /skin com um
  corpo padrão do sexo pedido; ao fechar, o NPC aparece na frente do personagem e fica salvo no mundo
- a ficha de combate vem do molde do bestiário (padrão: bandido para hostil, guarda para amigável)
- hostil: inimigo como os outros; amigável: nunca começa a luta, conversa com um clique (balão e chat)
  e entra nas lutas por perto como aliado da IA (Combatant.ally), levantando depois se cair
- /npc lista | fala | editar | remover; /inimigo limpar deixa os NPCs
- NpcModels: um corpo montado em segundo plano por NPC, com cache de montagem próprio
  (saves/cache/npc_<id>.pkl), animado ao andar e deitado ao cair; a miniatura aparece enquanto monta
- a derrota vem quando o jogador cai, mesmo com aliados de pé
- o apelido /skin criar sai para dar lugar ao /criar
…fala

/criar npc não exige mais parâmetros (e aceita em qualquer ordem); a tela do
/skin abre com a aba NPC primeiro, com campos de texto para o nome e a fala e
botões para lado, corpo e molde do bestiário. A aba usa /npc definir, e o
/npc editar refaz o NPC no mesmo lugar ao fechar. Nomes repetidos ganham número.
@Ak4ai
Ak4ai enabled auto-merge November 18, 2026 03:10
Sem Consolas nem Arial, a fonte padrão do Pillow vinha miúda e o contorno
cobria o verbo dourado (falhava no CI). Tenta as DejaVu e usa a padrão no
tamanho pedido.
@Ak4ai
Ak4ai merged commit ed8c1d9 into main Nov 18, 2026
1 check passed
@Ak4ai
Ak4ai deleted the feat/combate-turnos branch November 18, 2026 03:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants