From 04c78373f1db0b011557b92cd6fb58268cbeefe4 Mon Sep 17 00:00:00 2001 From: orwell96 Date: Wed, 17 Feb 2021 19:45:52 +0100 Subject: LuaATC: add interrupt_safe() and clear_interrupts(), fix queue mainloop --- advtrains_luaautomation/README.md | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) (limited to 'advtrains_luaautomation/README.md') diff --git a/advtrains_luaautomation/README.md b/advtrains_luaautomation/README.md index c8fb7fe..5232c22 100644 --- a/advtrains_luaautomation/README.md +++ b/advtrains_luaautomation/README.md @@ -20,6 +20,13 @@ Create environment with the given name. To be able to do anything, you first nee - `/env_setup `: Invoke the form to edit the environment's initialization code. For more information, see the section on active components. You can also delete an environment from here. + - `/env_subscribe `, `/env_unsubscribe `: +Subscribe or unsubscribe from log/error messages originating from this environment + + - `/env_subscriptions [env_name]`: +List your subscriptions or players subscribed to an environment. + + ## Functions and variables ### General Functions and Variables The following standard Lua libraries are available: @@ -71,11 +78,17 @@ Set the state of the passive component at position `pos`. Checks whether there is a passive component at the position pos (and/or whether a passive component with this name exists) - `interrupt(time, message)` -Cause LuaAutomation to trigger an `int` event on this component after the given time in seconds with the specified `message` field. `message` can be of any Lua data type. *Not available in init code.* +Cause LuaAutomation to trigger an `int` event on this component after the given time in seconds with the specified `message` field. `message` can be of any Lua data type. Returns true. *Not available in init code.* + + - `interrupt_safe(time, message)` +Like `interrupt()`, but does not add an interrupt and returns false when an interrupt (of any type) is already present for this component. Returns true when interrupt was successfully added. - `interrupt_pos(pos, message)` Immediately trigger an `ext_int` event on the active component at position pos. `message` is like in interrupt(). Use with care, or better **_don't use_**! Incorrect use can result in **_expotential growth of interrupts_**. + - `clear_interrupts()` +Removes any pending interrupts of this node. + - `digiline_send(channel, message)` Make this active component send a digiline message on the specified channel. Not available in init code. -- cgit v1.2.3