Suporte de mod (API) para iluminação dinâmica

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

 

Este artigo foi útil?
Utilizadores que acharam útil: 43 de 70