¿Es usted un mago de la programación o le gusta trabajar con los Mods de Roll20 (API)? Si es así, tenemos una gran noticia para usted: ¡La iluminación dinámica se integra ahora con Roll20 Mods (API)! Echa un vistazo a todas las increíbles funciones y características de Iluminación y Visión que puedes usar en tu código personalizado. Tenga en cuenta que el acceso Mod (API) sólo está disponible para los suscriptores Pro, así que actualice su cuenta si aún no lo ha hecho.
Configuración de tokens
| Sintaxis | Contexto | Tipo |
|---|---|---|
| tiene_visión_luz_brillante | Activa o desactiva la visión para la ficha. | Booleano |
| tiene_visión_nocturna | Activa o desactiva la visión nocturna para la ficha. | Booleano |
| distancia_visión_nocturna | Establece el rango de visión nocturna para el token. | Entero |
| emits_bright_light | Activa la luz brillante para el token. | Booleano |
| bright_light_distance | Establece el rango de la cantidad de luz brillante que emite un token. | Entero |
| emits_low_light | Activa la luz tenue para el token. Esto sería útil para una antorcha o una fuente con una pequeña cantidad de luz. Utilice los booleanos true para encender o false para apagar. | Booleano |
| low_light_distance | Establece el rango de la cantidad de luz tenue que emite un token. Al establecer este valor, debes incluir cualquier distancia de luz brillante que hayas configurado. La razón de esto es porque la Distancia de Luz Baja se calcula desde el centro de la ficha. Entonces, si has configurado la Distancia de Luz Brillante en 10, y te gustaría tener 10 pies adicionales de Distancia de Luz Baja, el valor de low_light_distance debe ser 20. | Integer |
| light_sensitivity_multiplier | Multiplicador sobre la eficacia de las fuentes de luz. Un multiplicador de 200 permitiría que el token vea el doble de lejos que un token con un multiplicador de 100, con la misma fuente de luz. | Integer |
|
efecto_vision_nocturna |
Cambia el Efecto de Visión nocturna. Otras opciones incluyen “Atenuación” y “Nocturno” | Cadena |
Visión direccional e iluminación
| Sintaxis | Contexto | Tipo |
|---|---|---|
| has_limit_field_of_vision | Activa o desactiva el límite de campo de visión para la ficha . | Booleano |
| limit_field_of_vision_center | Establece el valor desde donde comienza el centro del campo de visión. | Integer |
| limit_field_of_vision_total | Set the value for the total size of the field of vision. | Integer |
|
has_limit_field_of_night_vision |
Toggles limit field of night vision for the token. | Booleano |
| limit_field_of_night_vision_center | Sets the value for where the center of the field of night vision starts. | Integer |
| limit_field_of_night_vision_total | Set the value for the total size of the field of night vision. | Integer |
| has_directional_bright_light | Toggles directional bright light for the token. | Booleano |
|
centro_de_luz_brillante_direccional |
Establece el valor para donde comienza el centro del campo de luz brillante. | Entero |
| luz_brillante_direccional_total | Establece el valor para el tamaño total del campo de luz brillante. | Entero |
|
tiene_iluminacion_dirigida_en_penumbra |
Alterna la penumbra direccional para el token . | Booleano |
| centro_de_penumbra_dirigida | Establece el valor para donde comienza el centro del campo de penumbra. | Entero |
| penumbra_dirigida_total | Establece el valor para el tamaño total del campo de penumbra. | Entero |
Ajustes de página
| Sintaxis | Contexto | Tipo |
|---|---|---|
| dynamic_lighting_enabled | Actualiza la iluminación dinámica de la página. | Booleano |
| daylight_mode_enabled | Activa el modo diurno para la página. Esto no debe activarse si dynamic_lighting_enabled no está activado. | Booleano |
| explorer_mode |
Activa el modo explorador para la página. Esto no debe activarse si dynamic_lighting_enabled no está activado. Utilice las cadenas "basic" para activar o "off" para desactivar. |
Cadena |
| force_lighting_refresh |
Provoca una actualización de la iluminación/visión de todos los tokens en una página. Se puede utilizar en una sola llamada después de colocar varios tokens en una página. (¡Se deprecará en los próximos meses!) |
Booleano |
| fog_opacity |
Opacity of the fog of war for the GM. |
Booleano |
|
lightupdatedrop |
Solo actualizar la Iluminación Dinámica cuando un objeto es soltado. |
Booleano |
Ejemplos
on("change:graphic", function(obj) {
obj.set({
has_bright_light_vision: true,
emits_bright_light: true,
bright_light_distance: 10
});
});Esto agregará los valores anteriores a un token en dos instancias:
- al agregar un nuevo token al VTT
- al mover un token que ya existe en el VTT, con o sin configuraciones de token ya establecidas.
Sin embargo, usar on(“change es peligroso porque si actualizas las configuraciones del token para un token específico, eso desencadena un evento de cambio, que activará esta API. Por lo tanto, si tiene algo como esto en su script Mod (API), la configuración de su token siempre permanecerá así para cada token, a menos que añada algunas sentencias condicionales para que funcione como usted desea.
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
});
});Este ejemplo establecerá Vision en cualquier tokenque haya cambiado (movido, actualizado, añadido a laVTT, etc). La fichatambién emitirá 10 pies de distancia de luz brillante, así como 15 pies de distancia de luz baja.
Obsérvese cómolow_light_distanceestá configurado en25. Esto se debe a que el valor delow_light_distancedebe ser la suma debright_light_distancey la cantidad que desee que emita el testigoLow Light Distance - en este caso, es15.