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)! Schau dir alle fantastischen Beleuchtungs- und Sichtfunktionen und -features an, die du in deinem benutzerdefinierten Code verwenden kannst. Denk daran, dass der Zugriff auf Mod (API) nur Pro-Abonnenten zur Verfügung steht.
Spielmarker-Einstellungen
| Syntax | Kontext | Typ |
|---|---|---|
| has_bright_light_vision | Schaltet die Sicht für den Spielmarker um. | Boolescher Wert |
| has_night_vision | Schaltet die Nachtsicht für den Spielmarker um. | Boolescher Wert |
| night_vision_distance | Legt den Nachtsichtbereich für den Spielmarker fest. | Ganze Zahl |
| emits_bright_light | Schaltet das helle Licht für den Spielmarker um. | Boolescher Wert |
| bright_light_distance | Legt den Bereich der Menge an hellem Licht fest, das von einem Spielmarker abgegeben wird. | Ganze Zahl |
| emits_low_light | Schaltet das gerichtete schwache Licht für den Spielmarker um. Dies wäre nützlich für eine Taschenlampe oder eine Lichtquelle 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 Spielmarker 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 Entfernung bei schwachem Licht von der Mitte des Spielmarker aus berechnet wird. Wenn du den Abstand bei hellem Licht auf 10 gesetzt hast und einen zusätzlichen Abstand von 10 Fuß bei schwachem Licht wünschst, 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 Spielmarker ermöglichen, bei gleicher Lichtquelle doppelt so weit zu sehen wie ein Spielmarker mit einem Multiplikator von 100. | Ganze Zahl |
|
nachtsicht_effekt. |
Ä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 den Spielmarker um. | Boolescher Wert |
| limit_field_of_vision_center | Legt den Wert fest, wo die Mitte des Sichtfelds beginnt. | Ganze Zahl |
| limit_field_of_vision_center | Stelle 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 den Spielmarker um. | 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 | Stelle den Wert für die Gesamtgröße des Nachtsichtfeldes ein. | Ganze Zahl |
| has_directional_bright_light | Schaltet gerichtetes helles Licht für den Spielmarker um. | Boolescher Wert |
|
directional_bright_light_center |
Legt den Wert fest, bei dem die Mitte des Feldes mit hellem Licht beginnt. | Ganze Zahl |
| directional_bright_light_total | Stelle den Wert für die Gesamtgröße des hellen Lichtfelds ein. | Ganze Zahl |
|
has_directional_dim_light |
Schaltet gerichtetes schwaches Licht für den Spielmarker um. | Boolescher Wert |
| directional_dim_light_center | Legt den Wert fest, bei dem die Mitte des Feldes bei schwachem Licht beginnt. | Ganze Zahl |
| directional_dim_light_total | Stelle den Wert für die Gesamtgröße des Schwachlichtfeldes ein. | Ganze Zahl |
Seiteneinstellungen
| Syntax | Kontext | Rolle |
|---|---|---|
| dynamic_lighting_enabled | 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
});
});token (beibehalten) ist der technische Name, der nicht übersetzt werden sollte.
- beim Hinzufügen eines neuenTokenszumVTT
- einen Spielmarker verschieben, der bereits auf dem VTT existiert, mit oder ohne bereits gesetzte Spielmarker-Einstellungen.
Die Verwendung von on("change") ist jedoch gefährlich, denn wenn du die Spielmarker-Einstellungen für einen bestimmten Spielmarker aktualisierst, löst das 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.
Hier sollte "Bright_light_distance" und "low_light_distance" einheitlich in Kleinbuchstaben übersetzt werden: "bright_light_distance" und "low_light_distance".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 von low_light_distance die Summe aus bright_light_distance und dem Wert sein muss, den das Spielmarker für die Low Light Distance haben soll - in diesem Fall ist es 15.