Vai al contenuto principale

Stream Deck per Foundry VTT

Configurare Stream Deck con Foundry VTT

Colleghi il plugin Stream Deck al modulo JDR Ninja, provi un primo tasto, poi prepari tasti utili per la partita: cambiare scena, rivelare indizi, seguire la tensione.

Cosa può preparare

Gli esempi qui sotto descrivono usi concreti durante la partita. Se la Sua installazione funziona già, passi direttamente a quello che Le interessa.

Requisiti

Prepari Foundry V14 o successivo, il modulo JDR Ninja attivo, l’applicazione Stream Deck, il plugin JDR Ninja e Node.js 24. Il server Foundry può essere remoto, ma apra Foundry in un browser sul computer su cui funziona Stream Deck.

Installare il modulo Foundry

Installare il plugin

La distribuzione pubblica è in preparazione. Se dispone di una versione di sviluppo, installi il file .streamDeckPlugin nell’applicazione Stream Deck. Per attivare la connessione locale, apra un terminale nella cartella stream-deck dei sorgenti e installi le dipendenze con il comando seguente.

npm ci

Se ha ricevuto un archivio .tgz, lo estragga, apra un terminale nella sua cartella e usi invece questo comando. Node.js 24 deve essere installato separatamente.

npm install --omit=dev --ignore-scripts

La connessione locale resta attiva finché questo terminale è aperto e non si avvia da sola. Mantenga la finestra aperta durante la partita.

Preparare la connessione locale

Avvii l’inizializzazione con il primo comando. Inserisca l’indirizzo esatto di Foundry così come appare nel browser, per esempio http://localhost:30000 o https://foundry.example.net, senza percorso né barra finale. Copi la chiave di abbinamento generata: la inserirà in Foundry e nel plugin. Avvii poi la connessione locale con il secondo comando.

npm run companion:init
npm run companion

La configurazione viene salvata nel Suo profilo utente, in uno dei percorsi seguenti. L’inizializzazione non sovrascrive file esistenti. Per cambiare l’indirizzo di Foundry, la porta o la chiave, arresti la connessione locale con Ctrl+C, modifichi il file di configurazione e la riavvii. Se la chiave cambia, inserisca la nuova chiave in Foundry e nel plugin.

  • Windows : %LOCALAPPDATA%\JDR Ninja\companion.json
  • macOS / Linux : ~/.config/jdr-ninja/companion.json

Collegare Foundry

In Foundry apra la finestra « Connessioni JDR Ninja » e faccia clic su « Configurare Stream Deck » nel riquadro di Stream Deck. Inserisca l’indirizzo seguente e la chiave di abbinamento, poi faccia clic su « Salvare e attivare »: questo pulsante salva la connessione e attiva Stream Deck in questo browser. Il riquadro indica « Pronto » quando la connessione locale è stabilita.

ws://127.0.0.1:19114/jdr-ninja

Collegare il plugin Stream Deck

Aggiunga l’azione « Foundry Control » a un tasto. L’inspector non ha una traduzione italiana e usa l’inglese: inserisca l’indirizzo seguente in « Connection address », la stessa chiave in « Pairing key » e scelga « Connect ». Le impostazioni di connessione sono condivise tra i tasti; il campo della chiave si svuota dopo il salvataggio.

ws://127.0.0.1:19114/stream-deck

Questa chiave serve solo per la connessione locale tra Stream Deck e Foundry. È diversa dal token di connessione Atlas e dalle credenziali dell’account JDR Ninja. Non inserisca nessuna di queste altre credenziali nel campo « Pairing key ».

Scegliere la sessione Foundry

In « Foundry world and browser » scelga mondo, utente e browser desiderati. Attenda « Ready » e l’elenco dei comandi e documenti autorizzati. Ogni tasto memorizza sessione, comando e parametri propri. Non cambia automaticamente mondo, utente o browser.

Creare e provare il primo comando

In « Command » scelga « Open actor » e un attore di cui può aprire la scheda. Prema il tasto una volta. Verifichi la scheda in Foundry e il risultato « Completed. » nell’inspector. Un comando ammesso può ancora attendere l’esecuzione.

Un risultato incerto può mostrare brevemente « ? » sul tasto. Controlli cosa è successo in Foundry prima di premere di nuovo. La sezione seguente mostra come preparare tasti utili durante la partita.

Riutilizzare i tasti durante la partita

Questi esempi partono da tasti fissi, poi introducono una nozione alla volta: un elenco per scegliere tra più documenti, una variabile per salvare un valore, un comando combinato per modificare un valore prima di agire in Foundry, gli argomenti per le macro e la modifica diretta di un campo della scheda. Gli ultimi due esempi combinano questa modifica con le variabili: rivelare pagine di diario in modo definitivo e mostrare la tensione ai giocatori. Solo l’esempio delle macro richiede uno script. Variabili ed elenchi si creano in Foundry; i comandi che li usano compaiono nell’elenco « Command » preceduti da « Advanced · », come « Update a document ».

Preparare i comandi per la prossima scena

I Suoi giocatori lasciano la locanda per la cripta. Prepari tre tasti per questo cambio di luogo: il primo attiva la scena, il secondo avvia la relativa atmosfera sonora e il terzo abbassa l’illuminazione.

Prima di iniziare

Acceda come master: questi tre comandi gli sono riservati. Il mondo contiene già la scena e una playlist con la traccia audio desiderata.

In Foundry

Non serve alcuna impostazione del modulo: questi comandi usano valori fissi, scelti direttamente nell’inspector.

Su Stream Deck

Preparare i comandi per la prossima scena
Tasto Comando Impostazioni
Andare alla cripta Activate scene « Document »: la scena della cripta.
Atmosfera della cripta Play or stop sound « Document »: la traccia audio. « Play »: Yes (il valore proposto è No, che arresta la traccia).
Oscurare Set darkness « Document »: la scena della cripta. « Value »: un numero da 0 (piena luce) a 1 (oscurità totale), per esempio 0,7.

Provare e tornare allo stato iniziale

Prema i tre tasti in ordine: la scena della cripta viene mostrata ai giocatori, la traccia parte e l’illuminazione si abbassa. Il tasto dell’oscurità mostra in percentuale l’oscurità della scena aperta nel Suo browser. Per tornare allo stato iniziale, aggiunga un tasto « Play or stop sound » con « Play » impostato su No e un tasto dell’oscurità con valore 0.

Da sapere

« Activate scene » mostra la scena a tutti i giocatori. « View scene » cambia soltanto la Sua vista: può così preparare il seguito senza che i giocatori lo vedano. I tre comandi restano separati: per eseguirli in sequenza con lo stesso tasto serve una macro che li contenga.

Scorrere i PNG con gli stessi tasti

Nella locanda i Suoi giocatori interrogano più PNG. Due tasti permettono di passare da un PNG all’altro e un terzo apre la scheda del PNG scelto. Il tasto di apertura vale per tutto l’elenco: aggiungere o riordinare dei PNG non richiede alcuna modifica su Stream Deck.

Prima di iniziare

Qualsiasi utente può seguire questo esempio con le proprie variabili personali. Il mondo contiene già tre attori di cui può aprire la scheda.

In Foundry

  1. Apra « Variabili ed elenchi (avanzato) » nelle impostazioni del modulo e scelga « Personale ». Nella scheda « Elenchi di valori » crei l’elenco « PNG della locanda » di tipo « Attore ». Per ogni PNG faccia clic su « Aggiungere una voce », inserisca una « Etichetta » e selezioni l’attore tra i suggerimenti del campo « UUID del documento (riferimento specifico) ». Salvi.
  2. Nella scheda « Variabili » crei « PNG scelto »: « Tipo di valore » su « Attore », « Definizione » su « Selezione da un elenco », « Elenco associato » su « PNG della locanda » e il primo PNG come « Valore predefinito ». Spunti la casella « Tornare all’inizio dopo l’ultima voce » se l’elenco deve ricominciare dopo l’ultimo PNG. Salvi.
  3. Una nuova selezione non ha ancora un valore attuale. In « Modificare il valore attuale » scelga « Ripristinare il valore predefinito », poi « Applicare ».

Su Stream Deck

Scorrere i PNG con gli stessi tasti
Tasto Comando Impostazioni
PNG precedente Previous list entry « Variable (advanced) »: PNG scelto.
PNG successivo Next list entry « Variable (advanced) »: PNG scelto.
Aprire il PNG Open actor « Actor »: « Value source » su « Variable (advanced) », poi la variabile PNG scelto.

Provare e tornare allo stato iniziale

Prema « Aprire il PNG »: si apre la scheda del primo PNG. Prema « PNG successivo », poi di nuovo « Aprire il PNG »: si apre la scheda del secondo. Il PNG scelto compare nella finestra « Variabili ed elenchi (avanzato) » e sotto « Current preview » nell’inspector. Per tornare al primo PNG, aggiunga un tasto « Reset variable » sulla stessa variabile.

Da sapere

I tasti non mostrano né il ritratto né il nome del PNG scelto: verifichi la selezione in Foundry o nell’inspector. Senza ritorno all’inizio, « Next list entry » non cambia nulla sull’ultimo PNG.

Rivelare gli indizi nell’ordine

I Suoi giocatori indagano nella cripta e Lei vuole mostrare loro tre indizi nell’ordine previsto. Dopo il primo indizio, basta un tasto per passare all’indizio successivo e mostrarlo ai giocatori, senza macro.

Prima di iniziare

Acceda come master: mostrare una pagina è riservato al master, che deve esserne anche proprietario. Prepari tre pagine di diario, una per indizio, e dia ai giocatori almeno il permesso Osservatore su ciascuna. I giocatori devono essere connessi per ricevere la pagina.

In Foundry

  1. In « Variabili ed elenchi (avanzato) » scelga « Personale »: basta per i Suoi tasti. Crei l’elenco « Indizi della cripta » di tipo « Pagina di diario » e aggiunga le tre pagine nell’ordine in cui vuole mostrarle.
  2. Crei la variabile « Indizio attuale »: « Tipo di valore » su « Pagina di diario », « Definizione » su « Selezione da un elenco », questo elenco come « Elenco associato » e la prima pagina come « Valore predefinito ». Lasci non spuntata la casella « Tornare all’inizio dopo l’ultima voce ».
  3. Salvi, poi applichi « Ripristinare il valore predefinito » in « Modificare il valore attuale ».

Su Stream Deck

Rivelare gli indizi nell’ordine
Tasto Comando Impostazioni
Indizio precedente Previous list entry « Variable (advanced) »: Indizio attuale.
Indizio successivo Next list entry « Variable (advanced) »: Indizio attuale.
Mostrare l’indizio Share journal page « Document »: « Value source » su « Variable (advanced) », poi la variabile Indizio attuale. « Audience »: Players.
Indizio successivo e mostrarlo Change variables and run command « Add variable change »: « Operation » su « Next list entry » (il valore proposto è « Toggle variable »), « Variable (advanced) » su Indizio attuale. « Foundry command »: « Share journal page », con le stesse impostazioni di « Mostrare l’indizio ».

Provare e tornare allo stato iniziale

Provi prima separatamente i primi tre tasti per verificare la selezione e i destinatari. Durante la partita mostri il primo indizio con « Mostrare l’indizio », poi usi « Indizio successivo e mostrarlo »: a ogni pressione la pagina successiva viene selezionata e mostrata ai giocatori connessi. Iniziare dal tasto combinato farebbe saltare il primo indizio. Per rigiocare l’indagine, applichi « Ripristinare il valore predefinito »: l’indizio attuale torna a essere il primo, ma le pagine già mostrate non vengono ritirate ai giocatori e i loro permessi non cambiano.

Da sapere

Dopo l’ultimo indizio il tasto combinato non cambia più pagina e mostra di nuovo l’ultima. Se un giocatore non ha il permesso Osservatore, il comando viene rifiutato e l’indizio attuale non cambia. L’opzione « Show without changing ownership » mostra la pagina una volta, senza modificare questi permessi.

Annunciare il livello di tensione

In una partita horror Lei fa salire la tensione quando la situazione peggiora. Un tasto aggiunge 1 al contatore e annuncia il nuovo livello nella chat, per esempio « Tensione: 3 / 6 ». Decide Lei quando premere: nessun evento del gioco fa salire il contatore da solo.

Prima di iniziare

Qualsiasi utente può creare questa variabile personale e scrivere nella chat. Non serve alcun documento.

In Foundry

In « Variabili ed elenchi (avanzato) », sotto « Personale », crei la variabile « Tensione »: « Tipo di valore » su « Numero », « Definizione » su « Valore salvato », « Minimo » 0, « Massimo » 6, « Valore predefinito » e « Valore attuale » 0. Spunti la casella « Limitare aumenti e riduzioni ai limiti ». Salvi.

Su Stream Deck

Annunciare il livello di tensione
Tasto Comando Impostazioni
Aumentare la tensione Increase variable « Variable (advanced) »: Tensione. « Adjustment »: 1 (il valore proposto è 0, che non cambia nulla).
Ridurre la tensione Decrease variable « Variable (advanced) »: Tensione. « Adjustment »: 1.
Azzerare Reset variable « Variable (advanced) »: Tensione.
Aumentare e annunciare Change variables and run command Una modifica « Increase variable » su Tensione, « Adjustment » 1. « Foundry command »: « Send chat message ». « Chat message »: « Value source » su « Compose text (advanced) », poi tre parti in ordine: il testo « Tensione: » seguito da uno spazio, la variabile Tensione e il testo « / 6 » preceduto da uno spazio.

Provare e tornare allo stato iniziale

Verifichi prima i primi tre tasti: il valore di Tensione cambia nella finestra « Variabili ed elenchi (avanzato) ». Poi, con il contatore a 2, prema « Aumentare e annunciare »: il contatore passa a 3 e la chat mostra « Tensione: 3 / 6 ». Il messaggio è pubblico e inviato a Suo nome. « Azzerare » riporta il contatore a 0 senza rimuovere i messaggi già inviati.

Da sapere

Al massimo il contatore resta a 6, ma il messaggio viene comunque inviato. Se l’invio del messaggio non riesce, il nuovo valore può restare salvato e il tasto mostra « ! »: verifichi il contatore e la chat in Foundry prima di premere di nuovo.

Effettuare un tiro con un bonus variabile

Un alleato aiuta il personaggio o una posizione sopraelevata facilita il suo tiro: il bonus cambia da una scena all’altra. Salvi questo bonus in una variabile: un solo tasto tira allora 1d20 più il bonus attuale. Ogni pressione usa il valore del momento.

Prima di iniziare

Qualsiasi utente può tirare i dadi e creare le proprie variabili personali. Non serve alcun documento.

In Foundry

Sotto « Personale » crei la variabile « Bonus situazionale »: « Tipo di valore » su « Numero », « Definizione » su « Valore salvato », « Minimo » 0, « Massimo » 5, « Valore predefinito » e « Valore attuale » 0. Spunti la casella « Limitare aumenti e riduzioni ai limiti ». Salvi.

Su Stream Deck

Effettuare un tiro con un bonus variabile
Tasto Comando Impostazioni
Aumentare il bonus Increase variable « Variable (advanced) »: Bonus situazionale. « Adjustment »: 1.
Ridurre il bonus Decrease variable « Variable (advanced) »: Bonus situazionale. « Adjustment »: 1.
Bonus a zero Reset variable « Variable (advanced) »: Bonus situazionale.
Tiro con bonus Roll dice « Dice expression »: « Value source » su « Compose text (advanced) », poi il testo « 1d20 + » e la variabile Bonus situazionale. « Roll visibility »: « Only me » per esercitarsi.

Provare e tornare allo stato iniziale

Scelga il comando « Roll dice » nell’azione « Foundry Control »: l’azione Stream Deck « Roll Dice » è un’altra azione, destinata all’overlay. Prema « Tiro con bonus »: il risultato compare nella chat di Foundry, solo per Lei. Aumenti il bonus due volte e prema di nuovo: il tiro usa 1d20 + 2. Quando il tavolo deve vedere il tiro, scelga « Everyone ». « Bonus a zero » riporta il bonus a 0.

Da sapere

È un tiro di dadi generico: non sostituisce i tiri di attacco o di danno del sistema di gioco, e la variabile non segue alcuna caratteristica dell’attore. L’espressione accetta dadi, numeri e operazioni semplici, ma non modificatori come « kh »: un tiro « 2d20kh1 » viene rifiutato.

Passare dei valori a una macro

Ha già una macro script che agisce su un attore in base a una quantità. Invece di copiarla per ogni caso, ne dichiari gli argomenti: ogni tasto avvia la stessa macro con il proprio attore e la propria quantità.

Prima di iniziare

È l’unico esempio che richiede uno script. La macro deve essere una macro script di cui Lei è proprietario e che può eseguire. Il modulo non fornisce alcuna macro già pronta e non modifica il Suo script.

In Foundry

  1. Apra « Macro compatibili (avanzato) », scelga la macro, poi « Configurare la macro ». Con « Aggiungere un argomento » dichiari per esempio « bersaglio » di tipo « Attore » e « quantita » di tipo « Numero ». Il nome di un argomento inizia con una lettera e non contiene né accenti né spazi. Spunti « Obbligatorio », oppure spunti « Usare un valore predefinito » e indichi il « Valore predefinito ». Faccia poi clic su « Salvare ».
  2. Nello script legga i valori in scope.jdrNinja.arguments. Un documento vi viene passato sotto forma di UUID; un numero, un testo o un booleano vi viene passato così com’è.
  3. Termini lo script con la riga di conferma mostrata nella finestra « Macro compatibili (avanzato) ». Senza di essa, il tasto segnala un risultato incerto, anche se la macro ha funzionato.

Su Stream Deck

Passare dei valori a una macro
Tasto Comando Impostazioni
Primo caso Execute macro « Document »: la Sua macro. Spunti « Macro arguments (Advanced) », poi « bersaglio »: un primo attore e « quantita »: 2.
Secondo caso Execute macro La stessa macro, con « quantita »: 5. Per « bersaglio » imposti « Value source » su « Variable (advanced) », poi scelga la variabile PNG scelto: la macro agisce allora sul PNG selezionato nell’esempio dei PNG.

Provare e tornare allo stato iniziale

Prema ogni tasto e verifichi in Foundry l’effetto della macro sull’attore interessato. L’inspector mostra « Completed. » una volta ricevuta la conferma. Tornare allo stato iniziale dipende da ciò che fa la Sua macro: il modulo non annulla nulla.

Da sapere

La finestra di dichiarazione non crea alcuno script: descrive soltanto i valori attesi. Una macro senza argomenti dichiarati non ne riceve, e l’inspector chiede allora di scegliere una macro che dichiari argomenti compatibili in Foundry.

Dare l’ispirazione

Uno dei Suoi giocatori ha appena compiuto un’impresa e merita l’ispirazione. In una partita di D&D5e, un solo tasto attiva l’ispirazione sulla scheda del suo personaggio; una seconda pressione la disattiva.

Prima di iniziare

Il master può concedere l’ispirazione a qualsiasi giocatore. Un giocatore può farlo solo per un personaggio di cui è proprietario: negli altri casi Foundry rifiuta la modifica. Il mondo usa il sistema D&D5e.

In Foundry

Se non è già stato fatto, assegni il personaggio al giocatore nella configurazione dell’utente di Foundry: il tasto agisce su quel personaggio assegnato. Non serve alcuna altra impostazione del modulo.

Su Stream Deck

Dare l’ispirazione
Tasto Comando Impostazioni
Ispirazione Update a document « Document » su « Player’s assigned character », poi « Foundry user »: il giocatore interessato. « Add change »: « Field path » system.attributes.inspiration, « Operation » su « Toggle true/false ».

Provare e tornare allo stato iniziale

Apra la scheda del personaggio in Foundry, poi prema « Ispirazione »: la scheda mostra che il personaggio ha l’ispirazione. Prema di nuovo: l’ispirazione viene rimossa e la scheda torna allo stato iniziale. A ogni pressione il tasto inverte lo stato attuale: se il personaggio aveva già l’ispirazione, la prima pressione la rimuove.

Da sapere

Il percorso system.attributes.inspiration è specifico di D&D5e: gli altri sistemi di gioco usano altri campi e il modulo non verifica il percorso inserito. Se il campo non esiste, il tasto mostra un avviso e l’inspector segnala che un campo non ha il tipo previsto.

Rivelare gli indizi in modo definitivo

In « Rivelare gli indizi nell’ordine » il tasto mostra una pagina che i giocatori hanno già il permesso di aprire. Qui ogni pagina di indizio resta nascosta nel loro diario finché Lei non la rivela: un tasto rivela l’indizio attuale, un altro passa all’indizio successivo e lo rivela, senza macro.

Prima di iniziare

Acceda come master: Foundry rifiuta che un giocatore cambi il permesso di una pagina. Le servono l’elenco « Indizi della cripta » e la variabile « Indizio attuale » dell’esempio « Rivelare gli indizi nell’ordine »: li crei prima seguendo i suoi passaggi « In Foundry ».

In Foundry

  1. Dia ai giocatori il permesso Osservatore sul diario che contiene le pagine degli indizi: senza questo permesso, quel diario non compare nella scheda Diario dei giocatori.
  2. Apra la configurazione dei permessi di ogni pagina di indizio e imposti esplicitamente il permesso dei giocatori su Nessuno: una pagina creata di recente eredita il permesso del diario e sarebbe quindi visibile per loro. Questa impostazione sostituisce il permesso Osservatore richiesto dall’esempio « Rivelare gli indizi nell’ordine ».

Su Stream Deck

Rivelare gli indizi in modo definitivo
Tasto Comando Impostazioni
Rivelare l’indizio attuale Update a document « Document »: « Value source » su « Variable (advanced) », poi la variabile Indizio attuale. « Add change »: « Field path » ownership.default, « Operation » su « Set a value », « Value type » su « Number », poi « Value » 2, che corrisponde al livello Osservatore.
Rivelare l’indizio successivo Change variables and run command « Add variable change »: « Operation » su « Next list entry » (il valore proposto è « Toggle variable »), « Variable (advanced) » su Indizio attuale. « Foundry command »: « Update a document », con le stesse impostazioni di « Rivelare l’indizio attuale ».
Nascondere l’indizio Update a document Facoltativo. Le stesse impostazioni di « Rivelare l’indizio attuale », ma con il valore 0, che corrisponde a Nessuno: il tasto nasconde l’indizio attuale. Il valore -1 renderebbe la pagina visibile, perché erediterebbe il permesso Osservatore del diario.

Provare e tornare allo stato iniziale

Prema « Rivelare l’indizio attuale »: il primo indizio compare nel diario dei giocatori, le altre pagine restano nascoste. Prema poi « Rivelare l’indizio successivo »: a ogni pressione l’indizio attuale passa alla pagina successiva, che viene rivelata. Iniziare dal tasto combinato farebbe saltare il primo indizio. Il diario dei giocatori e le finestre di diario che hanno aperto si aggiornano subito, senza ricaricare, e le pagine rivelate restano nel loro diario. Per rigiocare l’indagine, rimetta ogni pagina di indizio su Nessuno in Foundry, poi applichi « Reset variable » a Indizio attuale.

Da sapere

Sull’ultimo indizio il tasto combinato non cambia nulla. « Reset variable » riporta l’indizio attuale al primo, ma non nasconde le pagine già rivelate. Se un giocatore preme questi tasti, Foundry rifiuta la modifica. Un comando combinato esegue un solo comando Foundry: rivelare una pagina e mostrarla ai giocatori con « Share journal page » richiede due tasti. Una pagina nascosta lo è solo nell’interfaccia dei giocatori: il suo contenuto è già nel loro browser, quindi non è un segreto.

Mostrare la tensione ai giocatori

In « Annunciare il livello di tensione » il livello viene annunciato nella chat. Qui lo mostra nel nome di un diario che i giocatori vedono nel loro elenco di diari: un tasto fa salire la tensione e rinomina il diario, per esempio « Tensione: 3 / 6 ». Decide Lei quando premere.

Prima di iniziare

Acceda come master: Foundry rifiuta che un giocatore rinomini un diario di cui non è proprietario. Le serve la variabile « Tensione » dell’esempio « Annunciare il livello di tensione »: la crei prima con il suo passaggio « In Foundry ».

In Foundry

Crei un diario chiamato « Tensione » e dia ai giocatori il permesso Osservatore su quel diario: senza questo permesso, non compare nella scheda Diario dei giocatori.

Su Stream Deck

Mostrare la tensione ai giocatori
Tasto Comando Impostazioni
Aumentare e mostrare Change variables and run command Una modifica « Increase variable » su Tensione, « Adjustment » 1. « Foundry command »: « Update a document ». « Document »: il diario « Tensione », scelto dall’elenco. « Add change »: « Field path » name, « Operation » su « Set a value », « Value type » su « Compose text (advanced) », poi tre parti in ordine: il testo « Tensione: » seguito da uno spazio, la variabile Tensione e il testo « / 6 » preceduto da uno spazio.

Provare e tornare allo stato iniziale

Con il contatore a 2, prema « Aumentare e mostrare »: il contatore passa a 3 e il diario viene rinominato « Tensione: 3 / 6 »; il nuovo nome compare subito nella scheda Diario di ogni giocatore, senza ricaricare. Per tornare allo stato iniziale, azzeri il contatore con il tasto « Azzerare » dell’esempio « Annunciare il livello di tensione », poi rinomini il diario in « Tensione » in Foundry.

Da sapere

Al massimo il contatore resta a 6 e il nome del diario non cambia. Il tasto rinomina il diario stesso, non una delle sue pagine: l’elenco dei diari mostra i nomi dei diari, mentre il nome di una pagina compare solo nel diario aperto.

Creare variabili ed elenchi in Foundry

Dopo una riconnessione

Quando il browser Foundry si riconnette, compare come una nuova sessione. La selezioni di nuovo sui tasti interessati, anche dopo il riavvio della connessione locale. Se si riconnette solo il plugin, può ritrovare una sessione Foundry rimasta connessa. Se preme Ctrl+C nel terminale, la connessione locale si arresta e le sessioni in corso vengono interrotte.

Risoluzione dei problemi

  • Nessuna connessione: verifichi che la finestra del terminale sia ancora aperta, che gli indirizzi inseriti corrispondano a quelli indicati in questa guida e che Foundry e il plugin usino la stessa chiave.
  • Foundry assente o rifiutato: verifichi l’origine esatta consentita in companion.json e l’interruttore del riquadro Stream Deck nel browser. Un diverso indirizzo del server cambia l’origine.
  • Foundry in HTTPS: il browser può richiedere wss e un certificato locale attendibile. Configuri tlsCert e tlsKey con percorsi assoluti a file PEM, poi usi wss in Foundry e nel plugin. Il certificato deve coprire l’indirizzo locale ed essere attendibile per il browser Foundry e per Stream Deck. Non viene installato automaticamente.
  • Sessione assente o in sincronizzazione: attenda che sia pronta e selezioni di nuovo mondo, utente e browser sul tasto.
  • Comando rifiutato o documento assente: verifichi i permessi dell’account Foundry e il documento scelto. La selezione della sessione non concede diritti aggiuntivi.
  • Test dell’overlay non disponibile: verifichi collegamento dell’account JDR Ninja, attivazione dell’overlay e verifica Premium in Foundry. La chiave locale non conferma questo accesso.
  • Risultato incerto o parziale: controlli scheda, scena, variabili o combattimento interessati in Foundry prima di premere di nuovo. Un’interruzione può avvenire dopo l’esecuzione. Il plugin non ripete automaticamente il comando.

Domande frequenti

Perché la chiave scompare dal campo?

Il plugin svuota il campo dopo il salvataggio per non mostrare la chiave memorizzata. Non significa che la connessione sia stata rimossa.

Perché devo selezionare di nuovo la sessione?

Una riconnessione Foundry crea una nuova identità. I tasti conservano la scelta precedente per evitare comandi destinati ad altri mondi, utenti o browser.

Posso ripetere un comando con risultato incerto?

Controlli prima Foundry. Il comando potrebbe essere già stato eseguito nonostante l’interruzione della connessione. Ogni nuova pressione è un nuovo comando.

Un tasto può mostrare il valore di una variabile?

No. I tasti mostrano lo stato di pausa, il livello di oscurità, la barra di un token o, per un istante, il risultato di un comando. Il valore di una variabile o il PNG scelto si consultano in Foundry o nell’inspector.

Stream Deck per Foundry VTT Il modulo JDR Ninja per Foundry