あなたはプログラミングの達人ですか、それともRoll20 Mods (API)を使うのが好きですか？ ダイナミックライティングがRoll20 Mods (API) と統合されました！ あなたのカスタムコードで使用できる素晴らしいLightingとVisionの関数と機能のすべてをチェックしてください。 Mod（API）アクセスはPro契約者のみが利用可能ですので、まだの方はアカウントをアップグレードしてください。
トークンの設定
| 構文 | コンテクスト | タイプ |
|---|---|---|
| ハズ・ブライト・ライト・ビジョン | トークンのビジョンを切り替える。 | ブーリアン |
| ハズ・ナイト・ビジョン | トークンのナイトビジョンを切り替える。 | ブーリアン |
| 夜間視界距離 | トークンのナイトビジョンの範囲を設定します。 | 整数 |
| 明るい光を発する | トークンの明るい光を切り替えます。 | ブーリアン |
| ブライト・ライト・ディスタンス | トークンから放射される明るい光の量の範囲を設定する。 | 整数 |
| 低照度 | トークンのローライトを切り替える。 これはトーチや光量の少ない光源に有効だろう。 trueでオン、falseでオフ。 | ブーリアン |
| 低照度距離 | トークンからの低光量発光の範囲を設定します。 この値を設定する際には、設定したブライトライトディスタンスを含める必要があります。 ローライト距離はトークンの中心から計算されるからです。 つまり、Bright Light Distanceを10に設定し、さらに10フィートのLow Light Distanceが必要な場合、low_light_distanceの値は20でなければなりません。 | 整数 |
| 感光倍率 | 光源の有効性に関する乗数。 倍率200のトークンは、同じ光源で倍率100のトークンの2倍の距離を見ることができる。 | 整数 |
|
ナイトビジョン効果 |
ナイトビジョン効果を変更する。 その他のオプションには、"調光 "と "夜間 "がある。 | ストリング |
指向性ビジョンと照明
| 構文 | コンテクスト | タイプ |
|---|---|---|
| 視野の制限 | トークンの視野制限を切り替える。 | ブーリアン |
| リミット・フィールド・オブ・ビジョン・センター | 視野の中心がどこから始まるかを設定する。 | 整数 |
| リミット・フィールド・オブ・ビジョン・トータル | 視野の合計サイズの値を設定する。 | 整数 |
|
ハズ・リミット・フィールド・オブ・ナイト・ビジョン |
トークンの夜間視界の制限を切り替える。 | ブーリアン |
| リミット・フィールド・オブ・ナイトビジョン・センター | 暗視の視野の中心がどこから始まるかを設定する。 | 整数 |
| リミット・フィールド・オブ・ナイト・ビジョン・トータル | 夜間視界の合計サイズを設定します。 | 整数 |
| ハズ・ディレクショナル・ブライト・ライト | トークンの明るい光の方向を切り替えます。 | ブーリアン |
|
ディレクショナル・ブライト・ライトセンター |
明るい光のフィールドの中心が始まる位置を設定する。 | 整数 |
| ディレクショナル・ブライト・ライト・トータル | 明るい光のフィールドの合計サイズの値を設定する。 | 整数 |
|
ハズ_ディレクショナル_ディム_ライト |
トークンの指向性ローライトを切り替える。 | ブーリアン |
| ディレクショナル・ディム・ライト・センター | 低照度のフィールドの中心が始まる位置を設定する。 | 整数 |
| ディレクショナル・ディム・ライト・トータル | ローライトのフィールドの合計サイズの値を設定する。 | 整数 |
ページ設定
| 構文 | コンテクスト | タイプ |
|---|---|---|
| ダイナミック・ライト有効 | ページのダイナミックライティングの更新を切り替えます。 | ブーリアン |
| デイライトモード有効 | ページのデイライトモードを切り替える。 dynamic_lighting_enabledがオンになっていない場合は、オンにしてはならない。 | ブーリアン |
| エクスプローラモード |
ページのエクスプローラモードを切り替える。 dynamic_lighting_enabledがオンになっていない場合は、オンにしてはならない。 オンにするには "basic"、オフにするには "off "という文字列を使う。 |
ストリング |
| フォース・ライティング・リフレッシュ |
ページ上のすべてのトークン照明/ビジョンのリフレッシュをトリガーする。 複数のトークンをページに配置した後、1回の呼び出しで使用できる。 (今後数ヶ月で非推奨となります!) |
ブーリアン |
| 霧の不透明度 |
GMにとっての戦争の霧の不透明さ。 |
ブーリアン |
|
ライトアップドロップ |
オブジェクトがドロップされたときのみ、Dynamic Lightingを更新します。 |
ブーリアン |
例
on("change:graphic", function(obj) {
obj.set({
has_bright_light_vision: true,
emits_bright_light: true,
bright_light_distance: 10
});
})；これにより、上記の値が2つのインスタンスでトークンに追加される：
- VTTに新しいトークンを追加する際
- トークン設定の有無にかかわらず、VTT上にすでに存在するトークンを移動します。
しかし、on("change "を使うのは危険だ。特定のトークンの トークン設定を更新すると、changeイベントが発生し、このAPIがトリガーされるからだ。 つまり、MOD（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
});
})；この例では、変更（移動、更新、VTTへの追加など）されたトークンにVisionを設定します。 また、トークンは10フィートの明るい光と15フィートの暗い光を照射する。
low_light_distanceが 25に設定されていることに注目してほしい。 なぜなら、low_light_distanceの値は、bright_light_distanceと、トークンにLow Light Distance（低光量距離）をどれだけ放出させたいかを合計した値でなければならないからです。