Inventário NES — primeira aquisição de espada
Link começa sem espada. Entre na caverna inicial e caminhe até a espada: a coleta ocorre por contato, sem apertar A. Link ergue o item, o slot A do HUD é preenchido e o ataque fica disponível depois da pose. Sair e voltar mantém a aquisição durante a partida; uma nova execução começa novamente sem espada.
Estrutura da ROM preservada
src/inventory mantém o bloco Items com os 40 slots originais, em vez de
um booleano separado para esta espada. items.generated.pbs contém as tabelas
ItemIdToSlot e ItemIdToDescriptor, com os 36 IDs originais. No descritor,
o nibble alto define a classe e o baixo define valor, quantidade ou grau.
A aquisição implementada nesta iteração é a de espada, classe 2:
| Item ID | Slot | Descritor | Valor em Items[0] |
|---|---|---|---|
| 1 | 0 | $21 |
1, espada de madeira |
| 2 | 0 | $22 |
2, espada branca |
| 3 | 0 | $23 |
3, espada mágica |
Zero significa ausência da espada. HandleClass2 só grava se o grau recebido
for maior ou igual ao atual. Uma espada inferior ainda é consumida pela
coleta, mas não rebaixa o inventário. Somente a espada de madeira está colocada
no mundo; visuais e efeitos dos demais equipamentos não foram implementados.
As tabelas completas estão preservadas como base para os próximos itens, sem
simular os efeitos especiais das classes 0 e 1 antes de portá-los.
O reset segue o código de nova partida da ROM: zera os 40 bytes e inicializa
Items[$18]=$22 (três corações/recipientes), Items[$19]=$FF (fração de vida)
e Items[$25]=8 (capacidade de bombas). Dano, cura e HUD de corações agora usam esses bytes; ver
sistema de vida. Os objetos de cura ainda não estão
colocados no mundo.
src/world mantém os 128 bytes de flags de salas do overworld. A aquisição usa
o bit $10 da sala $77, separado de Items. Assim, o estado de um item de
sala não é inferido apenas do nível atual da espada. Outros bits do byte são
preservados ao marcar a aquisição. Não há gravação em disco/memcard ainda.
Comportamento da primeira caverna
A condição de coleta vem de UpdateCavePersonState_TalkOrShopOrDoorCharge:
ObjX=120 e abs(ObjY-152)<6. A borda Y=158 ainda não coleta;
Y=157 já coleta. O X visual da espada é 124 devido ao alinhamento de um
sprite estreito, mas a coordenada de contato usa 120, como na ROM.
A aquisição marca a sala e atualiza Items[0] no mesmo frame. O item no piso
e o texto desaparecem. O velho pisca durante o contador de 64 frames e então
some; nas visitas seguintes, não há velho, texto ou espada, mas as fogueiras
continuam presentes. O texto inicial continua aparecendo inteiro, sem a
progressão de diálogo da ROM, e o fogo permanece estático. Não há som.
TakeItem arma um contador de 128 frames. CheckLiftItem decrementa antes
do desenho: a pose aparece nos ticks 1–127, e o estado normal retorna no tick
128. A movimentação e o ataque ficam suspensos durante esse período. Segurar
A durante a pose não sintetiza um novo pressionamento ao terminá-la.
O desenho usa os tiles originais $78/$79 à esquerda e $08/$09 à direita,
com espelhamento horizontal na metade direita e a espada $20/$21 erguida
com uma mão. A troca do tile direito em DrawLinkLiftingItem preserva o
atributo OAM $40 definido por Anim_WriteMirroredSpritePair. O tile $78 vem do bloco de demo
residente em CHR $0700..$08DF, preservado quando o overworld carrega a partir
de $08E0. A reconstrução extracted/graphics/ppu/overworld_sprites.png foi
corrigida para incluir esse resíduo. O desenho da pose usa o deslocamento OAM
de uma linha, sem os dois pixels adicionais da caminhada do overworld.
Organização e APIs
Inventory.reset/read_slot/sword_level/take_sword: acesso ao bloco Items e aquisição de espada pelos descritores da ROM.WorldFlags.reset/room_item_taken/mark_room_item_taken: flags da sala.CavePickup: contato com o item, flag de aquisição e contador do velho.Link.update: controle, aquisição e duração da pose;Link.draw: corpo/arma.Hud.draw: escolhe o tile com ou sem espada a partir deItems[0].Stage.render_revision: atualiza o visual da caverna sem confundir a revisão visual com a identidade da stage usada por colisões e transições.
Os bancos existentes mantiveram seus IDs e slots. A pose de aquisição usa
assets/characters/link_pickup, glyph slot 5. Os glyphs 0–15 do HUD continuam
iguais; o glyph 16 substitui apenas a região do slot A quando não há espada.
As variantes de caverna usam scene slots 1 (antes), 2 (velho sem texto/item)
e 3 (após o velho sumir), compartilhando o mesmo banco de 44 glyphs.
Evidências e reprodução
python3 tools/prepare_inventory.py
python3 tools/prepare_hud.py
python3 tools/prepare_cave.py
python3 tools/validate_inventory.py
Os geradores verificam o hash da ROM e são idempotentes para as mesmas entradas.
Preservam identidades dos assets; substituem os PNGs e fontes marcados como
gerados. rom-data.json registra tabelas, defaults, offsets e condições da coleta.
validation/sequence.json registra as entradas e o build de duas sessões reais
do Studio. O validador compara as capturas salvas, sem recapturá-las: 28 frames
completos coincidiram pixel a pixel. Inclui A sem espada, a borda de coleta,
a pose em 1/127/128, bloqueio dos comandos, A mantido, ataque adquirido,
retorno ao overworld, segunda visita sem respawn e nova partida restaurando o item.
O validador também confere as tabelas contra os bytes da ROM e executa uma
porção limitada da rotina 6502 HandleClass2 em 12 combinações de grau anterior
e recebido. Isso verifica a regra de não rebaixamento na ROM; o percurso do
guest exercita a aquisição 0→1. Não equivale à execução completa num emulador NES.
Build/pack passaram e os 15 arquivos PBS envolvidos tiveram diagnostics vazios.
Referências locais consultadas: ItemIdToSlot, ItemIdToDescriptor, TakeItem,
HandleClass2, coleta da caverna e suas flags em
Z_01.asm;
reset do bloco Items em
Z_02.asm;
CheckLiftItem e DrawLinkLiftingItem em
Z_07.asm.