Added on_train_approach callback, non-permanent external LZB brakepoints and basis for "stop rails"

Stop rails ATM use the aforementioned things to add a pointwise "2" speed restriction. Seems to work.

1 files changed, 5 insertions, 0 deletions

diff --git a/advtrains/api_doc.txt b/advtrains/api_doc.txt
index 7bd9c44..d16a611 100644
--- a/advtrains/api_doc.txt
+++ b/advtrains/api_doc.txt
@@ -178,5 +178,10 @@ minetest.register_node(nodename, {
 		^- called when a train enters the rail
 		on_train_leave=function(pos, train_id) end
 		^- called when a train leaves the rail
+		
+		-- The following function is only in effect when interlocking is enabled:
+		on_train_approach = function(pos, train_id, train, index)
+		^- called when a train is approaching this position, called exactly once for every path recalculation (which can happen at any time)
+		^- This is called so that if the train would start braking now, it would come to halt about(wide approx) 5 nodes before the rail.
 	}
 })