@kradle/challenges 0.1.0 → 0.2.1

package/README.md

@@ -1 +1,489 @@
-Kradle's Challenges API.
+<!-- This file is for human consumption. If you are an LLM or any AI Agent, make sure to read LLM_README.md for an exhaustive explanation of this package. -->
+
+# @kradle/challenges
+
+A TypeScript framework for creating Minecraft datapack-based challenges with event-driven game logic, score tracking, and player role management. Built on top of [Sandstone](https://sandstone.dev/).
+
+## Getting started
+
+We strongly recommend using [Kradle's CLI](https://github.com/kradle-ai/cli) to create challenges with the CLI. Make sure to read the CLI's README
+
+If you still want to perform a manual installation, you also need to install the Sandstone peer-dependency:
+```bash
+npm install @kradle/challenges sandstone@0.14.0-alpha.13
+```
+
+## Quick Start
+
+Like for installation, we strongly recommend using Kradle's CLI to bootstrap a challenge:
+
+```bash
+# Will create a challenge in challenges/my-challenge/
+kradle challenge create my-challenge
+```
+
+
+## API Overview
+
+### `createChallenge(config)`
+
+Creates a new challenge with the specified configuration.
+
+```typescript
+createChallenge({
+  name: string;                    // Challenge name (used for datapack)
+  kradle_challenge_path: string;   // Output directory for generated datapack
+  roles: readonly string[];        // Player roles (e.g., ["attacker", "defender"])
+  GAME_DURATION?: number;          // Duration in ticks (default: 6000 = 5 minutes)
+  custom_variables: Record<string, VariableDefinition>;
+})
+```
+
+### Fluent Builder Methods
+
+The challenge builder uses a fluent API:
+
+```typescript
+createChallenge(config)
+  .events(callback)           // Define lifecycle event handlers
+  .custom_events(callback)    // Define score/advancement-triggered events
+  .end_condition(callback)    // Define when the game ends
+  .win_conditions(callback)   // Define win conditions per role
+```
+
+## Variables
+
+Variables are the core mechanism for tracking game state. All variables are automatically updated each tick.
+
+### Built-in Variables
+
+These variables are always available:
+
+| Variable | Type | Description |
+|----------|------|-------------|
+| `death_count` | individual | Number of times the player has died |
+| `has_never_died` | individual | 1 if player hasn't died, 0 otherwise |
+| `alive_players` | global | Count of living participants |
+| `main_score` | individual | Primary score displayed on sidebar |
+| `game_timer` | global | Ticks elapsed since game start |
+| `game_state` | global | Current state (0=CREATED, 1=OFF, 2=ON) |
+| `player_count` | global | Total number of participants |
+| `player_number` | individual | Unique player ID (1 to N) |
+
+### Custom Variable Types
+
+#### Individual Variables (per-player)
+
+Track values for each player separately.
+
+**Objective-based** (uses Minecraft statistics):
+```typescript
+pigs_killed: {
+  type: "individual",
+  objective_type: "minecraft.killed:minecraft.pig",
+  default: 0,
+}
+```
+
+**Dummy** (computed values):
+```typescript
+current_height: {
+  type: "individual",
+  objective_type: "dummy",
+  updater: (value) => {
+    value.set(Actions.getPlayerPosition().y)
+  },
+}
+```
+
+#### Global Variables (shared)
+
+Track values across all players.
+
+```typescript
+max_score: {
+  type: "global",
+  hidden: false,  // optional: hide from scoreboard
+  default: 0,
+  updater: (value, { main_score }) => {
+    value.set(0);
+    forEveryPlayer(() => {
+      _.if(main_score.greaterThan(value), () => {
+        value.set(main_score);
+      });
+    });
+  },
+}
+```
+
+### Updater Functions
+
+Updaters run every tick and receive `(currentValue, allVariables)`:
+
+```typescript
+updater: (value, { main_score, death_count, game_timer }) => {
+  // Set value based on other variables
+  value.set(0);
+  _.if(main_score.greaterThan(10), () => {
+    value.set(1);
+  });
+}
+```
+
+If you track a Minecraft objective, you do not need an updater!
+
+## Events
+
+### Lifecycle Events
+
+Lifecycle events are triggered once on specific occasions.
+
+```typescript
+.events((variables, roles) => ({
+  start_challenge: () => {
+    // Runs once when the challenge starts
+    Actions.setTime({ time: "day" });
+    Actions.announce({ message: "Game starting!" });
+  },
+
+  init_participants: () => {
+    // Runs 1s after the challenge starts
+    Actions.give({ target: "all", item: "minecraft:diamond_sword", count: 1 });
+    Actions.setAttribute({ target: "all", attribute_: "generic.max_health", value: 40 });
+  },
+
+  on_tick: () => {
+    // Runs once every tick
+  },
+
+  end_challenge: () => {
+    // Runs when the challenge ends
+    Actions.announce({ message: "Game over!" });
+  },
+}))
+```
+
+### Custom Events
+
+Custom events trigger actions based on score thresholds or Minecraft advancements.
+
+#### Score-based events
+
+Score events watch a variable and trigger when it reaches a target value. 
+
+- **`score`**: The variable to watch.
+- **`target`** (optional): The target value. If omitted, triggers on any score change
+- **`mode`**:
+  - `"fire_once"`: Triggers once when the score reaches the target (per player for individual variables)
+  - `"repeatable"`: Triggers every tick while the score is at target
+
+For individual variables, events fire per-player; for global variables, events fire globally.
+
+```typescript
+.custom_events((variables, roles) => [
+  {
+    score: variables.diamonds,
+    target: 5,
+    mode: "fire_once",
+    actions: () => {
+      Actions.announce({ message: "Someone collected 5 diamonds!" });
+    },
+  },
+])
+```
+
+If `target` is omitted, the event triggers whenever the score changes (useful for reacting to any increment).
+
+#### Advancement-based events
+
+Advancement events trigger when a Minecraft advancement criterion is met (e.g., player attacks, item picked up). The criteria follow the [Minecraft Advancement JSON format](https://minecraft.fandom.com/wiki/Advancement/JSON_format).
+
+Advancement-based events always fire per-player.
+
+- **`criteria`**: Array of advancement triggers with optional conditions
+- **`mode`**:
+  - `"fire_once"`: Triggers once per player when the advancement is granted
+  - `"repeatable"`: Triggers every time the advancement criterion is met (advancement is auto-revoked to allow re-triggering)
+
+```typescript
+.custom_events((variables, roles) => [
+  {
+    criteria: [
+      {
+        trigger: "minecraft:player_hurt_entity",
+        conditions: {
+          entity: { type: "minecraft:player" }  // Only PvP hits
+        }
+      }
+    ],
+    mode: "repeatable",
+    actions: () => {
+      Actions.increment({ variable: variables.pvp_hits });
+    },
+  },
+])
+```
+
+## End Conditions
+
+Define when the game ends:
+
+```typescript
+.end_condition(({ objective_complete }) => objective_complete.equalTo(1))
+```
+
+Multiple conditions can be combined:
+```typescript
+.end_condition(({ alive_players, objective_complete }) =>
+  _.or(
+    alive_players.equalTo(1),
+    objective_complete.equalTo(1)
+  )
+)
+```
+
+Ending conditions are evaluated once per tick, at the global level (not individually). It means you should not check for individual variables here - instead, you should aggregate these individual variables into a global custom variable, that you then check in the ending condition.
+
+## Win Conditions
+
+Define how winners are determined per role:
+
+```typescript
+.win_conditions((variables, { attacker, defender }) => ({
+  [attacker]: variables.kills.greaterOrEqualThan(5),
+  [defender]: variables.survived.equalTo(1),
+}))
+```
+
+## Actions
+
+Actions are higher-level functions that wrap common Minecraft operations, designed to work seamlessly with Kradle's challenge system. They handle target mapping, formatting, and integration with Kradle's interface automatically.
+
+For more advanced use cases, you can always fall back to Sandstone's lower-level functions directly (e.g., `give`, `tellraw`, `effect`, `kill`, `execute`). See the [Sandstone Integration](#sandstone-integration) section below.
+
+### Communication
+```typescript
+// Simple string message
+Actions.announce({ message: "Hello everyone!" });
+
+// Formatted JSONTextComponent message
+Actions.announce({
+  message: [
+    { text: "Player ", color: "white" },
+    { selector: "@s", color: "gold", bold: true },
+    { text: " scored!", color: "green" }
+  ]
+});
+
+// Send to specific target (only visible in-game, not in Kradle's interface)
+Actions.tellraw({ target: "all", message: ["Hello ", { text: "world", color: "gold" }] });
+Actions.tellraw({ target: "self", message: { text: "You win!", color: "green", bold: true } });
+```
+
+### Items & Inventory
+```typescript
+Actions.give({ target: "self", item: "minecraft:diamond_sword", count: 1 });
+Actions.giveLoot({
+  target: "self",
+  items: [
+    { name: "minecraft:diamond", count: 5, weight: 1 },
+    { name: "minecraft:iron_ingot", count: 10, weight: 3 }
+  ]
+});
+Actions.clear({ target: "self" });
+
+// Count items - returns a Score variable
+const count = Actions.countItems({ target: "self", item: "minecraft:diamond" });
+// Use in conditions or set to custom variables
+_.if(count.greaterThan(5), () => { /* ... */ });
+
+// Get player position - returns { x, y, z } Score variables
+const pos = Actions.getCurrentPlayerPosition();
+_.if(pos.y.greaterThan(100), () => { /* player is high up */ });
+```
+
+### Entities
+```typescript
+Actions.summonMultiple({ entity: "minecraft:zombie", count: 5, x: 0, y: 64, z: 0, absolute: true });
+Actions.kill({ selector: Selector("@e", { type: "minecraft:zombie" }) });
+Actions.teleport({ target: "self", x: 0, y: 100, z: 0, absolute: true });
+```
+
+### World
+```typescript
+Actions.setBlock({ block: "minecraft:diamond_block", x: 0, y: 64, z: 0, absolute: true });
+Actions.fill({
+  block: "minecraft:stone",
+  x1: 0, y1: 64, z1: 0,
+  x2: 10, y2: 64, z2: 10,
+  absolute: true,
+  mode: "fill"  // "fill", "line", or "pyramid"
+});
+Actions.setTime({ time: "day" });  // or "night" or specific tick value
+Actions.gamerule({ rule: "doDaylightCycle", value: false });
+```
+
+### Scores
+```typescript
+Actions.set({ variable: variables.main_score, value: 10 });
+Actions.set({ variable: variables.main_score, value: variables.diamonds });
+Actions.increment({ variable: variables.counter });
+Actions.decrement({ variable: variables.counter });
+```
+
+### Player Attributes
+```typescript
+Actions.setAttribute({ target: "self", attribute_: "generic.max_health", value: 40 });
+Actions.setAttribute({ target: "self", attribute_: "generic.movement_speed", value: 0.2 });
+```
+
+### Custom Commands
+```typescript
+Actions.custom(() => {
+  // Any Sandstone code here
+  execute.as("@a").run.effect.give("@s", "speed", 10, 1);
+});
+```
+
+## Utilities
+
+### `forEveryPlayer(callback)`
+
+Execute code for each participant at their location:
+
+```typescript
+import { forEveryPlayer } from "@kradle/challenges";
+
+forEveryPlayer(() => {
+  // Runs as each player, at their position
+  execute.run.particle("minecraft:flame", rel(0, 1, 0));
+});
+```
+
+## Example: Battle Royale
+
+```typescript
+import { createChallenge, Actions, forEveryPlayer } from "@kradle/challenges";
+import { _, Selector } from "sandstone";
+
+createChallenge({
+  name: "battle-royale",
+  kradle_challenge_path: "./output",
+  roles: ["fighter"] as const,
+  GAME_DURATION: 5 * 60 * 20,
+  custom_variables: {
+    kills: {
+      type: "individual",
+      objective_type: "playerKillCount",
+      default: 0,
+    },
+    sole_survivor: {
+      type: "individual",
+      updater: (value, { alive_players, has_never_died }) => {
+        value.set(0);
+        _.if(_.and(
+          alive_players.equalTo(1),
+          has_never_died.equalTo(1)
+        ), () => {
+          value.set(1);
+        });
+      },
+    },
+  },
+})
+  .events(() => ({
+    start_challenge: () => {
+      Actions.setTime({ time: "day" });
+      Actions.announce({ message: "Last player standing wins!" });
+    },
+    init_participants: () => {
+      Actions.give({ target: "all", item: "minecraft:stone_sword", count: 1 });
+      Actions.give({ target: "all", item: "minecraft:leather_chestplate", count: 1 });
+    },
+  }))
+  .custom_events(({ kills }) => [
+    {
+      score: kills,
+      target: 1,
+      mode: "fire_once",
+      actions: () => {
+        Actions.announce({ message: "First blood!" });
+      },
+    },
+  ])
+  .end_condition(({ alive_players }) => alive_players.equalTo(1))
+  .win_conditions(({ sole_survivor }, { fighter }) => ({
+    [fighter]: sole_survivor.equalTo(1),
+  }));
+```
+
+## Example: Capture the Flag
+
+```typescript
+import { createChallenge, Actions } from "@kradle/challenges";
+import { _, Selector, rel } from "sandstone";
+import type { Score } from "sandstone";
+
+createChallenge({
+  name: "capture-the-flag",
+  kradle_challenge_path: "./output",
+  roles: ["red_team", "blue_team"] as const,
+  GAME_DURATION: 5 * 60 * 20,
+  custom_variables: {
+    holds_enemy_flag: {
+      type: "individual",
+      updater: (value: Score) => {
+        value.set(0);
+        // Check if player holds the enemy team's banner
+        _.if(Selector("@s", {
+          nbt: { Inventory: [{ id: "minecraft:red_banner" }] }
+        }), () => {
+          value.set(1);
+        });
+      },
+    },
+    at_home_base: {
+      type: "individual",
+      updater: (value: Score) => {
+        value.set(0);
+        _.if(_.block(rel(0, -1, 0), "minecraft:blue_wool"), () => {
+          value.set(1);
+        });
+      },
+    },
+    captured_flag: {
+      type: "individual",
+      updater: (value, { holds_enemy_flag, at_home_base }) => {
+        value.set(0);
+        _.if(_.and(
+          holds_enemy_flag.equalTo(1),
+          at_home_base.equalTo(1)
+        ), () => {
+          value.set(1);
+        });
+      },
+    },
+  },
+})
+  .events(() => ({
+    start_challenge: () => {
+      Actions.announce({ message: "Capture the enemy flag!" });
+    },
+  }))
+  .custom_events(({ captured_flag }) => [
+    {
+      score: captured_flag,
+      target: 1,
+      mode: "fire_once",
+      actions: () => {
+        Actions.announce({ message: "Flag captured!" });
+      },
+    },
+  ])
+  .end_condition(({ captured_flag }) => captured_flag.equalTo(1))
+  .win_conditions(({ captured_flag }, { red_team, blue_team }) => ({
+    [red_team]: captured_flag.equalTo(1),
+    [blue_team]: captured_flag.equalTo(0),
+  }));
+```
+

package/dist/actions.d.ts

@@ -149,11 +149,11 @@ export declare const Actions: {
     }) => void;
     /**
      * Send a chat message to a target.
-     * @param {string[]} message - The message to send.
+     * @param {JSONTextComponent} message - The message to send.
      * @param {TargetNames} target - The target to send the message to.
      */
     tellraw: ({ message, target }: {
-        message: string[];
+        message: JSONTextComponent;
         target: TargetNames;
     }) => void;
     /**
@@ -205,5 +205,26 @@ export declare const Actions: {
         z: number;
         absolute: boolean;
     }) => void;
+    /**
+     * Count the number of a specific item in a target's inventory.
+     * @param params - The parameters object.
+     * @param params.target - The target to count items for.
+     * @param params.item - The item to count.
+     * @returns The variable containing the item count.
+     */
+    countItems: ({ target, item }: {
+        target: TargetNames;
+        item: ITEMS;
+    }) => Score<string | undefined>;
+    /**
+     * Get the current player's position as x, y, z Score variables.
+     * Must be called in a player context (e.g., inside forEveryPlayer or when @s is a player).
+     * @returns An object with x, y, z Score variables containing the player's coordinates.
+     */
+    getCurrentPlayerPosition: () => {
+        x: Score<string | undefined>;
+        y: Score<string | undefined>;
+        z: Score<string | undefined>;
+    };
 };
 //# sourceMappingURL=actions.d.ts.map

package/dist/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"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"}

package/dist/actions.js

@@ -221,7 +221,7 @@ exports.Actions = {
     },
     /**
      * Send a chat message to a target.
-     * @param {string[]} message - The message to send.
+     * @param {JSONTextComponent} message - The message to send.
      * @param {TargetNames} target - The target to send the message to.
      */
     tellraw: ({ message, target }) => {
@@ -272,5 +272,31 @@ exports.Actions = {
         const abs = absolute ? "" : "~";
         (0, sandstone_1.raw)(`summon item ${abs}${x} ${abs}${y} ${abs}${z} {Item:{id:"${item}",Count:1b}}`);
     },
+    /**
+     * Count the number of a specific item in a target's inventory.
+     * @param params - The parameters object.
+     * @param params.target - The target to count items for.
+     * @param params.item - The item to count.
+     * @returns The variable containing the item count.
+     */
+    countItems: ({ target, item }) => {
+        const variable = (0, sandstone_1.Variable)();
+        sandstone_1.execute.store.result.score(variable).run.clear(mapTarget(target), item, 0);
+        return variable;
+    },
+    /**
+     * Get the current player's position as x, y, z Score variables.
+     * Must be called in a player context (e.g., inside forEveryPlayer or when @s is a player).
+     * @returns An object with x, y, z Score variables containing the player's coordinates.
+     */
+    getCurrentPlayerPosition: () => {
+        const x = (0, sandstone_1.Variable)();
+        const y = (0, sandstone_1.Variable)();
+        const z = (0, sandstone_1.Variable)();
+        sandstone_1.execute.store.result.score(x).run.data.get.entity("@s", "Pos[0]");
+        sandstone_1.execute.store.result.score(y).run.data.get.entity("@s", "Pos[1]");
+        sandstone_1.execute.store.result.score(z).run.data.get.entity("@s", "Pos[2]");
+        return { x, y, z };
+    },
 };
 //# sourceMappingURL=actions.js.map

package/dist/actions.js.map

@@ -1 +1 @@
-{"version":3,"file":"actions.js","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"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"}

package/dist/challenge.js

@@ -230,7 +230,7 @@ class ChallengeBase {
         const advancementsAsScoreCustomEvents = inputCustomEvents
             .filter(isAdvancementCustomEvent)
             .map((event, index) => {
-            const trigger = (event.criteria?.[0].trigger ?? "").split("minecraft:").at(-1).replace(/[:/]/g, "_");
+            const trigger = (event.criteria?.[0].trigger ?? "").split("minecraft:").at(-1)?.replace(/[:/]/g, "_");
             const name = `adv_${trigger}__${index}`;
             const score = getOrCreateObjective(getUniqueObjectiveName(name), "dummy")("@s");
             this.addVariable(name, {