Vai al contenuto principale

Modulo Foundry VTT

Installare e configurare il modulo JDR Ninja in Foundry VTT

Preparate l’installazione, collegate l’account JDR Ninja e attivate le funzioni utili per la partita. La sincronizzazione con Atlas richiede anche un collegamento al mondo interessato.

Prima di iniziare

Controllate le versioni di Foundry e del sistema di gioco nelle impostazioni del mondo. Il modulo richiede almeno Foundry 14; i generatori di D&D sono destinati esattamente a Foundry V14 e D&D5e 5.3.3. Atlas supporta i sistemi elencati nella pagina del modulo.

Accedete come master per i generatori, la sincronizzazione con Atlas e i comandi Twitch per le tabelle. I giocatori possono configurare l’invio dei propri tiri pubblici. Le altre funzioni non richiedono Stream Deck.

Modulo Foundry VTT

Installare e attivare il modulo

Il modulo JDR Ninja è pubblicato su Foundry VTT. Nella schermata di configurazione di Foundry, aprite la scheda dei moduli, fate clic sul pulsante di installazione e cercate « JDR Ninja ». Se il modulo non compare nella ricerca, incollate l’indirizzo del suo manifesto nella finestra di installazione:

https://github.com/JDR-Ninja/fvtt-jdr-ninja/releases/latest/download/module.json

Il modulo richiede Foundry VTT versione 14 o successiva e nessun altro modulo. Aprite poi il vostro mondo e attivate JDR Ninja nella gestione dei moduli.

Nelle impostazioni di Foundry, la sezione JDR Ninja propone il pulsante « Configurare le connessioni ». Apre la finestra « Connessioni JDR Ninja »: il vostro account JDR Ninja in alto, poi un riquadro per ogni funzione, Stream Deck e VTT Overlay, oltre a Generatori D&D e Sincronizzazione Atlas per il master.

Collegare il vostro account JDR Ninja

  1. Nella finestra « Connessioni JDR Ninja », fate clic su « Collegare il mio account », poi su « Aprire JDR Ninja », e accedete al sito, se necessario. Se i generatori di D&D sono già attivati in questo browser, il loro accesso viene richiesto nella stessa autorizzazione.
  2. Controllate il codice e il nome del dispositivo. Se volete usare i generatori di D&D, autorizzate esplicitamente questa funzione prima di approvare il collegamento.
  3. Tornate in Foundry e attendete la conferma dell’account. L’accesso viene verificato separatamente per ogni funzione. Se la richiesta è scaduta o è stata rifiutata, avviate un nuovo collegamento.

Potete anche generare un token manuale nella pagina dei dispositivi Foundry, inserirlo in « Opzioni avanzate » e fare clic su « Verificare e salvare ». Viene mostrato una sola volta. Se il riquadro « Generatori D&D » indica « Autorizzazione necessaria », fate clic su « Autorizzare su JDR Ninja » per aggiungerne l’accesso.

Gestire i miei dispositivi Foundry
Finestra dei collegamenti del modulo JDR Ninja in Foundry VTT
Anteprima del modulo locale: collegamento dell’account e impostazioni di overlay e Stream Deck in Foundry.

Attivare le funzioni scelte

Il collegamento dell’account non attiva alcuna funzione. Nella finestra « Connessioni JDR Ninja » ogni riquadro ha il proprio interruttore « Attivare », inizialmente disattivato. Quelli di Stream Deck, dell’overlay e dei generatori valgono solo per questo browser; quello della sincronizzazione Atlas vale per tutti i master del mondo.

  • Generatori di D&D (master): il riquadro indica prima se il vostro mondo è compatibile, poi l’accesso previsto dal vostro abbonamento. Una volta attivati e disponibili i generatori, aprite « Mostri D&D » o « PNG D&D » dall’elenco degli attori o dalle impostazioni JDR Ninja.
  • Overlay: preparate la sorgente OBS nella configurazione dell’overlay sul sito, poi attivate il riquadro « VTT Overlay ». Il suo pulsante « Configurare VTT Overlay » apre una finestra che verifica l’overlay all’apertura e propone « Inviare un tiro di prova »; questo test richiede lo stesso abbonamento dei tiri.
  • Stream Deck: installate prima il plugin e avviate il collegamento locale. In Foundry, il pulsante « Configurare Stream Deck » del suo riquadro apre la finestra in cui inserire l’indirizzo e la chiave di abbinamento; « Salvare e attivare » conclude la configurazione. La guida dedicata spiega la chiave e la scelta della sessione.

Collegare il vostro mondo Atlas

  1. Sul sito, aprite i collegamenti Foundry e create un collegamento di sincronizzazione per il mondo Atlas interessato. Copiate il token mostrato una sola volta. Potete creare il collegamento anche dalle impostazioni di quel mondo.
  2. In Foundry, inserite il token nel riquadro « Sincronizzazione Atlas » della finestra « Connessioni JDR Ninja », poi cliccate su « Verificare e salvare ». Controllate il nome del mondo e l’accesso alla sincronizzazione. Questo token è distinto dal collegamento dell’account e dalla chiave Stream Deck.
  3. Attivate il riquadro « Sincronizzazione Atlas » per questo mondo Foundry, aprite la sua finestra con il pulsante « Atlas » dell’elenco degli attori e scegliete la campagna. Collegate un attore a un personaggio esistente o createlo in Atlas, poi avviate la sincronizzazione. Controllate la scheda in Atlas.
Gestire le mie connessioni Atlas

Preparare valori ed elenchi

Il modulo può salvare valori da riutilizzare: un contatore, un bonus, un attore o una pagina scelti. Aprite « Variabili ed elenchi (avanzato) » nelle impostazioni del modulo o « Variabili ed elenchi » nella finestra « Stream Deck » del modulo. La scheda « Variabili » contiene i valori; la scheda « Elenchi di valori » contiene documenti disposti nell’ordine che preferite, per esempio i vostri PNG o i vostri indizi. Queste impostazioni non richiedono né Stream Deck né un abbonamento.

Scegliete « Personale » per i vostri valori: ogni utente modifica i propri. Un valore « Mondo » è condiviso da tutti gli utenti del mondo, ma solo il master indicato in « GM responsabile delle variabili del mondo » può modificarlo.

Una variabile ha un « Valore predefinito » e un « Valore attuale ». L’elenco delle variabili mostra il valore attuale di ciascuna, e « Modificare il valore attuale » permette di cambiarlo a mano o di ripristinare il valore predefinito. Una « Selezione da un elenco » parte senza valore attuale: dopo averla salvata, applicate « Ripristinare il valore predefinito ». Un « Valore calcolato » si ricava da altre variabili e non si modifica direttamente.

Nel campo « Espressione di calcolo », scrivete una variabile nella forma @{Nome}. Dopo una variabile di documento, aggiungete il percorso di un dato come in un effetto attivo: se « Eroe in primo piano » corrisponde a un personaggio, @{Eroe in primo piano}.system.attributes.inspiration indica se ha l’ispirazione. Il percorso dipende dal sistema di gioco, e il dato viene letto solo se potete vedere il documento.

Per passare dei valori a una macro script, dichiarate i suoi argomenti in « Macro compatibili (avanzato) ». Questa finestra non modifica lo script: la macro deve leggere questi argomenti e confermare la fine della propria esecuzione.

Vedere gli esempi Stream Deck

Verificare il primo utilizzo

Dopo aver attivato una funzione, fate un primo test completo prima della partita.

Creare una prima creatura

Aprite Mostri dalle impostazioni JDR Ninja o dall’elenco degli attori, scegliete un profilo semplice e avviate una generazione. Esaminate l’anteprima, create l’attore, poi aprite la sua scheda in Foundry per verificare il risultato. Ogni nuova generazione conta per i limiti del vostro account.

Aggiornare un personaggio in Atlas

Modificate in Foundry un personaggio collegato, poi inviate la sua scheda dalla finestra Atlas. Aprite la sua scheda in Atlas per verificare la modifica prima di inviare l’intero elenco. Le modifiche effettuate in Atlas non tornano in Foundry.

Vedere un tiro pubblico in OBS

Effettuate in Foundry un tiro pubblico con dadi e confrontate il risultato nella chat e nella sorgente OBS. I tiri privati, alla cieca e sussurrati non vengono mai trasmessi.

Provare un tasto Stream Deck

Iniziate con un tasto che apre una scheda, poi preparate i tasti di una scena: attivazione, atmosfera sonora e oscurità, ogni comando sul proprio tasto. La guida Stream Deck propone poi degli esempi per la partita.

Preparare i tasti di una scena

Se usate i moduli precedenti

Disattivate Atlas Character Sync o il precedente modulo VTT Overlay: finché è attivo, la relativa integrazione del modulo JDR Ninja non è disponibile. Quando un master apre il mondo, il modulo riprende il token, l’indirizzo e la campagna di Atlas Character Sync; attivate poi la sincronizzazione Atlas nella finestra « Connessioni JDR Ninja ». Del vecchio modulo overlay non viene ripreso nulla: collegate di nuovo il vostro account.

Una sincronizzazione Atlas riuscita può riprendere i collegamenti degli attori esistenti. La disconnessione locale cancella il token salvato nel modulo, ma non lo revoca sul sito. Usate le pagine di gestione per revocare un dispositivo o un collegamento.

In caso di problemi

Il collegamento è scaduto o è stato rifiutato

Riavviate il collegamento da Foundry e usate il nuovo codice. Controllate il dispositivo e l’account che state autorizzando. Una richiesta annullata o scaduta non può essere riutilizzata.

Il mio account è collegato, ma una funzione resta inaccessibile

Controllate il messaggio della funzione: autorizzazione del dispositivo, abbonamento, permessi del master, compatibilità e attivazione sono requisiti separati. Un token Atlas non dà accesso ai generatori di D&D. Se il token è stato revocato, collegate di nuovo il dispositivo.

I generatori rifiutano la mia versione di Foundry o D&D5e

Le versioni attuali sono Foundry V14 e D&D5e 5.3.3. La versione minima per caricare il modulo e i sistemi accettati da Atlas non cambiano questo requisito. Consultate la compatibilità nella finestra del generatore.

La sincronizzazione con Atlas non parte

Controllate il ruolo di master, l’interruttore Atlas del mondo, il sistema, il token del mondo corretto e l’accesso alla sincronizzazione. Disattivate il precedente modulo Atlas Character Sync se è ancora attivo. L’account collegato per l’overlay non sostituisce il collegamento Atlas.

I dadi non compaiono in OBS

Controllate l’interruttore del riquadro « VTT Overlay » in questo browser, l’overlay attivo sul sito, la sorgente browser OBS e l’abbonamento. Effettuate un tiro pubblico con dadi. I tiri privati non vengono mai trasmessi. Consultate la sezione « Diagnostica » della finestra « VTT Overlay » e disattivate il vecchio modulo overlay, se attivo.

Stream Deck non trova la sessione Foundry

Controllate che il collegamento locale sia avviato sullo stesso computer del browser Foundry e dell’app Stream Deck e che sia attivo in Foundry. Dopo una riconnessione di Foundry, selezionate di nuovo la sessione sui tasti interessati. La guida Stream Deck spiega la chiave di abbinamento e gli indirizzi consentiti.