Differences

This shows you the differences between two versions of the page.

--- usage:atlatc:events [2020-01-28 10:27]
orwell
+++ usage:atlatc:events [2023-10-10 15:41]
maverick2797 [punch] since 2.4.2, ops panel has also returned puncher's name on punch
@@ Line 86: / Line 86: @@
     type = "punch",
     punch = true,
+    name = name of puncher
 }
 </code>
@@ Line 102: / Line 103: @@
 </code>
 Fired when a train enters the rail. The field ''id'' is the unique ID of the train, which is a 6-digit random numerical string.
-If the world contains trains from an older Advtrains version, the string may be longer and contain a dot (''.'').
+If the world contains trains created in very early advtrains versions (<=2018), the string may be longer and contain a dot (''.'').
 ==== approach ====
@@ Line 111: / Line 112: @@
     approach = true,
     id = <train_id>,
+    has_entered = <boolean>, (latest development version only)
 }
 </code>
 Fired when a train approaches the rail. This event may be generated multiple times for the same train.
-  * **This function is available only in the ''[[http://git.bananach.space/advtrains.git/tree/?h=luaatc-extensions|luaatc-extensions]]'' branch of Advtrains.**
   * **This function is available only when the [[#approach_callback_mechanism|approach callback mechanism]] is enabled.**
+`has_entered` is set to true when the tip of the train is already standing on the node, i.e. the "train" event has already fired.
 === Approach callback mechanism ===
-The approach callback mechanism is a new feature that allows LuaAutomation ATC rails to hook into the approach callback system, which is used by the [[usage:nodes:npr|Point Speed Restriction Rails]] (from ''advtrains_interlocking'') or by [[usage:nodes:stoprail|Station/Stop Rails]] (by ''advtrains_line_automation''). Since it is relatively a recent feature, it needs to be explicitly enabled.
-**At the time of writing (2019-12-18), this feature is available only in ''[[http://git.bananach.space/advtrains.git/tree/?h=luaatc-extensions|luaatc-extensions]]'' branch of Advtrains. To use this branch, clone the Git repo in the Minetest mods directory and then ''git checkout luaatc-extensions'' on the mod directory.**
+//since version 2.3.0//
+The approach callback mechanism is a new feature that allows LuaAutomation ATC rails to hook into the approach callback system, which is used by the [[usage:nodes:npr|Point Speed Restriction Rails]] (from ''advtrains_interlocking'') or by [[usage:nodes:stoprail|Station/Stop Rails]] (by ''advtrains_line_automation''). Since it is relatively a recent feature, it needs to be explicitly enabled.
 To enable the feature, define the following global variable in the local environment of the ATC rail:

Advanced Trains

User Tools

Site Tools

Differences

Page Tools