Scripting:TWBaseTrap

All the scripts with "Trap" in their name inherit from this base trap script and they typically do something in response to being sent messages - usually a TurnOn or TurnOff message. All TWTrap...whatever... scripts support the following arguments in the Editor -> Design Note. [ScriptName] here is the name of the script as you entered it into the S->Scripts property.

Note: standard Trap Control Flags property is not used or supported.

Messages

[ScriptName]On

Type: string

Default: TurnOn

Use this parameter to specify which script message should activate the script.

[ScriptName]Off

Type: string

Default: TurnOff

Use this parameter to specify which script message should deactivate the script.

You can use [ScriptName]On="TurnOff"; [ScriptName]Off="TurnOn" to simulate the Invert Trap Control Flag; [ScriptName]On="Null" can be used to simulate NoOn and [ScriptName]Off="Null" can be used to simulate NoOff.

Use limiting

[ScriptName]Count

Type: integer

Default: 0 (infinite)

Set the maximum number of times that the script will work. You can use [ScriptName]Count=1 to emulate the Once Trap Control Flag. Sending the trap a ResetCount message will reset the counter.

[ScriptName]CountFalloff

Type: time

Default: 0 (no falloff)

Specify a time, in milliseconds, that it takes for the count to decrease by one. This defaults to 0, which means that no falloff happens and the script will stop working when the count is reached until a ResetCount message is sent to it. If you set a falloff, the count of the number of times the script has worked is decreased over time, eventually dropping back down to zero if no further activations have happened. Note that, unless [ScriptName]CountLimit is true, activations will increase the count of number of times the trap has worked, even if it has had no effect.

[ScriptName]CountLimit

Type: boolean

Default: false

If set to true, the count of number of times the script has worked will be limited to the maximum. Otherwise, every attempted activation will be counted, even if it didn't work.

[ScriptName]CountOnly

Type: integer/string

Default: Both

Valid values: 1, 2, 3, On, Off, Both

Both TurnOn and TurnOff are counted against the [ScriptName]Count by default. You can use [ScriptName]CountOnly=1 or [ScriptName]CountOnly=On to ignore TurnOff, and [ScriptName]CountOnly=2 or [ScriptName]CountOnly=Off to ignore TurnOn.

Capacitors

[ScriptName][On/Off]Capacitor

Type: integer

Default: 1 (activates for every message)

Use this parameter to specify the number of times that a trap will need to receive its triggering message before it activates. For example, an script with [ScriptName]Capacitor=3 will only activate on every third message, while one with [ScriptName]OnCapacitor=4; [ScriptName]OffCapacitor=2 will activate on every second TurnOff message but only every fourth TurnOn message.

[ScriptName][On/Off]CapacitorFalloff

Type: time

Default: 0 (no falloff)

can be used to specify the time, in milliseconds, that it takes for the trap to "lose charge", and the activation count to go back down by one activation.

Note that, while you can specify [ScriptName]Capacitor and [ScriptName]OnCapacitor or [ScriptName]OffCapacitor at the same time, I'm not entirely sure why you'd want to in most cases.