Macro, scene e pausa
Esegua una macro autorizzata, visualizzi o attivi una scena, regoli l’oscurità e metta in pausa la partita.
Il modulo JDR Ninja per Foundry
Controllare Foundry VTT con Stream Deck
Esegua macro, cambi scena e controlli la musica da Stream Deck. Il plugin JDR Ninja invia i comandi a Foundry VTT attraverso un programma companion sul Suo computer.
In breve
Tre componenti collegano i tasti al browser Foundry selezionato: il plugin Stream Deck, il companion locale e il modulo JDR Ninja. Foundry esegue i comandi e verifica i permessi dell’utente connesso. Il browser deve restare aperto sullo stesso computer del companion.
Comandi a portata di mano
Associ un tasto a una macro, scena o suono già presente nel Suo mondo.
Scegliere la sessione giusta
Ogni tasto conserva il mondo, l’utente e il browser selezionati esplicitamente.
Verificare il risultato
Il plugin distingue i comandi completati da quelli rifiutati e dai risultati incerti.
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
Nelle impostazioni del modulo salvi l’indirizzo del companion e la chiave locale, poi attivi esplicitamente Stream Deck in questo browser Foundry.
Configurare un tasto
Il comando e i campi dipendono dalla sessione scelta e dai permessi dell’utente Foundry.
Come si collegano i componenti
- Plugin Stream Deck
- Companion locale
- Modulo JDR Ninja nel browser Foundry
Il companion trasmette i comandi tra i due client sul Suo computer. Il server Foundry può essere ospitato altrove. La chiave locale non richiede un token dell’account JDR Ninja e non concede permessi aggiuntivi in Foundry.
Comandi della versione attuale
Musica e documenti
Riproduca o interrompa un suono, cambi traccia e regoli il volume. Apra una scheda attore o una pagina di diario, la condivida con i destinatari scelti ed estragga un risultato da una tabella.
Token e combattimento
Selezioni, bersagli o nasconda token, modifichi le barre native e avanzi i turni secondo i Suoi permessi. Le barre non applicano regole di danno o cura specifiche del sistema.
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 il companion. Browser Foundry e companion devono restare aperti sul computer di Stream Deck. Ogni tasto richiede una sessione selezionata esplicitamente.
Variabili, liste e argomenti delle macro
I comandi ordinari usano valori fissi. Le opzioni avanzate consentono di scegliere variabili compatibili, scorrere liste e fornire argomenti alle macro che li dichiarano in Foundry. Valori e permessi vengono verificati a ogni pressione.
Permessi e condizioni di accesso
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 serve il companion?
Trasmette i comandi tra il plugin Stream Deck e i browser Foundry autorizzati sul Suo computer. Foundry esegue le azioni e verifica i permessi.
Il server Foundry può essere remoto?
Sì. Il browser che apre la partita deve comunque funzionare sullo stesso computer del companion e di Stream Deck.
I tasti funzionano dopo aver chiuso Foundry?
I comandi richiedono un browser Foundry aperto, connesso al companion e pronto. Chiudendo quel browser si termina la sessione.
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.
Preparare il primo tasto
Segua la guida per collegare i tre componenti e provare un comando semplice.