Vai al contenuto principale

Il modulo JDR Ninja per Foundry

Controllare Foundry VTT con Stream Deck

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.

Modificare le Sue schede

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.

  • Cinque operazioni: impostare un valore, aumentare, diminuire, invertire vero/falso, rimuovere un campo.
  • Il bersaglio a Sua scelta: un documento preciso, il personaggio assegnato a un giocatore, il token selezionato o il suo attore, oppure un documento indicato da una variabile.
  • Valori fissi o presi dalle Sue variabili: un bonus, un contatore, un testo composto.
  • Si applicano i Suoi permessi di Foundry: il master può modificare tutto, un giocatore solo ciò che gli appartiene.
  • I campi dipendono dal sistema di gioco: Lei indica il loro percorso, per esempio system.attributes.inspiration in D&D5e. Il modulo non verifica questo percorso.

Esempi per la Sua prossima partita

Ogni esempio indica ciò che utilizza e rimanda alla sua configurazione passo dopo passo nella guida.

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.

Vedere l’esempio passo dopo passo

Variabili: elenco e comando combinato

Rivelare gli indizi nell’ordine

Un elenco di pagine e un comando combinato: passi all’indizio successivo e lo mostri ai Suoi giocatori connessi, senza macro.

Vedere l’esempio passo dopo passo

Variabili: contatore e testo composto

Annunciare il livello di tensione

Un contatore da 0 a 6 salvato in una variabile: lo faccia salire e annunci il nuovo valore nella chat.

Vedere l’esempio passo dopo passo

I comandi

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.

Variabili ed elenchi

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.

Set variable
Assegna un nuovo valore alla variabile.
Select list entry
Sceglie una voce precisa dell’elenco associato.
Next list entry
Avanza di una voce nell’elenco e può tornare all’inizio dopo l’ultima.
Previous list entry
Torna indietro di una voce nell’elenco.
Increase variable
Aggiunge una quantità al numero, entro i limiti stabiliti.
Decrease variable
Sottrae una quantità dal numero, entro i limiti stabiliti.
Toggle variable
Sostituisce sì con no, o no con sì.
Reset variable
Ripristina il valore predefinito della variabile.
Change variables and run command
Applica fino a 16 modifiche, poi esegue un comando Foundry.
  • Tre modi per definire una variabile: un valore salvato, una selezione da un elenco o un valore calcolato. Un calcolo può usare altre variabili e i campi di un documento, come l’ispirazione di un personaggio.
  • Tredici tipi di valore: numero, testo, sì o no, attore, token, scena, diario, pagina di diario, macro, playlist, traccia audio, tabella casuale e combattimento.
  • Variabili personali per i Suoi tasti, oppure comuni a tutto il tavolo e gestite dal master.
  • In ogni campo di un comando il valore può provenire da una variabile, da un testo composto da parti fisse e variabili, dal personaggio assegnato a un giocatore o dal token selezionato.
  • Argomenti per le Sue macro di script: fino a 16 valori dichiarati per macro, impostati in modo diverso su ogni tasto.

Le variabili vengono salvate nelle impostazioni di Foundry, non nel browser.

game.settings flags.jdr-ninja.arguments

Vedere gli esempi

I comandi di Foundry VTT

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.

Attori e macro

  • Open actor

    Actor#sheet.render()
  • Execute macro

    Macro#execute()

Scene

  • View scene

    Scene#view()
  • Activate scene GM

    Scene#activate()
  • Preload scene GM

    game.scenes.preload()
  • Set darkness GM

    Scene#update({ darknessLevel })

Diari

  • Open journal page

    JournalEntry#sheet.render()
  • Share journal page GM

    Journal.show()

Musica e suoni

  • 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 })

Partita e interfaccia

  • Pause or resume GM

    game.togglePause()
  • Open sidebar tab

    ui.sidebar.changeTab()
  • Select tool

    ui.controls.activate()

Dadi, tabelle e chat

  • Roll dice

    Roll#toMessage()
  • Draw from table

    RollTable#draw()
  • Send chat message

    ChatMessage.create()

Token e condizioni

  • 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()

Combattimento

  • 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()

Overlay

  • 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.

Come si presenta

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.

Attivare la connessione in Foundry

Nella finestra « Stream Deck » del modulo inserisca l’indirizzo di connessione e la chiave di abbinamento, poi faccia clic su « Salvare e attivare ».

Impostazioni Stream Deck del modulo JDR Ninja in Foundry: connessione locale attiva, interfaccia francese.

Configurare un tasto

Il comando e i campi dipendono dalla sessione scelta e dai permessi dell’utente Foundry.

Inspector di sviluppo JDR Ninja: comando Foundry e campi di configurazione, interfaccia francese.

Come comunica Stream Deck con Foundry

  1. Plugin Stream Deck
  2. Modulo JDR Ninja nel browser 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.

Requisiti

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.

Installare il modulo Foundry

Permessi e condizioni di accesso

Common.Free

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.

Domande frequenti

A cosa servono le variabili?

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.

Il server Foundry può essere remoto?

Sì. Il browser che apre la partita deve comunque funzionare sullo stesso computer di Stream Deck.

I tasti funzionano dopo aver chiuso Foundry?

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.

Cosa fare dopo una riconnessione di Foundry?

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.

Un giocatore può usare questi comandi?

Le azioni disponibili dipendono dai permessi dell’utente Foundry connesso. Un tasto non concede diritti aggiuntivi e non cambia automaticamente utente.

Serve un abbonamento JDR Ninja?

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.

Quali dispositivi e piattaforme sono stati verificati?

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.

Posso modificare qualsiasi campo di una scheda?

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.

Preparare il primo comando

Segua la guida per collegare i tre componenti e provare un comando semplice.

Il modulo JDR Ninja per Foundry