I modelli di rotolo sono un aspetto speciale del sistemaFogli di Carattereche fornisce ulteriori opzioni di layout e di stile per la visualizzazione dei risultati dei rotoli.
Modelli di lancio incorporati
I seguenti modelli di lancio sono incorporati in Roll20 e possono essere utilizzati in qualsiasi gioco.
Predefinito
Per utilizzare il modello predefinito, utilizzare "&{template:default}".
| Proprietà | Valore atteso |
|---|---|
| nome | Il nome del lancio, mostrato nell'intestazione dell'elenco dei lanci |
Il modello predefinito è speciale, e elencherà qualsiasi argomento gli venga fornito in una tabella. Quindi, ad esempio, potresti fare quanto segue:
&{template:default} {{name=Test Attack}} {{attack=[[1d20]]}}
{{note= Questo è un contenuto di nota}} {{Tiro Salvezza= vs Volontà}}
Qui è un esempio abbastanza preciso del modello predefinito con le relative classi CSS dipendenti.
Creazione di un modello di tiro
Se è un autore di fogli, può includere tutti i modelli di rotolo che desidera nel suo foglio caratteri HTML e CSS. Ti faremo sapere come fare di seguito.
Se è abbonato aPro, può creare i suoi modelli di rotolo se utilizza l'opzione foglio del personaggio "Personalizzato" con il suo gioco. Segui le istruzioni di seguito.
Definizione del layout del modello di tiro
Il primo passo nella creazione di un modello di tiro è definire il layout, inclusi le proprietà che saranno disponibili per essere compilati dal giocatore. I modelli di tiro sono semplicemente HTML e hai accesso a tutto l'HTML disponibile in qualsiasi altra parte di una scheda personaggio (inclusi i tagdivetable). Ecco un esempio del layout di una tabella di tiro:
<rolltemplate class="sheet-rolltemplate-test">
<div class="sheet-template-container">
<div class="sheet-template-header">{{rollname}}</div>
{{#attack}}<div class="sheet-template-row">Attacco: {{attack}} {{attackadvantage}} contro CA</div>{{/attack}}
{{#damage}}
<div class="sheet-template-row"><span>Danno: </span>{{damage}}
<span>Critico: </span>{{dmgcrit}}</div>
<div class="sheet-template-row"><span>Tipo: </span>{{dmgtype}}</div>
{{/damage}}
{{#atteffect}}
<div class="sheet-template-row">
<span class="sheet-template-desc">Effetto: </span>{{atteffect}}
</div>
{{/atteffect}}
</rolltemplate>
Il suo modello deve avere un tagrolltemplatecon una classe di "sheet-rolltemplate-<template_name>" template_name" è lo stesso nome che verrà utilizzato nella parte &{template:<template_name>} del comando e non deve contenere spazi. Puoi inserire il roll template ovunque tu voglia nell'HTML del tuo Character Sheet, ma ti consigliamo di metterlo alla fine. Verrà automaticamente "rimosso" dal tuo modello in modo che non venga mostrato come parte del foglio nella vista del personaggio. Nota che non puoi nidificare rolltemplates l'uno dentro l'altro.
Dopo di ciò, spetta a te decidere come strutturare il tuo roll. Ti consigliamo un layout a tabella, ma dipende da te.
All'interno del template, hai accesso ai seguenti:
Proprietà
Puoi includere qualsiasi proprietà desideri usando le doppie parentesi graffe. Quindi{{myproperty}}produrrebbe qualsiasi cosa (roll inline, testo). ecc.) viene dato al template tramite{{myproperty=<value>}}in the roll. Per creare una nuova proprietà, basta aggiungerla al tuo template e dargli un nome unico. Ancora, evita l'uso di spazi per garantire la massima compatibilità con tutte le funzioni di aiuto.
Logica
Se fai {{#<property>}}seguito da {{/<property>}}, tutte le parti tra questi due tag verranno mostrate solo se la proprietà contiene un valore. Questo può essere utile per fornire diverse parti a un template che potrebbero essere utilizzate solo alcune volte. Ad esempio, la parte "Effetto" di un tiro potrebbe applicarsi solo a incantesimi, quindi se il tiro non fornisce un effetto, quella sezione non verrà mostrata.
Puoi anche fare {{^<property>}}seguito da {{/<property>}}per significare il contrario, cioè mostrare la sezione solo se la proprietà specificata non esiste.
Funzioni di Aiuto
Ci sono diverse funzioni di supporto che si occupano di tiri forniti. Usatele proprio come il normale schema di logica sopra, ma state chiamando una funzione e fornendo una proprietà. La sezione contenuta tra i tag verrà mostrata solo se la funzione viene valutata come vera.
| Funzione di supporto | Mostra sezione se |
|---|---|
{{#rollWasCrit() <rollname>}} |
Se il tiro fornito contiene critici, la sezione verrà mostrata. Ad esempio, {{#rollWasCrit() attack}} verificherà la proprietà "attacco" per un tiro inline che ha almeno un tiro critico. |
{{#rollWasFumble() <rollname>}} |
Stessa cosa di #rollWasCrit(), ma controlla se ci sono fumble (tiri di 1). |
{{#rollTotal() <rollname>}} |
Controlla il totale di un lancio inline per il valore. Se corrispondono, la sezione viene mostrata. Ad esempio,{{#rollTotal() attack 10}}verificherebbe la proprietà "attacco" per un lancio inline che totalizza 10. |
{{#rollGreater() <rollname>}} |
Controlla il totale di un lancio inline per il valore. Se il risultato del lancio è maggiore, la sezione viene mostrata. Ad esempio,{{#rollGreater() AC 16}}verificherebbe la proprietà "CA" per un lancio inline che ha come risultato 17 o superiore. |
{{#rollLess() <rollname>}} |
Controlla il totale di un tiro inline per il valore. Se il risultato del tiro è inferiore, la sezione viene mostrata. Ad esempio,{{#rollLess() deathsave 10}}verificherebbe la proprietà "deathsave" per un tiro inline che ha dato come risultato 9 o meno. |
{{#rollBetween() <rollname>}} |
Controlla il totale di un tiro inline per il valore. La funzione rollBetween() accetta due numeri. Se il risultato del tiro è uguale o compreso tra i due numeri, la sezione viene mostrata. Ad esempio,{{#rollBetween() strength 7 9}}verificherà la proprietà "strength" per un tiro inline che ha dato come risultato sette, otto o nove. |
Nota: Tutte le funzioni di supporto verificheranno solo il primo tiro inline trovato in una proprietà.
Importante:Quando "chiudi" la sezione di una funzione di supporto, devi includere l'intera chiamata di funzione, compresi tutti gli argomenti. Ad esempio,{{#rollWasCrit() attack}}sarebbe chiuso da{{/rollWasCrit() attack}}.
Ecco un esempio di modello di tiro che mostrerebbe solo la sua sezione di Danno Critico se il tiro di Attacco è un critico:
<div class="sheet-template-container">
<div class="sheet-template-header">{{rollname}}</div>
{{#attack}}<div class="sheet-template-row"><span>Attacco: </span>{{attack}}</div>{{/attack}}
<div class="sheet-template-row">
<span>Danno: </span>{{damage}}
{{#rollWasCrit() attack}}
<span>Critico: </span>{{dmgcrit}}
{{/rollWasCrit() attacco}}
</div>
<div class="sheet-template-row"><span>Tipo: </span>{{dmgtype}}</div>
</div>
Invertendo la Logica
È anche utile essere in grado di testare quando qualcosa non corrisponde alla logica. Se vuoi sapere quando un tiro è Uguale o Maggiore di un totale, non puoi farlo direttamente. Ma puoi testare se un tiro NON è Minore di un totale, che è la stessa cosa.
Puoi farlo partendo da#^e terminando con/^. Ecco come potrebbe apparire quel test:
{{#rollLess() attackroll }}
<span>Tiro Minore di attackroll! </span>
{{/rollLess() attackroll }}
{{#^rollLess() attackroll }}
<span>Tiro NON Minore di attackroll!</span>
<span>In altre parole, il Tiro è maggiore o uguale a attackroll.</span>
{{/^rollLess() attackroll }}
Variabili della Funzione di Supporto
Tutte le funzioni di supporto che accettano un numero, come rollTotal() o rollBetween(), possono utilizzare il risultato di un altro tiro inline nello stesso Modello di Tiro al posto del numero. Ad esempio{{#rollGreater() save poison}}confronta il risultato del tiro salva inline e il risultato del tiro veleno inline e mostra la sezione se il risultato del tiro salva è maggiore.
Funzione Speciale di Supporto: allProps()
Esiste una funzione speciale di supporto chiamata allProps() che può essere utilizzata per elencare dinamicamente tutte le proprietà che sono state passate a un tiro, anche se non le includi esplicitamente. Puoi anche specificare le proprietà da ignorare. Ad esempio, il seguente mostrerà una tabella con una riga per ogni proprietà inclusa nel tiro, ad eccezione della proprietà "attacco":
<div>
<caption>{{name}}</caption>
{{#allprops() attack}}
<div>{{key}}</div><div>{{value}}</div>
{{/allprops() attacco}}
</div>
Styling dei Modelli di Tiro
Per stilizzare un modello di tiro, basta includere il CSS per esso nel CSS del tuo Foglio del Personaggio. Ecco un esempio rapido che dovrebbe darti un'idea di come farlo (in questo esempio, il nome del modello di tiro è "test"):
.sheet-rolltemplate-test div.sheet-template-container {
border: 2px solid #000 !important;
border-radius: 3px 3px 3px 3px;
}
.sheet-rolltemplate-test .sheet-template-header {
background-color: rgba(112, 32, 130,1);
color: #000;
padding: 2px;
border-bottom: 1px solid black;
line-height: 1.6em;
font-size: 1.2em;
}
.sheet-rolltemplate-test div {
padding: 5px;
border-bottom: 1px solid black;
}
.sheet-rolltemplate-test div:nth-child(odd) {
background-color: rgba(217, 217, 214,1);
}
.sheet-rolltemplate-test div:nth-child(even) {
background-color: rgba(233, 233, 233,1);
}
.sheet-rolltemplate-test .inlinerollresult {
display: inline-block;
min-width: 1.5em;
text-align: center;
border: 2px solid rgba(167, 168, 170,1);
}
.sheet-rolltemplate-test .inlinerollresult.fullcrit {
border: 2px solid #3FB315;
}
.sheet-rolltemplate-test .inlinerollresult.fullfail {
border: 2px solid #B31515;
}
.sheet-rolltemplate-test .inlinerollresult.importantroll {
border: 2px solid #4A57ED;
}
Nota che tutti gli stili iniziano con ".sheet-rolltemplate-<templatename>". Puoi quindi stilizzare il tuo HTML personalizzato (come le tabelle, i div e le classi che hai usato). Nota che qualsiasi classe che includi nel layout del tuo modello di roll (come "tcat" nell'esempio sopra) avrà ".userscript-" aggiunto all'inizio per motivi di sicurezza. La cosa più semplice da fare è creare il tuo layout, quindi eseguire un roll in-game e ispezionare l'HTML risultante in modo da assicurarti di considerare qualsiasi filtraggio di sicurezza che sta avvenendo.
Esempi di Modello di Roll
Di seguito sono riportati alcuni esempi specifici del sistema di funzionalità del Modello di Roll.
Dungeons and Dragons 5th Edition
Macro: |
|
|
HTML: |
|
|
| CSS: |
|
|
Dungeons and Dragons 3.5 / Pathfinder
Macro: |
|
|
HTML: |
|
|
| CSS: |
|
|
Il mondo delle tenebre
Macro: |
|
|
HTML: |
|
|
| CSS: |
|
|