@ludra/cli 0.4.0 → 0.7.0

package/blocks/key-and-door/block.json

@@ -0,0 +1,90 @@
+{
+  "name": "key-and-door",
+  "description": "A key and the locked door it opens. The door is solid until the player touches it after taking the key.",
+  "tags": [
+    "platformer",
+    "puzzle",
+    "script"
+  ],
+  "usage": "--at x,y floats the key 40px above (x, y) and stands the door 200px to the right on the same surface. Move either freely; they stay linked through the key's params.door.",
+  "entities": [
+    {
+      "id": "{id}-key",
+      "components": {
+        "transform": {
+          "dx": 0,
+          "dy": -40
+        },
+        "body": {
+          "type": "static",
+          "width": 24,
+          "height": 24,
+          "sensor": true
+        },
+        "sprite": {
+          "color": "#ffd166",
+          "image": "assets/key.svg",
+          "layer": 1
+        },
+        "script": {
+          "src": "scripts/key.ts",
+          "params": {
+            "door": "{id}-door"
+          }
+        }
+      }
+    },
+    {
+      "id": "{id}-door",
+      "components": {
+        "transform": {
+          "dx": 200,
+          "dy": -60
+        },
+        "body": {
+          "type": "static",
+          "width": 28,
+          "height": 120
+        },
+        "sprite": {
+          "color": "#7a4e2d",
+          "image": "assets/door.svg",
+          "layer": 1
+        },
+        "script": {
+          "src": "scripts/locked-door.ts"
+        }
+      }
+    }
+  ],
+  "files": [
+    "scripts/key.ts",
+    "scripts/locked-door.ts",
+    "assets/key.svg",
+    "assets/door.svg"
+  ],
+  "effects": {
+    "key": {
+      "sound": "powerup",
+      "particles": {
+        "count": 18,
+        "color": "#ffd166",
+        "speed": 150,
+        "life": 0.6,
+        "size": 3,
+        "gravity": 150
+      }
+    },
+    "door-open": {
+      "sound": "explosion",
+      "shake": 6,
+      "particles": {
+        "count": 26,
+        "color": "#a0714b",
+        "speed": 200,
+        "life": 0.6,
+        "size": 4
+      }
+    }
+  }
+}

package/blocks/key-and-door/demo.json

@@ -0,0 +1,31 @@
+{
+  "at": [
+    300,
+    500
+  ],
+  "tests": [
+    {
+      "name": "the door blocks a player without the key",
+      "playerAt": [
+        360,
+        482
+      ],
+      "inputs": "right:2s",
+      "assert": [
+        "key-and-door-door.exists == true",
+        "player.x < 490",
+        "events.key == 0"
+      ]
+    },
+    {
+      "name": "taking the key unlocks the door, which opens on contact",
+      "inputs": "right:2.5s",
+      "assert": [
+        "events.key == 1",
+        "events.door-open == 1",
+        "key-and-door-door.exists == false",
+        "player.x > 520"
+      ]
+    }
+  ]
+}

package/blocks/key-and-door/scripts/key.ts

@@ -0,0 +1,12 @@
+import type { Script } from "@ludra/core";
+
+/** Picked up by a player; unlocks the door named by params.door. */
+export default {
+  touch({ self, world, params }, other) {
+    if (!other.has("platformer") && !other.has("topdown")) return;
+    const door = world.get(params.door as string);
+    if (door) door.state.unlocked = true;
+    world.emit("key");
+    world.destroy(self);
+  },
+} satisfies Script;

package/blocks/key-and-door/scripts/locked-door.ts

@@ -0,0 +1,15 @@
+import type { Script } from "@ludra/core";
+
+/** A solid door. Once a key has unlocked it, it opens (disappears) when a player walks into it. */
+export default {
+  start({ self }) {
+    self.state.unlocked ??= false;
+  },
+  update({ self, world }) {
+    const player = world.player();
+    if (self.state.unlocked && player && self.touches(player)) {
+      world.emit("door-open");
+      world.destroy(self);
+    }
+  },
+} satisfies Script;

package/blocks/moving-platform/assets/lift.svg

@@ -0,0 +1,9 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 20 20">
+  <!-- Tile: riveted metal with hazard stripes for moving platforms. -->
+  <rect width="20" height="20" fill="#8fa3d9"/>
+  <rect width="20" height="3" fill="#c3d0f2"/>
+  <rect y="14" width="20" height="6" fill="#f2c14e"/>
+  <path d="M0 20 L 6 14 L 10 14 L 4 20 Z M10 20 L 16 14 L 20 14 L 14 20 Z" fill="#2b3150"/>
+  <circle cx="5" cy="8" r="1.4" fill="#5d6f9e"/>
+  <circle cx="15" cy="8" r="1.4" fill="#5d6f9e"/>
+</svg>

package/blocks/moving-platform/block.json

@@ -0,0 +1,38 @@
+{
+  "name": "moving-platform",
+  "description": "A platform that moves back and forth and carries whoever stands on it.",
+  "tags": [
+    "platformer",
+    "movement"
+  ],
+  "usage": "--at x,y is the platform's center where it starts. It moves patrol.distance px right and back; set patrol.axis to \"y\" for an elevator (it moves down first).",
+  "entities": [
+    {
+      "id": "{id}",
+      "components": {
+        "transform": {
+          "dx": 0,
+          "dy": 0
+        },
+        "body": {
+          "type": "kinematic",
+          "width": 120,
+          "height": 20
+        },
+        "sprite": {
+          "color": "#8fa3d9",
+          "image": "assets/lift.svg",
+          "tile": true
+        },
+        "patrol": {
+          "axis": "x",
+          "distance": 160,
+          "speed": 80
+        }
+      }
+    }
+  ],
+  "files": [
+    "assets/lift.svg"
+  ]
+}

package/blocks/moving-platform/demo.json

@@ -0,0 +1,27 @@
+{
+  "at": [
+    400,
+    400
+  ],
+  "tests": [
+    {
+      "name": "moves along its patrol",
+      "duration": "1s",
+      "assert": [
+        "moving-platform.x > 470"
+      ]
+    },
+    {
+      "name": "carries a player standing on it",
+      "playerAt": [
+        400,
+        372
+      ],
+      "duration": "1s",
+      "assert": [
+        "player.grounded == true",
+        "player.x > 470"
+      ]
+    }
+  ]
+}

package/blocks/patrol-enemy/assets/slime.svg

@@ -0,0 +1,21 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="64" height="26" viewBox="0 0 64 26">
+  <!-- Spritesheet: 2 frames of 32x26, a bouncing slime facing right. -->
+  <g>
+    <path d="M2 25 C 2 10, 8 3, 16 3 C 24 3, 30 10, 30 25 Z" fill="#c77dff"/>
+    <path d="M5 25 C 5 18, 9 14, 13 14 C 9 17, 8 21, 8 25 Z" fill="#e0b0ff" opacity="0.7"/>
+    <path d="M14 11 l 6 2" stroke="#2a1440" stroke-width="2" stroke-linecap="round"/>
+    <path d="M27 11 l -4 2" stroke="#2a1440" stroke-width="2" stroke-linecap="round"/>
+    <circle cx="18" cy="15" r="2" fill="#2a1440"/>
+    <circle cx="24" cy="15" r="2" fill="#2a1440"/>
+    <path d="M17 20 q 4 2 8 0" stroke="#2a1440" stroke-width="1.5" fill="none" stroke-linecap="round"/>
+  </g>
+  <g transform="translate(32 0)">
+    <path d="M0 25 C 0 14, 7 8, 16 8 C 25 8, 32 14, 32 25 Z" fill="#c77dff"/>
+    <path d="M3 25 C 3 20, 7 17, 11 17 C 7 19, 6 22, 6 25 Z" fill="#e0b0ff" opacity="0.7"/>
+    <path d="M14 15 l 6 2" stroke="#2a1440" stroke-width="2" stroke-linecap="round"/>
+    <path d="M28 15 l -4 2" stroke="#2a1440" stroke-width="2" stroke-linecap="round"/>
+    <circle cx="18" cy="18.5" r="2" fill="#2a1440"/>
+    <circle cx="24.5" cy="18.5" r="2" fill="#2a1440"/>
+    <path d="M17 22.5 q 4 1.5 8 0" stroke="#2a1440" stroke-width="1.5" fill="none" stroke-linecap="round"/>
+  </g>
+</svg>

package/blocks/patrol-enemy/block.json

@@ -0,0 +1,60 @@
+{
+  "name": "patrol-enemy",
+  "description": "An enemy that walks back and forth. Touching it kills; landing on it stomps it.",
+  "tags": [
+    "platformer",
+    "enemy"
+  ],
+  "usage": "--at x,y starts it on the surface whose top is y; it walks patrol.distance px to the right and back.",
+  "entities": [
+    {
+      "id": "{id}",
+      "components": {
+        "transform": {
+          "dx": 0,
+          "dy": -13
+        },
+        "body": {
+          "type": "kinematic",
+          "width": 32,
+          "height": 26,
+          "sensor": true
+        },
+        "sprite": {
+          "color": "#c77dff",
+          "image": "assets/slime.svg",
+          "frameWidth": 32,
+          "idle": "0",
+          "run": "0-1",
+          "fps": 4,
+          "layer": 2
+        },
+        "patrol": {
+          "axis": "x",
+          "distance": 160,
+          "speed": 60
+        },
+        "hazard": {
+          "stompable": true,
+          "score": 1
+        }
+      }
+    }
+  ],
+  "files": [
+    "assets/slime.svg"
+  ],
+  "effects": {
+    "stomp": {
+      "sound": "hit",
+      "shake": 5,
+      "particles": {
+        "count": 18,
+        "color": "#c77dff",
+        "speed": 180,
+        "life": 0.5,
+        "size": 4
+      }
+    }
+  }
+}

package/blocks/patrol-enemy/demo.json

@@ -0,0 +1,22 @@
+{
+  "at": [
+    500,
+    500
+  ],
+  "tests": [
+    {
+      "name": "walks along its patrol",
+      "duration": "2s",
+      "assert": [
+        "patrol-enemy.x > 600"
+      ]
+    },
+    {
+      "name": "kills the player on contact",
+      "inputs": "right:3s",
+      "assert": [
+        "deaths >= 1"
+      ]
+    }
+  ]
+}

package/blocks/spikes/assets/spikes.svg

@@ -0,0 +1,8 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="20" height="16" viewBox="0 0 20 16">
+  <!-- Tile: repeats horizontally across the hazard. -->
+  <path d="M0 16 L 5 1 L 10 16 Z" fill="#e4e8f2"/>
+  <path d="M5 1 L 10 16 L 6.5 16 Z" fill="#a9b1c7"/>
+  <path d="M10 16 L 15 1 L 20 16 Z" fill="#e4e8f2"/>
+  <path d="M15 1 L 20 16 L 16.5 16 Z" fill="#a9b1c7"/>
+  <rect x="0" y="13" width="20" height="3" fill="#ff5d73"/>
+</svg>

package/blocks/spikes/block.json

@@ -0,0 +1,49 @@
+{
+  "name": "spikes",
+  "description": "A row of spikes. Touching them kills the player.",
+  "tags": [
+    "platformer",
+    "hazard"
+  ],
+  "usage": "--at x,y sets them on the surface whose top is y. Widen body.width in multiples of 20 so the art tiles cleanly.",
+  "entities": [
+    {
+      "id": "{id}",
+      "components": {
+        "transform": {
+          "dx": 0,
+          "dy": -8
+        },
+        "body": {
+          "type": "static",
+          "width": 80,
+          "height": 16,
+          "sensor": true
+        },
+        "sprite": {
+          "color": "#ff5d73",
+          "image": "assets/spikes.svg",
+          "tile": true,
+          "layer": 1
+        },
+        "hazard": {}
+      }
+    }
+  ],
+  "files": [
+    "assets/spikes.svg"
+  ],
+  "effects": {
+    "die": {
+      "sound": "explosion",
+      "shake": 10,
+      "particles": {
+        "count": 30,
+        "color": "#ff5d73",
+        "speed": 220,
+        "life": 0.7,
+        "size": 4
+      }
+    }
+  }
+}

package/blocks/spikes/demo.json

@@ -0,0 +1,16 @@
+{
+  "at": [
+    400,
+    500
+  ],
+  "tests": [
+    {
+      "name": "kill a player who walks into them",
+      "inputs": "right:2s",
+      "assert": [
+        "deaths == 1",
+        "events.die == 1"
+      ]
+    }
+  ]
+}

package/blocks/teleporter/assets/teleporter.svg

@@ -0,0 +1,14 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="80" height="12" viewBox="0 0 80 12">
+  <!-- Spritesheet: 2 frames of 40x12, a pulsing teleporter pad. -->
+  <g>
+    <rect x="0" y="6" width="40" height="6" rx="2" fill="#2b3150"/>
+    <ellipse cx="20" cy="6" rx="18" ry="4" fill="#4cc9f0"/>
+    <ellipse cx="20" cy="6" rx="11" ry="2.4" fill="#c9f4ff"/>
+  </g>
+  <g transform="translate(40 0)">
+    <rect x="0" y="6" width="40" height="6" rx="2" fill="#2b3150"/>
+    <ellipse cx="20" cy="6" rx="18" ry="4" fill="#3aa6c8"/>
+    <ellipse cx="20" cy="6" rx="14" ry="3" fill="#7fe0ff"/>
+    <ellipse cx="20" cy="6" rx="6" ry="1.4" fill="#ffffff"/>
+  </g>
+</svg>

package/blocks/teleporter/block.json

@@ -0,0 +1,89 @@
+{
+  "name": "teleporter",
+  "description": "Two linked pads. Stepping on one moves the player to the other.",
+  "tags": [
+    "platformer",
+    "movement",
+    "script"
+  ],
+  "usage": "--at x,y puts pad A on the surface whose top is y and pad B 300px to the right. Move B anywhere (even onto a high ledge); each pad's params.target names the other.",
+  "entities": [
+    {
+      "id": "{id}-a",
+      "components": {
+        "transform": {
+          "dx": 0,
+          "dy": -6
+        },
+        "body": {
+          "type": "static",
+          "width": 40,
+          "height": 12,
+          "sensor": true
+        },
+        "sprite": {
+          "color": "#4cc9f0",
+          "image": "assets/teleporter.svg",
+          "frameWidth": 40,
+          "idle": "0-1",
+          "fps": 4,
+          "layer": 1
+        },
+        "script": {
+          "src": "scripts/teleporter.ts",
+          "params": {
+            "target": "{id}-b"
+          }
+        }
+      }
+    },
+    {
+      "id": "{id}-b",
+      "components": {
+        "transform": {
+          "dx": 300,
+          "dy": -6
+        },
+        "body": {
+          "type": "static",
+          "width": 40,
+          "height": 12,
+          "sensor": true
+        },
+        "sprite": {
+          "color": "#4cc9f0",
+          "image": "assets/teleporter.svg",
+          "frameWidth": 40,
+          "idle": "0-1",
+          "fps": 4,
+          "layer": 1
+        },
+        "script": {
+          "src": "scripts/teleporter.ts",
+          "params": {
+            "target": "{id}-a"
+          }
+        }
+      }
+    }
+  ],
+  "files": [
+    "scripts/teleporter.ts",
+    "assets/teleporter.svg"
+  ],
+  "effects": {
+    "teleport": {
+      "sound": "powerup",
+      "particles": {
+        "count": 20,
+        "color": "#4cc9f0",
+        "speed": 120,
+        "direction": -90,
+        "spread": 90,
+        "life": 0.5,
+        "size": 3,
+        "gravity": -60
+      }
+    }
+  }
+}

package/blocks/teleporter/demo.json

@@ -0,0 +1,17 @@
+{
+  "at": [
+    300,
+    500
+  ],
+  "tests": [
+    {
+      "name": "stepping on pad A moves the player to pad B",
+      "inputs": "right:0.9s",
+      "duration": "1.5s",
+      "assert": [
+        "events.teleport == 1",
+        "player.x > 600"
+      ]
+    }
+  ]
+}

package/blocks/teleporter/scripts/teleporter.ts

@@ -0,0 +1,17 @@
+import type { Script } from "@ludra/core";
+
+/** Moves a player who steps on this pad onto the pad named by params.target. */
+export default {
+  touch({ self, world, params }, other) {
+    if (!other.has("platformer") && !other.has("topdown")) return;
+    // Arriving on the other pad touches it too; a short cooldown stops an instant trip back.
+    if (world.time < ((self.state.cooldownUntil as number) ?? 0)) return;
+    const target = world.get(params.target as string);
+    if (!target) return;
+    other.x = target.x;
+    other.y = target.y - target.height / 2 - other.height / 2 - 2;
+    other.vy = 0;
+    target.state.cooldownUntil = world.time + 0.5;
+    world.emit("teleport");
+  },
+} satisfies Script;

package/blocks/time-limit/block.json

@@ -0,0 +1,36 @@
+{
+  "name": "time-limit",
+  "description": "A countdown. When it reaches zero the player dies and the clock restarts.",
+  "tags": [
+    "rules",
+    "script"
+  ],
+  "usage": "No --at needed. Set params.seconds. Its state.left is the time remaining, so tests can check it.",
+  "positioned": false,
+  "entities": [
+    {
+      "id": "{id}",
+      "components": {
+        "transform": {
+          "dx": 0,
+          "dy": 0
+        },
+        "script": {
+          "src": "scripts/time-limit.ts",
+          "params": {
+            "seconds": 30
+          }
+        }
+      }
+    }
+  ],
+  "files": [
+    "scripts/time-limit.ts"
+  ],
+  "effects": {
+    "timeout": {
+      "sound": "explosion",
+      "shake": 8
+    }
+  }
+}

package/blocks/time-limit/demo.json

@@ -0,0 +1,25 @@
+{
+  "at": [
+    0,
+    0
+  ],
+  "tests": [
+    {
+      "name": "counts down",
+      "duration": "1s",
+      "assert": [
+        "time-limit.state.left < 29.1",
+        "time-limit.state.left > 28.9"
+      ]
+    },
+    {
+      "name": "kills the player when time runs out, then restarts",
+      "duration": "31s",
+      "assert": [
+        "deaths == 1",
+        "events.timeout == 1",
+        "time-limit.state.left > 28"
+      ]
+    }
+  ]
+}

package/blocks/time-limit/scripts/time-limit.ts

@@ -0,0 +1,16 @@
+import type { Script } from "@ludra/core";
+
+/** Counts down params.seconds. When time runs out the player dies and the clock restarts. */
+export default {
+  start({ self, params }) {
+    self.state.left = params.seconds as number;
+  },
+  update({ self, world, params, dt }) {
+    self.state.left = Math.max(0, (self.state.left as number) - dt);
+    if (self.state.left === 0) {
+      world.emit("timeout");
+      world.kill(world.player()!);
+      self.state.left = params.seconds as number;
+    }
+  },
+} satisfies Script;

package/blocks/turret/assets/bullet.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="12" height="6" viewBox="0 0 12 6">
+  <!-- A glowing energy bolt. -->
+  <rect x="0" y="0" width="12" height="6" rx="3" fill="#ff5d73"/>
+  <rect x="2" y="1.5" width="8" height="3" rx="1.5" fill="#ffd1d8"/>
+</svg>

package/blocks/turret/assets/turret.svg

@@ -0,0 +1,10 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="32" height="24" viewBox="0 0 32 24">
+  <!-- A squat cannon facing left. Mirror it (or set sprite.flip) for one that fires right. -->
+  <rect x="4" y="14" width="26" height="10" rx="3" fill="#4b5263"/>
+  <rect x="4" y="14" width="26" height="3" rx="1.5" fill="#6b7489"/>
+  <circle cx="18" cy="12" r="8" fill="#8fa3d9"/>
+  <circle cx="18" cy="12" r="5" fill="#c3d0f2"/>
+  <rect x="0" y="8" width="14" height="7" rx="2" fill="#5d6f9e"/>
+  <rect x="0" y="9" width="3" height="5" fill="#2b3150"/>
+  <circle cx="20" cy="11" r="2" fill="#ff5d73"/>
+</svg>