Mod (API) Support For Dynamic Lighting

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.

 

War dieser Beitrag hilfreich?
44 von 73 fanden dies hilfreich