Tessere interattive con le Regioni in Foundry VTT 14

1. La Regione
   Un’area disegnata sulla mappa con lo strumento delle Regioni: la leva, la trappola, il cerchio davanti all’altare.
2. Il Comportamento
   Cosa fa la Regione. In V14 il core offre, tra gli altri: Esegui Script, Esegui Macro, Mostra Testo Scorrevole, Pausa Gioco, Attiva/disattiva Comportamento, Teletrasporta Token, Definisci Superficie.
3. L’Evento
   Quando scatta il comportamento. Il più utile per noi è Token Entra.

Il comportamento Esegui Script esegue il codice che scrivi direttamente nella Regione. Nel codice hai a disposizione scene, region, behavior ed event; il token che è entrato è event.data.token.

1. Posiziona il tetto
   Crea una tessera con l’immagine del tetto, allineata ai muri della casa. Nome: «Tetto taverna».
2. Alza l’elevazione
   Dall’HUD imposta un’elevazione più alta dei token, per esempio 10.
3. Scegli l’occlusione
   Nella scheda In Primo Piano attiva Dissolvenza e lascia Alpha Occlusione a 0.
4. Aggiungi Visione
   Attiva anche Visione: chi guarda dalla porta vede dentro anche senza entrare.
5. Restrizioni
   Attiva Restringe Meteo per non far piovere dentro casa.

La V14 aggiunge la modalità di occlusione Superficie, pensata per lavorare con le Regioni che hanno il comportamento Definisci Superficie.

1. Disegna la Regione
   Copri la stanza o il piano con una Regione.
2. Aggiungi Definisci Superficie
   Nel comportamento attiva l’opzione Occlusione.
3. Imposta la tessera
   Nella scheda In Primo Piano della tessera scegli Superficie.

Quando un token controllato o rilevato si trova sotto la superficie, le tessere in modalità Superficie poste a quella quota o più in alto svaniscono. Funziona anche passando il cursore sulla Regione o con il tasto Evidenzia Oggetti.

1. Tessera «Muro segreto»
   Un’immagine di parete di pietra, visibile, sopra il varco.
2. Tessera «Passaggio»
   L’immagine del corridoio aperto, nella stessa posizione. Rendila nascosta dall’HUD.
3. La porta segreta
   Nel varco disegna un muro e in Tipo Porta scegli Porta Segreta, chiusa: è lei a bloccare davvero vista e movimento.
4. L’ID della porta
   Seleziona la porta con lo strumento dei muri, premi F12, apri la Console e scrivi:

   Copia

   canvas.walls.controlled.map(w => w.id)

   Copia l’ID che appare.
5. La Regione
   Disegna una piccola Regione sulla leva o sulla piastra a pressione.

1. Esegui Script
   Nella Regione aggiungi un comportamento Esegui Script con l’evento Token Entra.
2. Genera lo script
   Usa il generatore nella prossima slide: Mostra «Passaggio», Nascondi «Muro segreto», Apri la porta con l’ID copiato, suono sounds/lock.wav, solo una volta.
3. Incolla e salva
   Incolla il codice nel campo Script e salva.

1. Tessera «Pavimento»
   L’immagine del pavimento integro sopra la zona della trappola.
2. Prepara l’immagine della buca
   Carica nei tuoi file l’immagine del pavimento crollato e copia il percorso dal browser dei file.
3. La Regione
   Copri la zona con una Regione.
4. Comportamento 1: Esegui Script
   Evento Token Entra. Nel generatore compila solo «Tessera a cui cambiare immagine» = Pavimento e «Nuova immagine» = il percorso della buca.
5. Comportamento 2: Mostra Testo Scorrevole
   Per esempio «Il pavimento crolla!» sul token.
6. Comportamento 3: Pausa Gioco
   Spunta l’opzione che lo fa scattare una sola volta (Once): il gioco si ferma e hai il tempo di chiedere il tiro salvezza.

1. Tessera «Portale»
   Un video WebM con trasparenza. Nella scheda Video attiva Ripeti Video e Avvio Automatico Video.
2. Nascondila
   Dall’HUD rendila nascosta ai giocatori.
3. La Regione
   Un cerchio di Regione davanti all’altare.
4. Esegui Script
   Evento Token Entra; nel generatore Mostra «Portale», con un suono a tua scelta.
5. Un tocco in più
   Aggiungi Mostra Testo Scorrevole: «L’altare si risveglia».

La zona dorata è la Regione con Esegui Script sull’evento Token Entra. Entra e guarda il registro.

Gli script generati salvano lo stato originale di ogni tessera e porta che modificano (in un flag world.dmBak) e segnano i comportamenti spenti dall’opzione «Solo una volta». Così una macro può rimettere tutto a posto, per esempio prima di rigiocare una one-shot.

1. Crea la macro
   Nella barra delle macro crea una nuova macro di tipo Script, nome «Ripristina scena».
2. Incolla il codice
   Copia il codice qui sotto.
3. Usala
   Apri la scena da ripristinare ed esegui la macro.

// Dragon Magic - Ripristina la scena (Foundry VTT 14)
// Riporta tessere, porte e comportamenti allo stato iniziale.
const scene = canvas.scene;
let n = 0;
for (const t of scene.tiles) {
  const b = t.getFlag("world", "dmBak");
  if (!b) continue;
  await t.update({ hidden: b.hidden, "texture.src": b.src, "flags.world.dmBak": null });
  n++;
}
for (const w of scene.walls) {
  const b = w.getFlag("world", "dmBak");
  if (!b) continue;
  await w.update({ ds: b.ds, "flags.world.dmBak": null });
  n++;
}
for (const r of scene.regions) {
  for (const b of r.behaviors) {
    if (!b.getFlag("world", "dmOnce")) continue;
    await b.update({ disabled: false, "flags.world.dmOnce": null });
    n++;
  }
}
ui.notifications.info(`Scena ripristinata: ${n} elementi.`);

• Ogni tessera usata negli script ha un nome unico e scritto uguale.
• Le tessere da mostrare sono nascoste dall’HUD prima della sessione.
• Il comportamento Esegui Script usa l’evento Token Entra.
• Ho provato la scena con un account giocatore, non solo da GM.
• Ho la macro «Ripristina scena» nella barra.
• Durante la partita il GM è collegato.

• Aprire i tetti con Dissolvenza, Visione e Superficie.
• Collegare tessere e Regioni con Esegui Script ed evento Token Entra.
• Mostrare, nascondere e cambiare immagine alle tessere, aprire porte e riprodurre suoni.
• Ripristinare la scena con una macro.

Uso queste tecniche nelle mie sessioni su Foundry VTT. Se vuoi giocare una one-shot, la sessione 0 è gratuita.

Tutti i tutorial di Foundry VTT →

Fonti: articolo ufficiale sulle Regioni (Version 14.369), articolo ufficiale sulle tessere, API di Foundry VTT 14.