동적 조명을 위한 모드(API) 지원

프로그래밍 마법사이거나 롤20 모드(API)로 작업하는 것을 좋아하시나요? 그렇다면 좋은 소식이 있습니다 - 이제 다이내믹 라이팅이 롤20 모드(API)와 통합됩니다! 사용자 정의 코드에서 사용할 수 있는 멋진 조명 및 시야 기능을 모두 확인해보세요. 모드(API) 액세스는 프로 구독자만 사용할 수 있으므로 아직 계정을 업그레이드하지 않았다면 지금 바로 업그레이드하세요.


토큰 설정

구문 맥락 유형
has_bright_light_vision  토큰의 시야를 토글합니다. Boolean
has_night_vision 토큰의 야간 시야를 토글합니다.  Boolean
night_vision_distance 토큰의 야간 시야 범위를 설정합니다.  정수
emits_bright_light 토큰에 밝은 빛을 토글합니다.  Boolean
bright_light_distance 토큰에서 발산되는 밝은 빛의 범위를 설정합니다.  정수
emits_low_light 토큰에 어두운 빛을 토글합니다. 이는 횃불이나 적은 양의 빛이 있는 원본에 유용합니다. booleans true를 켜거나 false를 끌 때 사용합니다. Boolean
low_light_distance 토큰에서 발산되는 어두운 빛의 범위를 설정합니다. 이 값을 설정할 때 설정한 밝은 빛 범위를 포함해야 합니다. 이는 Low Light Distance가 토큰의 중심으로부터 계산되기 때문입니다. 따라서 Bright Light Distance를 10으로 설정하고 추가로 10피트의 Low Light Distance가 필요한 경우, low_light_distance의 값은 20이어야 합니다. 정수 
light_sensitivity_multiplier Multiplier on the effectiveness of light sources. 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. 정수
night_vision_effect
Changes the Night Vision Effect. Other options include “Dimming” and “Nocturnal” 문자열

 

방향성 비전 및 조명

구문 문맥 유형
has_limit_field_of_vision 토큰의 시야 제한을 토글합니다.. Boolean
limit_field_of_vision_center 시야의 중심이 시작되는 위치를 설정합니다. 정수
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. Boolean
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. Boolean

방향성 밝은 빛 중앙

밝은 빛 영역의 중앙 위치를 설정합니다. 정수
방향성 밝은 빛 전체 밝은 빛 영역의 전체 크기를 설정합니다. 정수 

방향성 어두운 빛 사용

토큰에 대한 방향성 저조도를 토글합니다. Boolean
방향성 어두운 빛 중앙 어두운 빛 영역의 중앙 위치를 설정합니다. 정수
방향성 어두운 빛 전체 어두운 빛 영역의 전체 크기를 설정합니다. 정수

 


페이지 설정

구문 문맥 유형
dynamic_lighting_enabled 페이지에 대한 업데이트된 동적 조명을 토글합니다.  Boolean
daylight_mode_enabled 페이지에 대한 주간 모드를 토글합니다. 만약 dynamic_lighting_enabled가 꺼져 있다면 이 기능을 켜지 않습니다.  Boolean
explorer_mode

페이지에 대한 탐색 모드를 토글합니다. 만약 dynamic_lighting_enabled가 꺼져 있다면 이 기능을 켜지 않습니다.

”basic”을 입력하면 켜지고, ”off”를 입력하면 꺼집니다. 

문자열

force_lighting_refresh

페이지의 모든 토큰 조명/시야를 새로고침합니다. 여러 토큰을 페이지에 추가한 후에 한 번의 호출로 사용할 수 있습니다. (Will be deprecated in the coming months!) 

Boolean

fog_opacity

Opacity of the fog of war for the GM.

Boolean

lightupdatedrop

Only update Dynamic Lighting when an object is dropped.

Boolean

 


예제 

on("change:graphic", function(obj) {
  obj.set({
    has_bright_light_vision: true,
    emits_bright_light: true,
    bright_light_distance: 10
  });
});

This will add the above values to atokenin two instances:

  • upon adding a newtokento theVTT
  • moving atokenthat already exists on theVTT, with or withouttokensettings already set.

However, using on(“change is dangerous because if you update thetokensettings for a specifictoken, that triggers a change event, which will trigger this API. 따라서 모드(API) 스크립트에 이와 같은 내용이 있으면 원하는 방식으로 작동하도록 조건문을 추가하지 않는 한 모든 토큰에 대해 토큰 설정이 항상 이 상태로 유지됩니다.

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
  });
});

This example will set Vision to any token that has changed (moved, updated, added to the VTT, etc). The token will also emit 10 feet of Bright Light Distance, as well as 15 feet of Low Light Distance.

Notice how low_light_distance is set to 25. 그것은low_light_distance의 값이bright_light_distance의 합과토큰이 발산하는 낮은 빛의 거리 - 이 경우에는15이어야 한다.

 

도움이 되었습니까?
70명 중 43명이 도움이 되었다고 했습니다.