Bist du ein Programmierexperte oder arbeitest du gerne mit Roll20 Mods (API)? Wenn ja, haben wir großartige Nachrichten für dich - Dynamische Beleuchtung integriert sich jetzt mit Roll20 Mods (API)! Schauen Sie sich alle fantastischen Beleuchtungs- und Vision-Funktionen und -Features an, die Sie in Ihrem benutzerdefinierten Code verwenden können. Denk daran, auf Mod (API) Zugriff haben nur Pro-Abonnenten, also aktualisiere dein Konto, falls du es noch nicht getan hast.
Spielmarker-Einstellungen
Syntax | Kontext | Typ |
---|---|---|
has_bright_light_vision | Schaltet die Sicht für dasTokenum. | Boolescher Wert |
has_night_vision | Schaltet die Nachtsicht für das Token um. | Boolescher Wert |
night_vision_distance | Legt den Nachtsichtbereich für den Token fest. | Ganze Zahl |
emittiert_helles_Licht | Schaltet das helle Licht für den Token um. | Boolescher Wert |
helle_licht_entfernung | Legt den Bereich der Menge an hellem Licht fest, das von einem Token abgegeben wird. | Ganze Zahl |
emittiert_low_light | Schaltet die schwache Beleuchtung für den Token um. Dies wäre nützlich für eine Taschenlampe oder eine Quelle mit geringer Lichtmenge. Verwenden Sie die booleschen Werte true zum Einschalten oder false zum Ausschalten. | Boolescher Wert |
low_light_distance | Legt den Bereich der schwachen Lichtmenge fest, die von einem Token abgegeben wird. Wenn Sie diesen Wert festlegen, müssen Sie den von Ihnen festgelegten Abstand zu hellem Licht berücksichtigen. Der Grund dafür ist, dass die Low Light Distance von der Mitte des Tokens aus berechnet wird. Wenn Sie also den Abstand bei hellem Licht auf 10 eingestellt haben und einen zusätzlichen Abstand von 10 Fuß bei schwachem Licht wünschen, muss der Wert von low_light_distance 20 sein. | Ganze Zahl |
light_sensitivity_multiplier | Multiplikator für die Wirksamkeit von Lichtquellen. Ein Multiplikator von 200 würde es dem Spielstein ermöglichen, bei gleicher Lichtquelle doppelt so weit zu sehen wie ein Spielstein mit einem Multiplikator von 100. | Ganze Zahl |
night_vision_effect |
Ändert den Nachtsichteffekt. Weitere Optionen sind „Dimmen“ und „Nachtaktiv“. | Zeichenfolge |
Gerichtetes Sehen und Beleuchtung
Syntax | Kontext | Rolle |
---|---|---|
has_limit_field_of_vision | Schaltet die Begrenzung des Sichtfelds für denTokenum. | Boolescher Wert |
limit_field_of_vision_center | Legt den Wert fest, wo die Mitte des Sichtfelds beginnt. | Ganze Zahl |
limit_field_of_vision_total | Stellen Sie den Wert für die Gesamtgröße des Sichtfeldes ein. | Ganze Zahl |
has_limit_field_of_night_vision |
Schaltet die Begrenzung des Nachtsichtfelds für dasTokenum. | Boolescher Wert |
limit_field_of_night_vision_center | Legt den Wert fest, bei dem die Mitte des Nachtsichtfelds beginnt. | Ganze Zahl |
limit_field_of_night_vision_total | Stellen Sie den Wert für die Gesamtgröße des Nachtsichtfeldes ein. | Ganze Zahl |
has_directional_bright_light | Schaltet gerichtetes helles Licht für dasTokenum. | Boolescher Wert |
Directional_Bright_Light_Center |
Legt den Wert fest, bei dem die Mitte des Feldes mit hellem Licht beginnt. | Ganze Zahl |
gerichtetes_bright_light_total | Legen Sie den Wert für die Gesamtgröße des hellen Lichtfelds fest. | Ganze Zahl |
has_directional_dim_light |
Schaltet das gerichtete schwache Licht für dasToken um. | Boolescher Wert |
Directional_dim_light_center | Legt den Wert fest, bei dem die Mitte des Feldes bei schwachem Licht beginnt. | Ganze Zahl |
gerichtetes_dim_licht_total | Legen Sie den Wert für die Gesamtgröße des Schwachlichtfeldes fest. | Ganze Zahl |
Seiteneinstellungen
Syntax | Kontext | Rolle |
---|---|---|
dynamische_beleuchtung_aktiviert | Schaltet die aktualisierte dynamische Beleuchtung für die Seite um. | Boolescher Wert |
daylight_mode_enabled | Schaltet den Tageslichtmodus für die Seite um. Dies sollte nicht aktiviert werden, wenn „dynamic_lighting_enabled“ nicht aktiviert ist. | Boolescher Wert |
explorer_mode |
Schaltet den Explorer-Modus für die Seite um. Dies sollte nicht aktiviert werden, wenn „dynamic_lighting_enabled“ nicht aktiviert ist. Verwenden Sie die Zeichenfolgen „basic“ zum Einschalten oder „off“ zum Ausschalten. |
Zeichenfolge |
force_lighting_refresh |
Löst eine Aktualisierung aller Token-Beleuchtungen/Sichtungen auf einer Seite aus. Kann in einem einzigen Aufruf verwendet werden, nachdem mehrere Token auf einer Seite platziert wurden. (Wird in den kommenden Monaten eingestellt!) |
Boolescher Wert |
fog_opacity |
Undurchsichtigkeit des Nebels des Krieges für den GM. |
Boolescher Wert |
lightupdatedrop |
Aktualisieren Sie Dynamic Lighting nur, wenn ein Objekt abgelegt wird. |
Boolescher Wert |
Beispiele
on("change:graphic", function(obj) {
obj.set({
has_bright_light_vision: true,
emits_bright_light: true,
bright_light_distance: 10
});
});
Dadurch werden die oben genannten Werte in zwei Fällen zu einem-Tokenhinzugefügt:
- beim Hinzufügen eines neuenTokenszumVTT
- Verschieben einesTokens, der bereits auf demVTTvorhanden ist, mit oder ohne bereits festgelegteToken-Einstellungen.
Die Verwendung von on(“change ist jedoch gefährlich, denn wenn Sie dieToken-Einstellungen für einen bestimmten-Tokenaktualisieren, löst dies ein Änderungsereignis aus, das diese API auslöst. Also, wenn du so etwas in deinem Mod (API) Skript hast, werden deine Spielmarker Einstellungen immer auf diese Weise für jeden Spielmarker bleiben, es sei denn, du fügst einige bedingte Anweisungen hinzu, damit es so funktioniert, wie du willst.
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
});
}) ;
In diesem Beispiel wird Vision auf jedesTokengesetzt, das sich geändert hat (verschoben, aktualisiert, zumVTThinzugefügt usw.). DerTokenstrahlt außerdem eine helle Lichtentfernung von 10 Fuß sowie eine Entfernung von schwachem Licht von 15 Fuß aus.
Beachten Sie, dasslow_light_distanceauf25gesetzt ist. Das liegt daran, dass der Wert vonlow_light_distancedie Summe vonBright_light_distancesein muss und wie viel Sie möchten, dass das-TokenLow Light Distance aussendet – in diesem Fall ist es15.