@ludra/cli 0.0.0-stage → 0.4.0

package/templates/platformer/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/templates/platformer/assets/platform.svg

@@ -0,0 +1,9 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 20 20">
+  <!-- Tile: stone brick for ledges and steps. -->
+  <rect width="20" height="20" fill="#56658f"/>
+  <rect width="20" height="3" fill="#7a8ab8"/>
+  <rect y="17" width="20" height="3" fill="#434f72"/>
+  <rect x="9" y="3" width="2" height="14" fill="#434f72"/>
+  <rect x="1" y="5" width="3" height="2" fill="#6b7aa6"/>
+  <rect x="13" y="9" width="4" height="2" fill="#6b7aa6"/>
+</svg>

package/templates/platformer/assets/player.svg

@@ -0,0 +1,65 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="140" height="36" viewBox="0 0 140 36">
+  <!-- Spritesheet: 5 frames of 28x36, facing right. 0 idle, 1-2 run, 3 jump, 4 fall. -->
+  <defs>
+    <g id="eyes">
+      <ellipse cx="15" cy="15" rx="3.2" ry="3.8" fill="#ffffff"/>
+      <ellipse cx="21.5" cy="15" rx="3.2" ry="3.8" fill="#ffffff"/>
+      <circle cx="16.3" cy="15.6" r="1.7" fill="#1d2333"/>
+      <circle cx="22.8" cy="15.6" r="1.7" fill="#1d2333"/>
+    </g>
+    <path id="leaf" d="M14 7 q 2 -6 8 -5 q -2 5 -8 5 z" fill="#4cc9a0"/>
+  </defs>
+
+  <!-- 0: idle -->
+  <g>
+    <rect x="7" y="29" width="6" height="6" rx="2" fill="#3f9e5c"/>
+    <rect x="16" y="29" width="6" height="6" rx="2" fill="#3f9e5c"/>
+    <rect x="3" y="7" width="22" height="24" rx="8" fill="#7cf29c"/>
+    <rect x="3" y="21" width="22" height="10" rx="5" fill="#62d886"/>
+    <use href="#leaf"/>
+    <use href="#eyes"/>
+  </g>
+
+  <!-- 1: run, legs apart -->
+  <g transform="translate(28 0)">
+    <rect x="3" y="28" width="6" height="6" rx="2" fill="#3f9e5c"/>
+    <rect x="19" y="29" width="6" height="6" rx="2" fill="#3f9e5c"/>
+    <rect x="3" y="6" width="22" height="24" rx="8" fill="#7cf29c"/>
+    <rect x="3" y="20" width="22" height="10" rx="5" fill="#62d886"/>
+    <use href="#leaf" transform="translate(0 -1)"/>
+    <use href="#eyes" transform="translate(0 -1)"/>
+  </g>
+
+  <!-- 2: run, legs together -->
+  <g transform="translate(56 0)">
+    <rect x="10" y="29" width="6" height="6" rx="2" fill="#3f9e5c"/>
+    <rect x="14" y="28" width="6" height="6" rx="2" fill="#3f9e5c"/>
+    <rect x="3" y="7" width="22" height="24" rx="8" fill="#7cf29c"/>
+    <rect x="3" y="21" width="22" height="10" rx="5" fill="#62d886"/>
+    <use href="#leaf"/>
+    <use href="#eyes"/>
+  </g>
+
+  <!-- 3: jump, stretched -->
+  <g transform="translate(84 0)">
+    <rect x="8" y="28" width="5" height="7" rx="2" fill="#3f9e5c"/>
+    <rect x="15" y="28" width="5" height="7" rx="2" fill="#3f9e5c"/>
+    <rect x="4" y="3" width="20" height="27" rx="8" fill="#7cf29c"/>
+    <rect x="4" y="19" width="20" height="11" rx="5" fill="#62d886"/>
+    <use href="#leaf" transform="translate(0 -4)"/>
+    <use href="#eyes" transform="translate(-0.5 -3)"/>
+  </g>
+
+  <!-- 4: fall, squashed, looking down -->
+  <g transform="translate(112 0)">
+    <rect x="4" y="29" width="7" height="6" rx="2" fill="#3f9e5c"/>
+    <rect x="17" y="29" width="7" height="6" rx="2" fill="#3f9e5c"/>
+    <rect x="1" y="10" width="26" height="21" rx="8" fill="#7cf29c"/>
+    <rect x="1" y="22" width="26" height="9" rx="4.5" fill="#62d886"/>
+    <use href="#leaf" transform="translate(0 3)"/>
+    <ellipse cx="15" cy="18" rx="3.2" ry="3.8" fill="#ffffff"/>
+    <ellipse cx="21.5" cy="18" rx="3.2" ry="3.8" fill="#ffffff"/>
+    <circle cx="16" cy="20" r="1.7" fill="#1d2333"/>
+    <circle cx="22.5" cy="20" r="1.7" fill="#1d2333"/>
+  </g>
+</svg>

package/templates/platformer/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/templates/platformer/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/templates/platformer/ludra.json

@@ -0,0 +1,5 @@
+{
+  "name": "{{name}}",
+  "entry": "scenes/main.scene.json",
+  "window": { "width": 960, "height": 540 }
+}

package/templates/platformer/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "{{name}}",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "ludra dev",
+    "check": "ludra check",
+    "test": "ludra test"
+  },
+  "devDependencies": {
+    "@ludra/cli": "^0.4.0"
+  }
+}

package/templates/platformer/scenes/main.scene.json

@@ -0,0 +1,154 @@
+{
+  "name": "Level 1",
+  "world": { "width": 1920, "height": 540, "gravity": 1800, "background": "#1b2140" },
+  "effects": {
+    "jump": { "sound": "jump", "particles": { "count": 6, "color": "#cfd8ff", "speed": 60, "direction": 90, "spread": 150, "life": 0.25, "size": 3, "gravity": 0 } },
+    "land": { "sound": "thud", "particles": { "count": 5, "color": "#cfd8ff", "speed": 50, "direction": -90, "spread": 160, "life": 0.2, "size": 2, "gravity": 300 } },
+    "collect": { "sound": "coin", "particles": { "count": 14, "color": "#ffd166", "speed": 140, "life": 0.45, "size": 3, "gravity": 200 } },
+    "stomp": { "sound": "hit", "shake": 5, "particles": { "count": 18, "color": "#c77dff", "speed": 180, "life": 0.5, "size": 4 } },
+    "die": { "sound": "explosion", "shake": 10, "particles": { "count": 30, "color": "#ff5d73", "speed": 220, "life": 0.7, "size": 4 } },
+    "win": { "sound": "powerup", "shake": 3, "particles": { "count": 60, "color": "#4cc9f0", "speed": 260, "life": 1.2, "size": 4, "gravity": 150 } }
+  },
+  "entities": [
+    {
+      "id": "player",
+      "components": {
+        "transform": { "x": 80, "y": 482 },
+        "body": { "type": "dynamic", "width": 28, "height": 36 },
+        "sprite": {
+          "color": "#7cf29c",
+          "image": "assets/player.svg",
+          "frameWidth": 28,
+          "frameHeight": 36,
+          "idle": "0",
+          "run": "1-2",
+          "jump": "3",
+          "fall": "4",
+          "fps": 10,
+          "layer": 3
+        },
+        "platformer": { "speed": 240, "jumpSpeed": 680 },
+        "camera": {}
+      }
+    },
+    {
+      "id": "ground-start",
+      "components": {
+        "transform": { "x": 380, "y": 520 },
+        "body": { "type": "static", "width": 760, "height": 40 },
+        "sprite": { "color": "#3b4766", "image": "assets/ground.svg", "tile": true }
+      }
+    },
+    {
+      "id": "ground-end",
+      "components": {
+        "transform": { "x": 1450, "y": 520 },
+        "body": { "type": "static", "width": 940, "height": 40 },
+        "sprite": { "color": "#3b4766", "image": "assets/ground.svg", "tile": true }
+      }
+    },
+    {
+      "id": "wall-left",
+      "components": {
+        "transform": { "x": -10, "y": 270 },
+        "body": { "type": "static", "width": 20, "height": 540 }
+      }
+    },
+    {
+      "id": "wall-right",
+      "components": {
+        "transform": { "x": 1930, "y": 270 },
+        "body": { "type": "static", "width": 20, "height": 540 }
+      }
+    },
+    {
+      "id": "ledge",
+      "components": {
+        "transform": { "x": 300, "y": 410 },
+        "body": { "type": "static", "width": 160, "height": 20 },
+        "sprite": { "color": "#56658f", "image": "assets/platform.svg", "tile": true }
+      }
+    },
+    {
+      "id": "coin-1",
+      "components": {
+        "transform": { "x": 300, "y": 370 },
+        "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": "spikes",
+      "components": {
+        "transform": { "x": 560, "y": 492 },
+        "body": { "type": "static", "width": 80, "height": 16, "sensor": true },
+        "sprite": { "color": "#ff5d73", "image": "assets/spikes.svg", "tile": true, "layer": 1 },
+        "hazard": {}
+      }
+    },
+    {
+      "id": "lift",
+      "components": {
+        "transform": { "x": 800, "y": 440 },
+        "body": { "type": "kinematic", "width": 120, "height": 20 },
+        "sprite": { "color": "#8fa3d9", "image": "assets/lift.svg", "tile": true },
+        "patrol": { "axis": "x", "distance": 140, "speed": 90 }
+      }
+    },
+    {
+      "id": "coin-2",
+      "components": {
+        "transform": { "x": 870, "y": 390 },
+        "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": "slime",
+      "components": {
+        "transform": { "x": 1150, "y": 487 },
+        "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": 200, "speed": 70 },
+        "hazard": { "stompable": true, "score": 1 }
+      }
+    },
+    {
+      "id": "step-1",
+      "components": {
+        "transform": { "x": 1500, "y": 410 },
+        "body": { "type": "static", "width": 140, "height": 20 },
+        "sprite": { "color": "#56658f", "image": "assets/platform.svg", "tile": true }
+      }
+    },
+    {
+      "id": "step-2",
+      "components": {
+        "transform": { "x": 1680, "y": 330 },
+        "body": { "type": "static", "width": 140, "height": 20 },
+        "sprite": { "color": "#56658f", "image": "assets/platform.svg", "tile": true }
+      }
+    },
+    {
+      "id": "coin-3",
+      "components": {
+        "transform": { "x": 1680, "y": 290 },
+        "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": "flag",
+      "components": {
+        "transform": { "x": 1860, "y": 460 },
+        "body": { "type": "static", "width": 24, "height": 80, "sensor": true },
+        "sprite": { "color": "#4cc9f0", "image": "assets/flag.svg", "frameWidth": 24, "idle": "0-1", "fps": 3, "flip": false, "layer": 1 },
+        "emitter": { "rate": 6, "color": "#fff3b0", "speed": 30, "spread": 70, "life": 1.2, "size": 3, "gravity": -20 },
+        "goal": { "requireScore": 4 }
+      }
+    }
+  ]
+}

package/templates/platformer/tests/gameplay.test.json

@@ -0,0 +1,36 @@
+{
+  "tests": [
+    {
+      "name": "player rests on the ground",
+      "duration": "1s",
+      "assert": ["player.grounded == true", "player.y == 482", "deaths == 0"]
+    },
+    {
+      "name": "player runs right",
+      "inputs": "right:1s",
+      "assert": ["player.x > 300 at 1s", "player.grounded == true at 1s"]
+    },
+    {
+      "name": "jumping leaves the ground and lands again",
+      "inputs": "wait:0.2s, jump:0.4s",
+      "assert": ["events.jump == 1", "player.y < 400 at 0.5s", "player.grounded == true at end"]
+    },
+    {
+      "name": "spikes kill the player, who respawns at the start",
+      "inputs": "right:1.85s",
+      "duration": "2s",
+      "assert": ["deaths == 1", "events.die == 1", "player.x < 200"]
+    },
+    {
+      "name": "the lift carries the player over the pit",
+      "inputs": "right:0.3s, right+jump:0.45s, right:0.85s, right+jump:0.45s, right:0.35s, right+jump:0.45s, right:0.18s",
+      "duration": "4s",
+      "assert": ["coin-2.exists == false", "player.grounded == true", "player.x > 860", "deaths == 0"]
+    },
+    {
+      "name": "the level can be completed without dying",
+      "inputs": "right:0.3s, right+jump:0.45s, right:0.85s, right+jump:0.45s, right:0.35s, right+jump:0.45s, right:0.18s, wait:1.0s, right+jump:0.45s, right:0.3s, wait:0.6s, right+jump:0.45s, right:0.1s, wait:0.6s, right:0.7s, right+jump:0.45s, right:0.2s, right+jump:0.45s, right:1.5s",
+      "assert": ["won == true", "deaths == 0", "score == 4", "events.stomp == 1", "slime.exists == false"]
+    }
+  ]
+}