builtin scripts

2026-06-16 14:34:42 -05:00
parent 7608fc959f
commit 6464e47747
13 changed files with 317 additions and 119 deletions
@@ -0,0 +1,24 @@
+// Built-in script for the `pusher_*` archetypes (see kiln-core/src/builtin_scripts.rs).
+//
+// A pusher is a self-propelled solid that advances one cell in its facing
+// direction every ~0.5s, shoving any pushable chain (including the player) ahead
+// and stopping when blocked. The direction is not baked into this source — every
+// pusher shares one compiled copy and learns its direction from the
+// `BUILTIN_pusher_<dir>` tag the map loader attached to it.
+
+fn tick(dt) {
+    // Only queue a step when idle. `move` shoves the chain ahead via step_object
+    // and is a no-op when blocked; the delay pads each step out to ~0.5s (move
+    // itself costs 0.25s), matching the old global pusher heartbeat.
+    //
+    // The direction is read here, at the top level of the hook, because `Me` is a
+    // per-object scope constant and is not visible inside other script functions.
+    if Queue.length() == 0 {
+        let dir = if Me.has_tag("BUILTIN_pusher_north") { North }
+                  else if Me.has_tag("BUILTIN_pusher_south") { South }
+                  else if Me.has_tag("BUILTIN_pusher_east") { East }
+                  else { West };
+        move(dir);
+        delay(0.25);
+    }
+}