É um mago da programação ou gosta de trabalhar com Roll20 Mods (API)? Se for esse o caso, temos óptimas notícias para si - o Dynamic Lighting integra-se agora com os Roll20 Mods (API)! Confira todas as incríveis funções e recursos de Iluminação e Visão que você pode usar no seu código personalizado. Tenha em atenção que o acesso Mod (API) só está disponível para subscritores Pro, por isso actualize a sua conta se ainda não o fez.
Definições de token
| Sintaxe | Contexto | Tipo |
|---|---|---|
| has_bright_light_vision | Ativa/desativa a visão para o token . | Booleano |
| has_night_vision | Ativa/desativa a visão noturna para o token. | Booleano |
| night_vision_distance | Define o alcance da visão noturna para o token. | Inteiro |
| emite_luz_brilhante | Ativa ou desativa a luz brilhante para o token. | Booleano |
| distância_luz_brilhante | Define o alcance da quantidade de luz brilhante emitida por um token. | Inteiro |
| emite_luz_fraca | Ativa ou desativa a luz fraca para o token. Isso seria útil para uma tocha ou uma fonte com pouca quantidade de luz. Use os booleanos true para ligar ou false para desligar. | Booleano |
| distância_luz_fraca | Define o alcance da quantidade de luz fraca emitida por um token. Ao definir esse valor, você deve incluir qualquer Distância de Luz Brilhante que você tenha definido. A razão para isso é porque a Distância de Luz Baixa é calculada a partir do centro do token. Portanto, se você definiu a Distância de Luz Brilhante como 10 e deseja ter mais 10 pés de Distância de Luz Baixa, o valor de low_light_distance deve ser 20. | Inteiro |
| light_sensitivity_multiplier | Multiplicador na efetividade das fontes de luz. A multiplier of 200 would allow the token to see twice as far as a token with a multiplier of 100, with the same light source. | Inteiro |
|
efeito_de_visão_noturna |
Changes the Night Vision Effect. Other options include “Dimming” and “Nocturnal” | String |
Visão direcional e iluminação
| Sintaxe | Contexto | Tipo |
|---|---|---|
| has_limit_field_of_vision | Ativa/desativa o limite do campo de visão para o token. | Booleano |
| limit_field_of_vision_center | Define o valor onde o centro do campo de visão começa. | Inteiro |
| 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 |
|
directional_bright_light_center |
Sets the value for where the center of the field of bright light starts. | Integer |
| directional_bright_light_total | Set the value for the total size of the field of bright light. | Integer |
|
has_directional_dim_light |
Toggles directional low light for the token. | Booleano |
| directional_dim_light_center | Sets the value for where the center of the field of low light starts. | Integer |
| directional_dim_light_total | Set the value for the total size of the field of low light. | Integer |
Configurações da Página
| Sintaxe | Contexto | Tipo |
|---|---|---|
| dynamic_lighting_enabled | Ativa/desativa a iluminação dinâmica atualizada para a página. | Booleano |
| daylight_mode_enabled | Ativa/desativa o modo de luz do dia para a página. Isso não deve ser ativado se a iluminação dinâmica não estiver ativada. | Booleano |
| explorer_mode |
Ativa/desativa o modo explorador para a página. Isso não deve ser ativado se a iluminação dinâmica não estiver ativada. Use as strings ”basic” para ativar ou ”off” para desativar. |
String |
| force_lighting_refresh |
Dispara uma atualização de toda a iluminação/visão do token em uma página. Pode ser usado em uma única chamada após colocar vários tokens em uma página. (Será descontinuado nos próximos meses!) |
Booleano |
| opacidade do nevoeiro |
Opacidade do nevoeiro de guerra para o GM. |
Booleano |
|
lightupdatedrop |
Only update Dynamic Lighting when an object is dropped. |
Booleano |
Exemplos
on("change:graphic", function(obj) {
obj.set({
has_bright_light_vision: true,
emits_bright_light: true,
bright_light_distance: 10
});
});Isto irá adicionar os valores acima a um tokenem duas instâncias:
- ao adicionar um novo tokenaoVTT
- deslocar um tokenque já existe noVTT, com ou sem definições do tokenjá definidas.
No entanto, a utilização de on("change é perigosa, porque se atualizar as definições do tokenpara um tokenespecífico, isso desencadeia um evento de alteração, que desencadeará esta API. Assim, se tiver algo deste género no seu script Mod (API), as suas definições de token manter-se-ão sempre assim para cada token, a menos que adicione algumas instruções condicionais para que funcione da forma que pretende.
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 exemplo definirá Visão para qualquer tokenque tenha sido alterado (movido, atualizado, adicionado aoVTT, etc.). O tokentambém emite 10 pés de distância de luz brilhante, bem como 15 pés de distância de luz fraca.
Repare comolow_light_distanceestá definido para25. Isso ocorre porque o valor delow_light_distancedeve ser a soma debright_light_distancee a quantidade que você deseja que otokenemita a Distância de Luz Baixa - neste caso, é15.