Sind Sie ein Programmiergenie oder arbeiten Sie gerne mit der Roll20-API? Dann haben wir tolle Neuigkeiten für Sie: Dynamic Lighting lässt sich jetzt in die Roll20-API integrieren! Schauen Sie sich alle fantastischen Beleuchtungs- und Vision-Funktionen und -Features an, die Sie in Ihrem benutzerdefinierten Code verwenden können. Beachten Sie, dass der API-Zugriff nur für Pro-Abonnenten verfügbar ist. Aktualisieren Sie also Ihr Konto , falls Sie dies noch nicht getan haben.
TokenEinstellungen
| 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 |
Richtungssicht 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. Wenn Sie also so etwas in Ihrem API-Skript haben, bleiben IhreToken--Einstellungen für alleToken-immer so, es sei denn, Sie fügen einige bedingte Anweisungen hinzu, damit es wie gewünscht funktioniert.
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.