Supporto mod (API) per l'illuminazione dinamica

È 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.

 

Questo articolo ti è stato utile?
Utenti che ritengono sia utile: 43 su 70