# Textex — archivio v5
Artwork originali trasposti con image_gen; esportazione PNG trasparenti a griglia, palette comune, filtro nearest, alpha binario.

## Nuove aggiunte
12 equipaggiamenti: armatura, elmo, spada e scudo nei set oscuro (nero), rosa e smeraldo. Armature, elmi e scudi hanno 8 viste; le spade seguono la mano nelle animazioni di attacco corpo a corpo. Quattro pozioni animate (4 frame ciascuna): curativa, invisibile, accecante e velocità. Corte indicativa con viale a croce, quattro prati e scale in basso, dalla scansione ruotata di 180 gradi.

I nuovi set sono selezionabili separatamente in “I personaggi”: anteprima visiva su camminata, attacco e parata. Danni, difesa, resistenza degli scudi e parametri delle pozioni restano null in equipment-art.json / catalog.json fino alla definizione del bilanciamento. Non vengono assegnati valori inventati né effetti di pozione nella scena di prova.

## Combattimento iniziale
L’eroe non spara mai. Raccoglie con E il rametto dall’alberello (scorta infinita) e la ruota dal carretto. Rametto: 1 danno, Spazio per attaccare. Ruota: Shift per parare frontalmente, 2 colpi; lampeggia all’ultimo colpo, scompare alla rottura e torna dopo 5 secondi. Prova dei proiettili nemici attivabile nella scena iniziale. Arma, scudo, armatura ed elmo sono strati visivi separati. Le nuove selezioni del laboratorio non cambiano il bilanciamento della prova iniziale.

## Asset e anteprima
270 frame, 42 sequenze animate, 6 personaggi, 32 oggetti; bestiario precedente conservato. Eroe: 104 frame in 8 direzioni, posa/cammino/attacco/parata. Gli NPC restano rivolti alla camera. I boss precedenti hanno frame 160×160, eroe e mob 64×64. Alberello e carretto 128×128.

Avvio: node scripts/preview-sprites.cjs; aprire http://127.0.0.1:8877/assets/adventure/index.html.
Anteprima Canvas a camera fissa dall’alto: non ancora il gioco completo né il motore 3D definitivo. Stanze selezionabili manualmente; collegamenti non assegnati restano da definire. Il nome dell’eroe resta provvisorio.

catalog.json contiene percorsi PNG, rettangoli, pivot e durate; characters/<id>/ contiene atlas, fotogrammi e WebP. equipment-art.json conserva nomi e slot dei nuovi oggetti. world/rooms.json conserva le mappe, world/story.json la trama.

## Build e verifica
node scripts/build-adventure.cjs
node scripts/build-expansion.cjs
node scripts/verify-adventure.cjs
node scripts/test-equipment.cjs

Eseguire entrambi i build in ordine. Il secondo aggiunge l’espansione al catalogo. Le verifiche controllano palette, trasparenza, rettangoli, direzioni e animazioni; i test di combattimento verificano danno, parata, lampeggio e recupero esatto. Generazioni originali conservate in source/.

## Mondo completo
24 stanze generate da scripts/build-world.cjs, 48 nemici inclusi 6 boss, 22 ricompense oltre ai pickup iniziali. Selezione e passaggi cliccabili nella preview. I nemici sono schieramenti animati: AI, ondate, raccolta delle nuove ricompense e sblocchi non sono ancora gameplay. world/rooms.json contiene layout e collocazioni; world/full-map.json la mappa strategica sincronizzata.

## Controller
Gamepad con mapping standard del browser (Xbox e compatibili): stick sinistro o D-pad movimento, RT attacco alla pressione, LT difesa mantenuta, A interazione/raccolta, B corsa mantenuta (1,8 volte la velocità base; la parata mantiene la propria velocità). A apre anche la schermata iniziale. Deadzone stick 20%, diagonali normalizzate, nessun input a finestra non attiva. Premi un tasto del pad per il rilevamento del browser. Verifiche: node scripts/test-controller.cjs; simulazione Gamepad nel browser. Hardware fisico non verificato.
