È un mago della programmazione o le piace lavorare con le Mod di Roll20 (API)? Se è così, abbiamo una grande notizia per lei: l'Illuminazione Dinamica si integra ora con le Mods di Roll20 (API)! Scopri tutte le fantastiche funzioni e caratteristiche di Illuminazione e Visione che puoi usare nel tuo codice personalizzato. Tenga presente che l'accesso Mod (API) è disponibile solo per gli abbonati Pro, quindi aggiorni il suo account se non l'ha ancora fatto.
Impostazioni del gettone
| Sintassi | Contesto | Tipo |
|---|---|---|
| ha_bright_light_vision | Attiva la visione per il token. | Boolean |
| ha_night_vision | Attiva la visione notturna per il token. | Boolean |
| distanza_visione_notturna | Imposta la portata della visione notturna per il token. | Intero |
| emits_bright_light | Attiva o disattiva la luce intensa per il token. | Boolean |
| bright_light_distance | Imposta la portata dell'ammontare di luce intensa emessa da un token. | Intero |
| emits_low_light | Attiva o disattiva la luce bassa per il token. Questo sarebbe utile per una torcia o una fonte con una quantità ridotta di luce. Utilizza i booleani true per attivare o false per disattivare. | Boolean |
| low_light_distance | Imposta la portata dell'ammontare di luce bassa emessa da un token. Quando si imposta questo valore, è necessario includere qualsiasi Distanza Luce Intensa che hai impostato. Il motivo per cui ciò avviene è perché la distanza di bassa luce viene calcolata dal centro del token. Quindi, se hai impostato la distanza di luce intensa a 10 e desideri ulteriori 10 piedi di distanza di bassa luce, il valore di low_light_distance deve essere 20. | Intero |
| moltiplicatore_di_sensibilità_alla_luce | Moltiplicatore sull'efficacia delle fonti di luce. Un moltiplicatore di 200 permetterebbe al token di vedere due volte più lontano di un token con un moltiplicatore di 100, con la stessa fonte di luce. | Intero |
|
effetto_visione_notturna |
Modifica l'effetto di visione notturna. Altre opzioni includono "Oscurante" e "Notturno". | Stringa |
Visione direzionale e illuminazione
| Sintassi | Contesto | Tipo |
|---|---|---|
| ha_limitare_campo_visivo | Attiva il limite del campo visivo per il token. | Boolean |
| limite_campo_visivo_centrale | Imposta il valore da cui inizia il centro del campo visivo. | Intero |
| campo_limite_di_visione_totale | Imposta il valore della dimensione totale del campo visivo. | Integro |
|
ha_limitato_il_campo_di_visione_notturna |
Le levette limitano il campo di visione notturna per il token. | Boolean |
| limite_campo_di_visione_notte_centro | Imposta il valore del punto in cui inizia il centro del campo visivo notturno. | Integro |
| campo_limite_di_visione_notte_totale | Imposta il valore della dimensione totale del campo di visione notturna. | Integro |
| ha_luce_luminosa_direzionale | Alterna la luce luminosa direzionale per il gettone. | Boolean |
|
centro_luce_luminosita_direzionale |
Imposta il valore per dove inizia il centro del campo di luce brillante. | Intero |
| luce_luminosita_direzionale_totale | Imposta il valore per la dimensione totale del campo di luce brillante. | Intero |
|
ha_luce_tenue_direzionale |
Attiva la luce bassa direzionale per il gettone. | Boolean |
| centro_luce_tenue_direzionale | Imposta il valore per dove inizia il centro del campo di luce tenue. | Intero |
| luce_tenue_direzionale_totale | Imposta il valore per la dimensione totale del campo di luce tenue. | Intero |
Impostazioni pagina
| Sintassi | Contesto | Tipo |
|---|---|---|
| dynamic_lighting_enabled | Abilita la luce dinamica aggiornata per la pagina. | Boolean |
| daylight_mode_enabled | Abilita la modalità diurna per la pagina. Non attivare se dynamic_lighting_enabled non è attivato. | Boolean |
| explorer_mode |
Abilita la modalità esploratore per la pagina. Non attivare se dynamic_lighting_enabled non è attivato. Utilizza le stringhe ”basic” per accendere o ”off” per spegnere. |
Stringa |
| force_lighting_refresh |
Attiva un aggiornamento di tutte le luci/visioni delle pedine in una pagina. Può essere utilizzato in una sola chiamata dopo aver posizionato più pedine in una pagina. (Sarà deprecato nei mesi a venire!) |
Boolean |
| opacità_nebbia |
Opacità della nebbia per il GM. |
Boolean |
|
lightupdatedrop |
Aggiorna l'Illuminazione dinamica solo quando un oggetto viene lasciato cadere. |
Boolean |
Esempi
on("change:graphic", function(obj) {
obj.set({
has_bright_light_vision: true,
emits_bright_light: true,
bright_light_distance: 10
});
});Questo aggiungerà i valori sopra a un token in due istanze:
- alla aggiunta di un nuovo token alla VTT
- spostando un token che già esiste sulla VTT, con o senza impostazioni del token già impostate.
Tuttavia, utilizzare on(“change è pericoloso perché se aggiorni le impostazioni del token per un token specifico token, viene generato un evento di cambio, che attiverà questa API. Quindi, se ha una cosa del genere nel suo script Mod (API), le impostazioni dei token rimarranno sempre così per ogni token, a meno che non aggiunga alcune dichiarazioni condizionali in modo che funzioni nel modo desiderato.
on("change:graphic", function(obj) {
obj.set({
has_bright_light_vision: true,
emits_bright_light: true,
bright_light_distance: 10,
emits_low_light: true,
low_light_distance: 25
});
});Questo esempio imposterà Vision su qualsiasi tokenche sia cambiato (spostato, aggiornato, aggiunto al VTT, ecc). Il tokenemetterà anche 10 metri di distanza luminosa, oltre a 15 metri di distanza luminosa bassa.
Notare comelow_light_distanceè impostato su25. Questo perché il valore dilow_light_distancedeve essere la somma dibright_light_distancee di quanto vorresti che iltokenemetta la Distanza Luce Bassa - in questo caso, è15.