Designazione della compatibilità per il suo foglio
Per designare la compatibilità con un compendio, basta includere il nome breve del compendio nel campo "compendium" del suo filesheet.json.
Se sta utilizzando un foglio personalizzato, c'è un'impostazione nella pagina Impostazioni di gioco che le permetterà di selezionare manualmente un Compendio da utilizzare per la sua partita.
Abilitazione della funzionalità di trascinamento per il suo foglio
Oltre alla compatibilità di base, ha la possibilità di indicare a Roll20 come le informazioni del Compendio possono essere incluse direttamente nel suo foglio. Questo permette ai giocatori di trascinare una voce dal compendio direttamente nel suo foglio, e Roll20 inserirà i valori da lei specificati. Per farlo, deve aggiungere la classecompendium-drop-targetal tagdivche circonda la sezione che desidera riempire. Per le sezioni ripetute, lo collochi all'interno del tagfieldset. Quindi, aggiunga l'attributoaccept="Nome dell'attributo"a uno o più taginput, select, textarea. Ecco un semplice esempio che sarebbe compatibile con la voceFireballdel Compendio della SRD della 5ª Edizione.
<fieldset class="repeating_spells"> <div class="compendium-drop-target"> <tipo di input="text" name="attr_SpellName" accept="Name" /> <tipo di input="text" name="attr_SpellDamage" accept="Damage" /> <select name="attr_SpellSchool" accettare="Scuola"> <valore di opzione="Abiurazione">Abiurazione</opzione> <valore di opzione="Congiurazione">Congiurazione</opzione> <valore di opzione="Divinazione">Divinazione</opzione> <valore opzione="Incanto">Incanto</opzione> <valore opzione="Evocazione">Evocazione</opzione> <valore opzione="Illusione">Illusione</opzione> <valore opzione="Negromanzia">Negromanzia</opzione> <valore dell'opzione="Trasmutazione">Trasmutazione</opzione> </select> <tipo di input="checkbox" nome="attr_SpellRitual" valore="Sì" accettare="Rituale"> </div> </fieldset>
<Attribute Name>inaccept="<Attribute Name>"deve corrispondere al nome di un Attributo della sezione inferiore della voce del Compendio. Consulti ogni singolo Compendio per un elenco degli Attributi disponibili.- Per i tag
inputetextarea, il valore del Compendio verrà inserito direttamente. - Per i tag
input[type=checkbox]einput[type=radio], la casella sarà selezionata/radio selezionata se il valore del compendio corrisponde esattamente all'attributo value del tag. - Per i tag
selezionare, verrà selezionata l'opzioneche corrisponde al valore Compendium nell'attributo value O nel testo all'interno del tag option. - Può utilizzare
accept="Content"se desidera ricevere il contenuto in chiaro della voce (il contenuto situato sopra l'intestazione "Attributes"). - Può utilizzare
accept="data"se desidera ricevere tutti gli attributi da una pagina di compendio in formato json.
Si noti che il processo di modifica di questi valori attiverà eventi Sheet Worker locali e API remote esattamente come se l'utente stesso avesse inserito i dati a mano. Quindi può anche creare degli input nascosti per accettare i dati dal Compendio e poi elaborare ulteriormente questi dati utilizzando Sheet Workers, se desidera un maggiore controllo su come vengono presentati i dati.
Pulsanti del compendio
Il pulsante del compendio può essere utilizzato per aprire una voce del compendio direttamente dalla scheda del personaggio, come se cliccasse su una voce del compendio in-app. Questo può essere utilizzato come un modo più comodo per accedere alle regole e alle descrizioni, ad esempio, per un incantesimo, il pulsante compendio può essere utilizzato per visualizzare facilmente la descrizione completa di quell'incantesimo.
La sintassi è<button type="compendium" value="<entryname>">. Ecco alcuni esempi validi:
<tipo di pulsante="compendio" valore="Bard"></bottone>
Si tratta di una sintassi valida, ma poiché esistono sia una Classe che un Mostro intitolati "Bardo", la finestra risultante le presenterà una scelta di voci invece di andare direttamente ad una di esse.
<tipo di pulsante="compendio" valore="Classi:Bard"></bottone>
Questa è la sintassi preferita. Specificando la categoria, si assicura che ci sarà una sola corrispondenza.
<tipo di pulsante="compendio" valore="Classi:Bardo#Incantesimi"></bottone>
Aggiungendo un "#" seguito dal titolo di una sottovoce, la finestra si aprirà direttamente a quella sezione. Questo esempio aprirà la voce relativa alla classe del Bardo, con una scrollata alla sezione Incantesimi. Se non viene trovata alcuna sezione con quel nome, la finestra si aprirà scorrendo verso l'alto.
Il trascinamento di una voce dal compendio contiene un attributo specifico per questo pulsante,uniqueName, una stringa contenente sia la categoria che il nome della voce, che garantisce una sola corrispondenza nel compendio. Quindi, la sintassi di questo pulsante in una sezione di caduta del compendio è la seguente:
<tipo di pulsante="compendium" nome="attr_infoButton" accettare="uniqueName"></button>
Può anche aggiungere una sottosezione a questo attributo tramite sheetworker, per cui se l'oggetto caduto dal compendio era un mostro e desidera che il pulsante si apra direttamente alla sezione "Azioni", può impostare il valore del pulsante suuniqueName + "#Azioni".