프로그래밍 마법사이거나 롤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이어야 한다.