Comandi Foundry
Cambiare luogo con tre tasti
Attivi la scena successiva, avvii la relativa atmosfera sonora e ne regoli l’oscurità, ogni comando sul proprio tasto.
Il modulo JDR Ninja per Foundry
Controlli le schede personaggio dal Suo Stream Deck.
Attivi una scena, mostri un indizio, effettui un tiro o modifichi direttamente la scheda di un personaggio da Stream Deck. Il plugin JDR Ninja invia i comandi a Foundry VTT, e le variabili Le permettono di riutilizzare gli stessi tasti per tutta la partita.
Un tasto può cambiare qualsiasi campo che Foundry Le permette di modificare: l’ispirazione di un personaggio, i suoi punti ferita, la sua valuta, le cariche di un oggetto, il nome di una pagina di diario. Fino a 16 campi cambiano in un solo aggiornamento.
Con le variabili, un tasto può anche:
Ogni esempio indica ciò che utilizza e rimanda alla sua configurazione passo dopo passo nella guida.
Comandi Foundry
Attivi la scena successiva, avvii la relativa atmosfera sonora e ne regoli l’oscurità, ogni comando sul proprio tasto.
Variabili: elenco e comando combinato
Un elenco di pagine e un comando combinato: passi all’indizio successivo e lo mostri ai Suoi giocatori connessi, senza macro.
Variabili: contatore e testo composto
Un contatore da 0 a 6 salvato in una variabile: lo faccia salire e annunci il nuovo valore nella chat.
Aggiornamento di documenti
Attivi o rimuova l’ispirazione sulla scheda del personaggio di un giocatore, senza aprirla.
Il plugin offre 40 comandi: 31 per Foundry VTT, compreso l’aggiornamento dei documenti, e 9 per le variabili. Ogni comando rispetta i permessi dell’utente Foundry connesso, e i comandi contrassegnati con GM sono riservati al master.
Un elenco di PNG o di indizi, un contatore, un bonus: con le variabili e gli elenchi creati in Foundry, bastano pochi tasti per tutta la partita. Un comando combinato modifica un valore e poi avvia un’azione, per esempio passare all’indizio successivo e mostrarlo. Valori e permessi vengono verificati a ogni pressione.
Le variabili vengono salvate nelle impostazioni di Foundry, non nel browser.
game.settings
flags.jdr-ninja.arguments
Document#update()
Ogni comando richiama una funzione di Foundry VTT, indicata sotto il suo nome: è Foundry ad agire, con le proprie regole e i permessi del Suo utente.
Open actor
Actor#sheet.render()
Execute macro
Macro#execute()
View scene
Scene#view()
Activate scene GM
Scene#activate()
Preload scene GM
game.scenes.preload()
Set darkness GM
Scene#update({ darknessLevel })
Open journal page
JournalEntry#sheet.render()
Share journal page GM
Journal.show()
Play or stop sound GM
Playlist#playSound() / stopSound()
Next or previous track GM
Playlist#playNext()
Stop playlist GM
Playlist#stopAll()
Set volume GM
PlaylistSound#update({ volume })
Pause or resume GM
game.togglePause()
Open sidebar tab
ui.sidebar.changeTab()
Select tool
ui.controls.activate()
Roll dice
Roll#toMessage()
Draw from table
RollTable#draw()
Send chat message
ChatMessage.create()
Select token
Token#control()
Target token
Token#setTarget()
Hide or reveal token GM
TokenDocument#update({ hidden })
Adjust token resource
Actor#modifyTokenAttribute()
Apply or remove condition
Actor#toggleStatusEffect()
Start combat GM
Combat#startCombat()
End combat GM
DialogV2.confirm() + Combat#delete()
Next turn GM
Combat#nextTurn()
Previous turn GM
Combat#previousTurn()
Next round GM
Combat#nextRound()
Roll initiative GM
Combat#rollAll()
Test overlay
Server JDR Ninja, accesso Premium
« Adjust token resource » modifica solo la barra del token: non gestisce danni o cure secondo le regole di ciascun sistema. « End combat » chiede una conferma in Foundry.
Le immagini mostrano le impostazioni del modulo in un vero browser Foundry e l’inspector di sviluppo del plugin. Illustrano la configurazione locale e non certificano hardware Stream Deck. La porta temporanea nelle immagini è diversa dalla porta predefinita 19114 della guida.
Nella finestra « Stream Deck » del modulo inserisca l’indirizzo di connessione e la chiave di abbinamento, poi faccia clic su « Salvare e attivare ».
Il comando e i campi dipendono dalla sessione scelta e dai permessi dell’utente Foundry.
Il plugin Stream Deck invia i comandi al modulo JDR Ninja tramite una connessione locale, nel browser Foundry scelto. Foundry esegue i comandi e verifica i permessi dell’utente connesso. Questo browser deve restare aperto sullo stesso computer di Stream Deck, ma il server Foundry può essere ospitato altrove. La connessione locale usa una propria chiave di abbinamento: non richiede un token dell’account JDR Ninja e non sostituisce alcun permesso di Foundry.
Ogni tasto resta legato al mondo, all’utente e al browser che ha scelto. Il plugin distingue un comando completato da uno rifiutato o con un risultato incerto. Se il risultato è incerto, verifichi Foundry prima di premere di nuovo.
Servono Foundry V14 o successivo con il modulo JDR Ninja attivo, l’applicazione Stream Deck con il plugin JDR Ninja e Node.js 24 per la connessione locale. Ogni tasto richiede una sessione selezionata esplicitamente.
I comandi rispettano i permessi Foundry della sessione scelta. Il test dell’overlay è indicato come Premium e richiede collegamento dell’account, attivazione dell’overlay e verifica dell’accesso sul server. Le altre funzioni hanno condizioni proprie. Non è stato annunciato un livello generale di abbonamento per i comandi locali.
Conservano un valore in Foundry: il PNG scelto, l’indizio corrente, un contatore o un bonus. Un tasto usa il valore del momento, e il comando « Change variables and run command » lo modifica e poi agisce in Foundry.
Sì. Il browser che apre la partita deve comunque funzionare sullo stesso computer di Stream Deck.
No. Funzionano solo se un browser Foundry è aperto, connesso alla partita e pronto a ricevere i comandi. Se chiude quel browser, la sessione si interrompe.
Selezioni nuovamente la sessione sui tasti. Ogni nuova connessione Foundry riceve una nuova identità. La riconnessione del solo plugin può ritrovare una sessione Foundry ancora connessa.
Le azioni disponibili dipendono dai permessi dell’utente Foundry connesso. Un tasto non concede diritti aggiuntivi e non cambia automaticamente utente.
Il test dell’overlay richiede accesso Premium verificato in Foundry. Non è stato annunciato un abbonamento generale per i comandi locali. Generatori e altre funzioni hanno condizioni proprie.
I test di sviluppo usano un vero browser Foundry e un host Elgato simulato. Restano da verificare hardware Stream Deck, installazione Windows/macOS e wss con certificato attendibile. Non viene annunciata compatibilità hardware generale.
Sì, se Foundry Le permette di modificare quel documento: il master può modificare tutto, un giocatore solo ciò che gli appartiene. Il percorso del campo dipende dal sistema di gioco e il modulo non lo verifica. Foundry ignora un campo inesistente, e un aumento o un’inversione su quel campo viene segnalato sul tasto.
Segua la guida per collegare i tre componenti e provare un comando semplice.