@ludra/cli 0.4.0 → 0.7.0

package/blocks/chasing-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/chasing-enemy/block.json

@@ -0,0 +1,64 @@
+{
+  "name": "chasing-enemy",
+  "description": "An enemy that waits, then runs at the player once they come close. Landing on it stomps it.",
+  "tags": [
+    "platformer",
+    "enemy",
+    "script"
+  ],
+  "usage": "--at x,y puts it on the surface whose top is y. params.range is how close the player must be (px), params.speed how fast it runs. It does not stop at ledges; keep it on a wide floor.",
+  "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": 6,
+          "layer": 2
+        },
+        "hazard": {
+          "stompable": true,
+          "score": 1
+        },
+        "script": {
+          "src": "scripts/chaser.ts",
+          "params": {
+            "speed": 70,
+            "range": 220
+          }
+        }
+      }
+    }
+  ],
+  "files": [
+    "scripts/chaser.ts",
+    "assets/slime.svg"
+  ],
+  "effects": {
+    "stomp": {
+      "sound": "hit",
+      "shake": 5,
+      "particles": {
+        "count": 18,
+        "color": "#c77dff",
+        "speed": 180,
+        "life": 0.5,
+        "size": 4
+      }
+    }
+  }
+}

package/blocks/chasing-enemy/demo.json

@@ -0,0 +1,32 @@
+{
+  "at": [
+    600,
+    500
+  ],
+  "tests": [
+    {
+      "name": "waits while the player is far away",
+      "duration": "1s",
+      "assert": [
+        "chasing-enemy.state.chasing == false",
+        "chasing-enemy.x == 600"
+      ]
+    },
+    {
+      "name": "chases once the player comes within range",
+      "inputs": "right:1.3s",
+      "duration": "1.5s",
+      "assert": [
+        "chasing-enemy.state.chasing == true",
+        "chasing-enemy.x < 600"
+      ]
+    },
+    {
+      "name": "kills the player on contact",
+      "inputs": "right:2.5s",
+      "assert": [
+        "deaths >= 1"
+      ]
+    }
+  ]
+}

package/blocks/chasing-enemy/scripts/chaser.ts

@@ -0,0 +1,19 @@
+import type { Script } from "@ludra/core";
+
+interface Params {
+  /** Run speed in px/s. */
+  speed: number;
+  /** Starts chasing when the player is this close horizontally. */
+  range: number;
+}
+
+/** Waits until the player comes near, then runs toward them. Pair with a stompable hazard. */
+export default {
+  update({ self, world, params }) {
+    const { speed, range } = params as unknown as Params;
+    const player = world.player();
+    const distance = player ? player.x - self.x : Infinity;
+    self.state.chasing = Math.abs(distance) < range;
+    self.vx = self.state.chasing ? Math.sign(distance) * speed : 0;
+  },
+} satisfies Script;

package/blocks/coin-row/assets/coin.svg

@@ -0,0 +1,22 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="80" height="20" viewBox="0 0 80 20">
+  <!-- Spritesheet: 4 frames of 20x20, a spinning coin. -->
+  <g>
+    <circle cx="10" cy="10" r="9" fill="#e0a526"/>
+    <circle cx="10" cy="10" r="7" fill="#ffd166"/>
+    <rect x="8.5" y="5" width="3" height="10" rx="1.5" fill="#e0a526"/>
+    <circle cx="7" cy="6.5" r="1.6" fill="#fff3b0"/>
+  </g>
+  <g transform="translate(20 0)">
+    <ellipse cx="10" cy="10" rx="6.5" ry="9" fill="#e0a526"/>
+    <ellipse cx="10" cy="10" rx="4.8" ry="7" fill="#ffd166"/>
+    <rect x="9" y="5" width="2" height="10" rx="1" fill="#e0a526"/>
+  </g>
+  <g transform="translate(40 0)">
+    <ellipse cx="10" cy="10" rx="2.2" ry="9" fill="#e0a526"/>
+    <rect x="9.3" y="2" width="1.4" height="16" fill="#fff3b0"/>
+  </g>
+  <g transform="translate(60 0)">
+    <ellipse cx="10" cy="10" rx="6.5" ry="9" fill="#e0a526"/>
+    <ellipse cx="10" cy="10" rx="4.8" ry="7" fill="#f2bb3d"/>
+  </g>
+</svg>

package/blocks/coin-row/block.json

@@ -0,0 +1,157 @@
+{
+  "name": "coin-row",
+  "description": "Five spinning coins in a row, 40px apart.",
+  "tags": [
+    "platformer",
+    "collectible"
+  ],
+  "usage": "--at x,y centers the row 40px above (x, y), at head height for a player walking on that surface. Each coin is worth 1 point.",
+  "entities": [
+    {
+      "id": "{id}-1",
+      "components": {
+        "transform": {
+          "dx": -80,
+          "dy": -40
+        },
+        "body": {
+          "type": "static",
+          "width": 20,
+          "height": 20,
+          "sensor": true
+        },
+        "sprite": {
+          "shape": "circle",
+          "color": "#ffd166",
+          "image": "assets/coin.svg",
+          "frameWidth": 20,
+          "idle": "0-3",
+          "layer": 1
+        },
+        "collectible": {
+          "score": 1
+        }
+      }
+    },
+    {
+      "id": "{id}-2",
+      "components": {
+        "transform": {
+          "dx": -40,
+          "dy": -40
+        },
+        "body": {
+          "type": "static",
+          "width": 20,
+          "height": 20,
+          "sensor": true
+        },
+        "sprite": {
+          "shape": "circle",
+          "color": "#ffd166",
+          "image": "assets/coin.svg",
+          "frameWidth": 20,
+          "idle": "0-3",
+          "layer": 1
+        },
+        "collectible": {
+          "score": 1
+        }
+      }
+    },
+    {
+      "id": "{id}-3",
+      "components": {
+        "transform": {
+          "dx": 0,
+          "dy": -40
+        },
+        "body": {
+          "type": "static",
+          "width": 20,
+          "height": 20,
+          "sensor": true
+        },
+        "sprite": {
+          "shape": "circle",
+          "color": "#ffd166",
+          "image": "assets/coin.svg",
+          "frameWidth": 20,
+          "idle": "0-3",
+          "layer": 1
+        },
+        "collectible": {
+          "score": 1
+        }
+      }
+    },
+    {
+      "id": "{id}-4",
+      "components": {
+        "transform": {
+          "dx": 40,
+          "dy": -40
+        },
+        "body": {
+          "type": "static",
+          "width": 20,
+          "height": 20,
+          "sensor": true
+        },
+        "sprite": {
+          "shape": "circle",
+          "color": "#ffd166",
+          "image": "assets/coin.svg",
+          "frameWidth": 20,
+          "idle": "0-3",
+          "layer": 1
+        },
+        "collectible": {
+          "score": 1
+        }
+      }
+    },
+    {
+      "id": "{id}-5",
+      "components": {
+        "transform": {
+          "dx": 80,
+          "dy": -40
+        },
+        "body": {
+          "type": "static",
+          "width": 20,
+          "height": 20,
+          "sensor": true
+        },
+        "sprite": {
+          "shape": "circle",
+          "color": "#ffd166",
+          "image": "assets/coin.svg",
+          "frameWidth": 20,
+          "idle": "0-3",
+          "layer": 1
+        },
+        "collectible": {
+          "score": 1
+        }
+      }
+    }
+  ],
+  "files": [
+    "assets/coin.svg"
+  ],
+  "effects": {
+    "collect": {
+      "sound": "coin",
+      "particles": {
+        "count": 14,
+        "color": "#ffd166",
+        "speed": 140,
+        "life": 0.45,
+        "size": 3,
+        "gravity": 200
+      }
+    }
+  }
+}

package/blocks/coin-row/demo.json

@@ -0,0 +1,15 @@
+{
+  "at": [
+    400,
+    500
+  ],
+  "tests": [
+    {
+      "name": "a player walking along the surface collects all five",
+      "inputs": "right:2.5s",
+      "assert": [
+        "score == 5"
+      ]
+    }
+  ]
+}

package/blocks/falling-platform/assets/falling-platform.svg

@@ -0,0 +1,13 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="100" height="20" viewBox="0 0 100 20">
+  <!-- Old wooden planks with visible cracks: it looks like it won't hold. -->
+  <rect width="100" height="20" rx="3" fill="#a0714b"/>
+  <rect width="100" height="4" rx="2" fill="#c4935f"/>
+  <rect y="16" width="100" height="4" fill="#7a5233"/>
+  <rect x="24" y="4" width="2" height="12" fill="#7a5233"/>
+  <rect x="49" y="4" width="2" height="12" fill="#7a5233"/>
+  <rect x="74" y="4" width="2" height="12" fill="#7a5233"/>
+  <path d="M36 4 l3 5 l-4 3 l3 4" stroke="#3d2716" stroke-width="1.5" fill="none"/>
+  <path d="M62 4 l-2 4 l4 3 l-3 5" stroke="#3d2716" stroke-width="1.5" fill="none"/>
+  <circle cx="6" cy="10" r="1.5" fill="#4b5263"/>
+  <circle cx="94" cy="10" r="1.5" fill="#4b5263"/>
+</svg>

package/blocks/falling-platform/block.json

@@ -0,0 +1,55 @@
+{
+  "name": "falling-platform",
+  "description": "A cracked platform that shakes when stood on, falls after params.delay seconds, then comes back after params.respawn seconds.",
+  "tags": [
+    "platformer",
+    "movement",
+    "script"
+  ],
+  "usage": "--at x,y is the platform's center. Its state.phase is idle, shaking, falling or gone, so tests can check it.",
+  "entities": [
+    {
+      "id": "{id}",
+      "components": {
+        "transform": {
+          "dx": 0,
+          "dy": 0
+        },
+        "body": {
+          "type": "static",
+          "width": 100,
+          "height": 20
+        },
+        "sprite": {
+          "color": "#a0714b",
+          "image": "assets/falling-platform.svg"
+        },
+        "script": {
+          "src": "scripts/falling-platform.ts",
+          "params": {
+            "delay": 0.5,
+            "respawn": 3
+          }
+        }
+      }
+    }
+  ],
+  "files": [
+    "scripts/falling-platform.ts",
+    "assets/falling-platform.svg"
+  ],
+  "effects": {
+    "platform-crack": {
+      "sound": "thud",
+      "particles": {
+        "count": 8,
+        "color": "#a0714b",
+        "speed": 60,
+        "direction": 90,
+        "spread": 120,
+        "life": 0.5,
+        "size": 3
+      }
+    }
+  }
+}

package/blocks/falling-platform/demo.json

@@ -0,0 +1,24 @@
+{
+  "at": [
+    400,
+    400
+  ],
+  "tests": [
+    {
+      "name": "shakes, falls, and comes back",
+      "playerAt": [
+        400,
+        372
+      ],
+      "duration": "5s",
+      "assert": [
+        "falling-platform.state.phase == \"shaking\" at 0.3s",
+        "falling-platform.state.phase == \"falling\" at 0.8s",
+        "player.grounded == true at 2s",
+        "player.y > 450 at 2s",
+        "falling-platform.state.phase == \"idle\" at 4.8s",
+        "falling-platform.y == 400 at 4.8s"
+      ]
+    }
+  ]
+}

package/blocks/falling-platform/scripts/falling-platform.ts

@@ -0,0 +1,56 @@
+import type { Script } from "@ludra/core";
+
+const GRAVITY = 1800;
+
+/**
+ * idle → (a player stands on it) → shaking for params.delay s → falling →
+ * gone (below the world) for params.respawn s → back to idle at its start.
+ */
+export default {
+  start({ self }) {
+    self.state.phase = "idle";
+    self.state.homeX = self.x;
+    self.state.homeY = self.y;
+  },
+  update({ self, world, params, dt }) {
+    const homeX = self.state.homeX as number;
+    const homeY = self.state.homeY as number;
+    switch (self.state.phase) {
+      case "idle": {
+        const player = world.player();
+        const standing = player && player.grounded && player.y < self.y && self.touches(player);
+        if (standing) {
+          self.state.phase = "shaking";
+          self.state.timer = params.delay as number;
+          world.emit("platform-crack");
+        }
+        break;
+      }
+      case "shaking":
+        self.state.timer = (self.state.timer as number) - dt;
+        self.x = homeX + (world.random() - 0.5) * 3;
+        if ((self.state.timer as number) <= 0) {
+          self.x = homeX;
+          self.state.phase = "falling";
+          self.state.speed = 0;
+        }
+        break;
+      case "falling":
+        self.state.speed = (self.state.speed as number) + GRAVITY * dt;
+        self.y += (self.state.speed as number) * dt;
+        if (self.y > world.height + 200) {
+          self.state.phase = "gone";
+          self.state.timer = params.respawn as number;
+        }
+        break;
+      case "gone":
+        self.state.timer = (self.state.timer as number) - dt;
+        if ((self.state.timer as number) <= 0) {
+          self.x = homeX;
+          self.y = homeY;
+          self.state.phase = "idle";
+        }
+        break;
+    }
+  },
+} satisfies Script;

package/blocks/jump-pad/assets/jump-pad.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="44" height="14" viewBox="0 0 44 14">
+  <!-- A springy jump pad. -->
+  <rect x="2" y="10" width="40" height="4" rx="1" fill="#4b5263"/>
+  <path d="M8 10 l4 -4 l4 4 l4 -4 l4 4 l4 -4 l4 4 l4 -4" stroke="#cfd8ff" stroke-width="2" fill="none"/>
+  <rect x="0" y="0" width="44" height="4" rx="2" fill="#ff7eb6"/>
+</svg>

package/blocks/jump-pad/block.json

@@ -0,0 +1,56 @@
+{
+  "name": "jump-pad",
+  "description": "A pad that launches players straight up when they step on it.",
+  "tags": [
+    "platformer",
+    "movement",
+    "script"
+  ],
+  "usage": "--at x,y sets the pad on the surface whose top is y. Launch height is about power² / (2 · gravity): power 900 gives ~225px with the default gravity 1800.",
+  "entities": [
+    {
+      "id": "{id}",
+      "components": {
+        "transform": {
+          "dx": 0,
+          "dy": -7
+        },
+        "body": {
+          "type": "static",
+          "width": 44,
+          "height": 14,
+          "sensor": true
+        },
+        "sprite": {
+          "color": "#ff7eb6",
+          "image": "assets/jump-pad.svg",
+          "layer": 1
+        },
+        "script": {
+          "src": "scripts/jump-pad.ts",
+          "params": {
+            "power": 900
+          }
+        }
+      }
+    }
+  ],
+  "files": [
+    "scripts/jump-pad.ts",
+    "assets/jump-pad.svg"
+  ],
+  "effects": {
+    "boing": {
+      "sound": "jump",
+      "particles": {
+        "count": 12,
+        "color": "#ff7eb6",
+        "speed": 160,
+        "direction": -90,
+        "spread": 70,
+        "life": 0.4,
+        "size": 3
+      }
+    }
+  }
+}

package/blocks/jump-pad/demo.json

@@ -0,0 +1,17 @@
+{
+  "at": [
+    300,
+    500
+  ],
+  "tests": [
+    {
+      "name": "walking onto the pad launches the player high",
+      "inputs": "right:1s",
+      "duration": "1.6s",
+      "assert": [
+        "events.boing >= 1",
+        "player.y < 320 at 1.2s"
+      ]
+    }
+  ]
+}

package/blocks/jump-pad/scripts/jump-pad.ts

@@ -0,0 +1,10 @@
+import type { Script } from "@ludra/core";
+
+/** Launches whatever lands on it straight up. params.power: launch speed in px/s. */
+export default {
+  touch({ world, params }, other) {
+    if (!other.has("platformer")) return;
+    other.vy = -(params.power as number);
+    world.emit("boing");
+  },
+} satisfies Script;

package/blocks/key-and-door/assets/door.svg

@@ -0,0 +1,12 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="28" height="120" viewBox="0 0 28 120">
+  <!-- A locked wooden door with iron bands and a keyhole. -->
+  <rect width="28" height="120" rx="4" fill="#7a4e2d"/>
+  <rect x="3" width="2" height="120" fill="#5e3a20"/>
+  <rect x="13" width="2" height="120" fill="#5e3a20"/>
+  <rect x="23" width="2" height="120" fill="#5e3a20"/>
+  <rect y="16" width="28" height="7" fill="#4b5263"/>
+  <rect y="97" width="28" height="7" fill="#4b5263"/>
+  <rect x="7" y="52" width="14" height="18" rx="3" fill="#f2c14e"/>
+  <circle cx="14" cy="59" r="2.6" fill="#2b1a0e"/>
+  <rect x="13" y="60" width="2" height="6" fill="#2b1a0e"/>
+</svg>

package/blocks/key-and-door/assets/key.svg

@@ -0,0 +1,9 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24">
+  <!-- A gold key. -->
+  <circle cx="8" cy="12" r="6" fill="#e0a526"/>
+  <circle cx="8" cy="12" r="2.6" fill="#1b2140"/>
+  <rect x="12" y="10.5" width="11" height="3" rx="1" fill="#e0a526"/>
+  <rect x="18" y="13" width="2.5" height="4" fill="#e0a526"/>
+  <rect x="21" y="13" width="2" height="3" fill="#e0a526"/>
+  <circle cx="6" cy="9.5" r="1.4" fill="#fff3b0"/>
+</svg>