LightSwitch

This module allows players to trigger a macro that turns on and off lights (through the GM).

Known Issues

• Multiple lights with the same name will not trigger as a group. (see issues/2)

How to use

NOTE: A GM and player are required for this module to work.

1. Open up any light configuration panel and set the name of the light. (Multiple lights can share a name and be triggered as a group.) When you're done, click Update Light Source.
2. Toggle the light(s) on or off in any combination by right clicking a light.
3. Create a macro with the type script, with the following contents, replacing lightgroup1 with the name of your light(s): game.LightSwitch.flipTheSwitch("lightgroup1")
4. Use whatever module you wish to trigger the macro. This macro MUST be triggered by a user, not a GM, otherwise it will not work. ^{_{(see below for a GM macro command)}} I recommend the module Trigger Happy
5. Repeat the process for any other lights

If you wish to trigger macros as a GM, you can use the following macro command instead: game.LightSwitch.flipTheSwitchGM("lightgroup1")

When the macro is triggered, all lights matching the name you set in the macro will be toggled. If there are multiple lights, this could mean that some switch on, while others switch off.

KNOWN ISSUES

I haven't determined the cause or exact trigger for this, but sometimes lights will stop switching on/off if clicked too rapidly or too many times within a session. A refresh will fix this until it occurs again.

Attribution

Code fixes

@anthonydeaver for 0.8.8 compat fix

Icons

• Some icons made by Those Icons from www.flaticon.com