redscript-mc 1.0.0 → 1.2.0

package/src/examples/parkour_race.mcrs

@@ -0,0 +1,233 @@
+// ============================================
+// Parkour Race - 跑酷竞速
+// ============================================
+// 场景：玩家从起点跑到终点，记录最快时间
+// 设有多个检查点，掉落会传送回最近检查点
+// Scenario: Race from start to finish with checkpoints
+// ============================================
+
+import "../stdlib/effects.mcrs"
+import "../stdlib/world.mcrs"
+import "../stdlib/bossbar.mcrs"
+import "../stdlib/particles.mcrs"
+
+// ===== 配置 =====
+const START_X: int = 0;
+const START_Y: int = 64;
+const START_Z: int = 0;
+const FALL_Y: int = 50;  // 低于此高度视为掉落
+
+const CHECKPOINT_COUNT: int = 5;
+
+// ===== 游戏状态 =====
+// 记分板:
+// - pk_time: 当前用时 (ticks)
+// - pk_best: 最佳记录
+// - pk_checkpoint: 当前检查点
+// - pk_running: 是否在比赛中
+
+// 检查点坐标 (简化为直线跑酷)
+// CP0: 0,64,0 (起点)
+// CP1: 0,64,50
+// CP2: 0,70,100
+// CP3: 0,75,150
+// CP4: 0,80,200
+// CP5: 0,64,250 (终点)
+
+@load
+fn init() {
+    scoreboard_add_objective("pk_time", "dummy");
+    scoreboard_add_objective("pk_best", "dummy");
+    scoreboard_add_objective("pk_checkpoint", "dummy");
+    scoreboard_add_objective("pk_running", "dummy");
+    
+    // 显示最佳时间
+    scoreboard_display("sidebar", "pk_best");
+    
+    set_day();
+    weather_clear();
+    
+    announce("§b[跑酷] §f已加载！踩压力板开始");
+}
+
+// ===== 开始比赛 =====
+fn start_race(player: selector) {
+    // 检查是否已在比赛中
+    let running: int = scoreboard_get(player, "pk_running");
+    if (running == 1) {
+        tell(player, "§c你已经在比赛中了！");
+        return;
+    }
+    
+    scoreboard_set(player, "pk_running", 1);
+    scoreboard_set(player, "pk_time", 0);
+    scoreboard_set(player, "pk_checkpoint", 0);
+    
+    // 传送到起点
+    tp(player, START_X, START_Y, START_Z);
+    
+    // 清除效果，给速度
+    effect_clear(player);
+    
+    title(player, "§b开始！");
+    subtitle(player, "§7跑向终点！");
+    
+    // 创建计时 bossbar
+    tell(player, "§b[跑酷] §a比赛开始！到达终点完成比赛");
+    
+    sparkles(player);
+}
+
+// ===== 每 tick =====
+@tick  
+fn race_tick() {
+    // 对每个比赛中的玩家
+    foreach (p in @a) {
+        let running: int = scoreboard_get(p, "pk_running");
+        if (running == 1) {
+            // 增加时间
+            scoreboard_add(p, "pk_time", 1);
+            
+            // 显示当前时间
+            let time: int = scoreboard_get(p, "pk_time");
+            let seconds: int = time / 20;
+            let ms: int = (time % 20) * 5;
+            actionbar(p, "§e⏱ " + seconds + "." + ms + " 秒");
+            
+            // 检查掉落
+            check_fall(p);
+            
+            // 检查检查点
+            check_checkpoints(p);
+        }
+    }
+}
+
+fn check_fall(player: selector) {
+    // 如果玩家低于 FALL_Y，传送回检查点
+    // 使用 execute positioned 检查
+    execute if entity player[y=..50] run {
+        let cp: int = scoreboard_get(player, "pk_checkpoint");
+        respawn_at_checkpoint(player, cp);
+        tell(player, "§c掉落！返回检查点 " + cp);
+        angry(player);
+    }
+}
+
+fn check_checkpoints(player: selector) {
+    let current_cp: int = scoreboard_get(player, "pk_checkpoint");
+    
+    // 检查点 1 (0, 64, 50)
+    if (current_cp == 0) {
+        execute if entity player[x=-2..2, y=62..68, z=48..52] run {
+            reach_checkpoint(player, 1);
+        }
+    }
+    
+    // 检查点 2 (0, 70, 100)
+    if (current_cp == 1) {
+        execute if entity player[x=-2..2, y=68..74, z=98..102] run {
+            reach_checkpoint(player, 2);
+        }
+    }
+    
+    // 检查点 3 (0, 75, 150)
+    if (current_cp == 2) {
+        execute if entity player[x=-2..2, y=73..79, z=148..152] run {
+            reach_checkpoint(player, 3);
+        }
+    }
+    
+    // 检查点 4 (0, 80, 200)
+    if (current_cp == 3) {
+        execute if entity player[x=-2..2, y=78..84, z=198..202] run {
+            reach_checkpoint(player, 4);
+        }
+    }
+    
+    // 终点 (0, 64, 250)
+    if (current_cp == 4) {
+        execute if entity player[x=-2..2, y=62..68, z=248..252] run {
+            finish_race(player);
+        }
+    }
+}
+
+fn reach_checkpoint(player: selector, cp: int) {
+    scoreboard_set(player, "pk_checkpoint", cp);
+    
+    title(player, "");
+    subtitle(player, "§a检查点 " + cp + " / " + CHECKPOINT_COUNT);
+    
+    happy(player);
+    playsound("minecraft:entity.experience_orb.pickup", "player", player);
+}
+
+fn respawn_at_checkpoint(player: selector, cp: int) {
+    if (cp == 0) {
+        tp(player, 0, 64, 0);
+    }
+    if (cp == 1) {
+        tp(player, 0, 64, 50);
+    }
+    if (cp == 2) {
+        tp(player, 0, 70, 100);
+    }
+    if (cp == 3) {
+        tp(player, 0, 75, 150);
+    }
+    if (cp == 4) {
+        tp(player, 0, 80, 200);
+    }
+}
+
+fn finish_race(player: selector) {
+    scoreboard_set(player, "pk_running", 0);
+    
+    let time: int = scoreboard_get(player, "pk_time");
+    let best: int = scoreboard_get(player, "pk_best");
+    let seconds: int = time / 20;
+    let ms: int = (time % 20) * 5;
+    
+    // 检查是否是新纪录
+    if (best == 0) {
+        // 第一次完成
+        scoreboard_set(player, "pk_best", time);
+        title(player, "§6完成！");
+        subtitle(player, "§e" + seconds + "." + ms + " 秒 §7(首次记录)");
+        announce("§b[跑酷] §f玩家完成比赛！用时 §e" + seconds + "." + ms + " 秒");
+    } else {
+        if (time < best) {
+            // 新纪录！
+            scoreboard_set(player, "pk_best", time);
+            title(player, "§6新纪录！");
+            subtitle(player, "§e" + seconds + "." + ms + " 秒");
+            announce("§b[跑酷] §6新纪录！§f用时 §e" + seconds + "." + ms + " 秒");
+            totem_effect(player);
+        } else {
+            title(player, "§a完成！");
+            subtitle(player, "§e" + seconds + "." + ms + " 秒");
+        }
+    }
+    
+    // 特效
+    sparkles(player);
+    playsound("minecraft:ui.toast.challenge_complete", "player", player);
+}
+
+// ===== 放弃比赛 =====
+fn quit_race(player: selector) {
+    let running: int = scoreboard_get(player, "pk_running");
+    if (running == 1) {
+        scoreboard_set(player, "pk_running", 0);
+        tell(player, "§c已放弃比赛");
+        tp(player, START_X, START_Y, START_Z);
+    }
+}
+
+// ===== 查看排行榜 =====
+fn show_leaderboard() {
+    announce("§b===== 跑酷排行榜 =====");
+    // 显示前 5 名 (需要记分板排序)
+    scoreboard_display("sidebar", "pk_best");
+}

package/src/examples/rpg.mcrs

@@ -0,0 +1,13 @@
+import "../stdlib/math.mcrs"
+import "../stdlib/combat.mcrs"
+
+fn attack(enemy: string, base: int, bonus: int) {
+    let raw_damage = weapon_damage(base, bonus);
+    let damage = clamp(raw_damage, 1, 20);
+    apply_damage(enemy, damage);
+}
+
+@tick
+fn battle_tick() {
+    attack("goblin", 4, 2);
+}

package/src/examples/{shop.rs → shop.mcrs}

@@ -2,7 +2,7 @@
 // Players set shop_choice, then run /trigger shop_buy.
 
 fn complete_purchase() {
-    let choice: int = scoreboard_get(@s, #shop_choice);
+    let choice = scoreboard_get(@s, #shop_choice);
 
     if (choice == 1) {
         give(@s, "minecraft:bread", 1);

package/src/examples/{showcase_game.rs → showcase_game.mcrs}

@@ -1,6 +1,6 @@
-import "../stdlib/math.rs"
-import "../stdlib/player.rs"
-import "../stdlib/cooldown.rs"
+import "../stdlib/math.mcrs"
+import "../stdlib/player.mcrs"
+import "../stdlib/cooldown.mcrs"
 
 const WIN_SCORE: int = 15
 const CRYSTAL_VALUE: int = 3

package/src/examples/{turret.rs → turret.mcrs}

@@ -8,7 +8,7 @@ fn deploy_turret() {
     turret.health = 40;
     turret.tag("turret");
 
-    let state: TurretState = { health: 40 };
+    let state = { health: 40 };
     let hp = state.health;
     scoreboard_set("turret", #health, hp);
 

package/src/examples/zombie_survival.mcrs

@@ -0,0 +1,314 @@
+// ============================================
+// Zombie Survival - 僵尸生存模式
+// ============================================
+// 场景：玩家在竞技场中心抵御一波波僵尸
+// 每波结束后可以购买装备升级
+// Scenario: Survive zombie waves, buy upgrades between rounds
+// ============================================
+
+import "../stdlib/effects.mcrs"
+import "../stdlib/world.mcrs"
+import "../stdlib/inventory.mcrs"
+import "../stdlib/bossbar.mcrs"
+import "../stdlib/particles.mcrs"
+
+// ===== 配置 =====
+const ARENA_X: int = 0;
+const ARENA_Y: int = 64;
+const ARENA_Z: int = 0;
+const ARENA_RADIUS: int = 30;
+const WAVE_DELAY: int = 200;  // 10秒准备时间
+
+// ===== 游戏状态 =====
+struct SurvivalState {
+    running: int,
+    wave: int,
+    zombies_left: int,
+    phase: int,         // 0=准备, 1=战斗
+    prep_timer: int,
+    total_kills: int
+}
+
+let state: SurvivalState = SurvivalState {
+    running: 0,
+    wave: 0,
+    zombies_left: 0,
+    phase: 0,
+    prep_timer: 0,
+    total_kills: 0
+};
+
+// ===== 玩家数据 =====
+// 金币记分板: zs_coins
+// 击杀数: zs_kills
+
+// ===== 初始化 =====
+@load
+fn init() {
+    scoreboard_add_objective("zs_coins", "dummy");
+    scoreboard_add_objective("zs_kills", "dummy");
+    scoreboard_add_objective("zs_display", "dummy");
+    
+    // 显示记分板
+    scoreboard_display("sidebar", "zs_display");
+    
+    set_night();
+    disable_mob_griefing();
+    
+    announce("§4[僵尸生存] §f已加载！输入 /trigger start 开始");
+}
+
+// ===== 开始游戏 =====
+fn start_game() {
+    state.running = 1;
+    state.wave = 0;
+    state.total_kills = 0;
+    
+    // 初始化玩家
+    foreach (p in @a) {
+        scoreboard_set(p, "zs_coins", 0);
+        scoreboard_set(p, "zs_kills", 0);
+        clear_inventory(p);
+        give(p, "minecraft:wooden_sword", 1);
+        give(p, "minecraft:leather_chestplate", 1);
+        tp(p, ARENA_X, ARENA_Y, ARENA_Z);
+    }
+    
+    // 创建 bossbar
+    create_progress_bar("zs_wave", "§c僵尸剩余", 10);
+    
+    title(@a, "§4僵尸生存");
+    subtitle(@a, "§7准备战斗...");
+    
+    // 开始第一波
+    start_prep_phase();
+}
+
+// ===== 阶段控制 =====
+fn start_prep_phase() {
+    state.phase = 0;
+    state.prep_timer = WAVE_DELAY;
+    state.wave = state.wave + 1;
+    
+    announce("§4[僵尸生存] §e第 " + state.wave + " 波即将来袭！");
+    announce("§7准备时间 10 秒...");
+    
+    // 商店提示
+    if (state.wave > 1) {
+        announce("§a[商店] §f输入 /trigger buy 购买装备");
+    }
+}
+
+fn start_combat_phase() {
+    state.phase = 1;
+    
+    // 计算僵尸数量 (每波增加)
+    let zombie_count: int = 3 + (state.wave * 2);
+    state.zombies_left = zombie_count;
+    
+    // 更新 bossbar
+    bossbar_set_max("zs_wave", zombie_count);
+    bossbar_set_value("zs_wave", zombie_count);
+    
+    title(@a, "§c第 " + state.wave + " 波");
+    
+    // 生成僵尸
+    spawn_zombies(zombie_count);
+}
+
+fn spawn_zombies(count: int) {
+    for i in 0..count {
+        // 在竞技场边缘随机生成
+        let angle: int = i * 30;  // 分散生成
+        let spawn_x: int = ARENA_X + (ARENA_RADIUS - 5);
+        let spawn_z: int = ARENA_Z;
+        
+        // 根据波数增加僵尸强度
+        if (state.wave < 3) {
+            summon("minecraft:zombie", spawn_x, ARENA_Y, spawn_z);
+        } else {
+            if (state.wave < 5) {
+                // 穿盔甲的僵尸
+                summon("minecraft:zombie", spawn_x, ARENA_Y, spawn_z, 
+                    {ArmorItems: [{}, {}, {id: "iron_chestplate", Count: 1}, {}]});
+            } else {
+                // 快速僵尸
+                summon("minecraft:husk", spawn_x, ARENA_Y, spawn_z);
+            }
+        }
+    }
+    
+    announce("§c" + count + " 只僵尸出现了！");
+}
+
+// ===== 每 tick =====
+@tick
+fn game_tick() {
+    if (state.running == 0) {
+        return;
+    }
+    
+    if (state.phase == 0) {
+        // 准备阶段
+        prep_tick();
+    } else {
+        // 战斗阶段
+        combat_tick();
+    }
+    
+    update_scoreboard();
+}
+
+fn prep_tick() {
+    state.prep_timer = state.prep_timer - 1;
+    
+    // 倒计时提示
+    if (state.prep_timer == 100) {
+        actionbar(@a, "§e5 秒...");
+    }
+    if (state.prep_timer == 60) {
+        actionbar(@a, "§e3 秒...");
+    }
+    if (state.prep_timer == 20) {
+        actionbar(@a, "§c1 秒...");
+    }
+    
+    if (state.prep_timer <= 0) {
+        start_combat_phase();
+    }
+}
+
+fn combat_tick() {
+    // 检查僵尸数量
+    let zombies: int = count_entities(@e[type=zombie, distance=..50]);
+    let husks: int = count_entities(@e[type=husk, distance=..50]);
+    state.zombies_left = zombies + husks;
+    
+    // 更新 bossbar
+    update_bar("zs_wave", state.zombies_left);
+    
+    // 检查波次完成
+    if (state.zombies_left <= 0) {
+        wave_complete();
+    }
+    
+    // 检查玩家存活
+    let alive: int = count_entities(@a[gamemode=survival]);
+    if (alive <= 0) {
+        game_over();
+    }
+}
+
+fn wave_complete() {
+    announce("§4[僵尸生存] §a第 " + state.wave + " 波完成！");
+    
+    // 奖励金币
+    let reward: int = 50 + (state.wave * 25);
+    foreach (p in @a) {
+        scoreboard_add(p, "zs_coins", reward);
+        happy(p);
+    }
+    announce("§6+" + reward + " 金币");
+    
+    // 检查特殊波
+    if (state.wave == 10) {
+        victory();
+        return;
+    }
+    
+    start_prep_phase();
+}
+
+// ===== 商店系统 =====
+fn buy_item(player: selector, item_id: int) {
+    let coins: int = scoreboard_get(player, "zs_coins");
+    
+    if (item_id == 1) {
+        // 铁剑 - 100 金币
+        if (coins >= 100) {
+            scoreboard_add(player, "zs_coins", -100);
+            give(player, "minecraft:iron_sword", 1);
+            tell(player, "§a购买成功：铁剑");
+        } else {
+            tell(player, "§c金币不足！需要 100");
+        }
+    }
+    
+    if (item_id == 2) {
+        // 铁甲 - 200 金币
+        if (coins >= 200) {
+            scoreboard_add(player, "zs_coins", -200);
+            give(player, "minecraft:iron_chestplate", 1);
+            give(player, "minecraft:iron_leggings", 1);
+            give(player, "minecraft:iron_boots", 1);
+            tell(player, "§a购买成功：铁甲套装");
+        } else {
+            tell(player, "§c金币不足！需要 200");
+        }
+    }
+    
+    if (item_id == 3) {
+        // 弓箭 - 150 金币
+        if (coins >= 150) {
+            scoreboard_add(player, "zs_coins", -150);
+            give(player, "minecraft:bow", 1);
+            give(player, "minecraft:arrow", 32);
+            tell(player, "§a购买成功：弓 + 32 箭");
+        } else {
+            tell(player, "§c金币不足！需要 150");
+        }
+    }
+    
+    if (item_id == 4) {
+        // 金苹果 - 75 金币
+        if (coins >= 75) {
+            scoreboard_add(player, "zs_coins", -75);
+            give(player, "minecraft:golden_apple", 2);
+            tell(player, "§a购买成功：金苹果 x2");
+        } else {
+            tell(player, "§c金币不足！需要 75");
+        }
+    }
+}
+
+// ===== 结束 =====
+fn victory() {
+    state.running = 0;
+    
+    title(@a, "§6胜利！");
+    subtitle(@a, "§a你们生存了 10 波！");
+    announce("§4[僵尸生存] §6恭喜！完成全部 10 波！");
+    
+    foreach (p in @a) {
+        totem_effect(p);
+        buff_all(p, 200);
+    }
+    
+    remove_bar("zs_wave");
+}
+
+fn game_over() {
+    state.running = 0;
+    
+    title(@a, "§c游戏结束");
+    subtitle(@a, "§7生存了 " + state.wave + " 波");
+    announce("§4[僵尸生存] §c全员阵亡！最高波数：" + state.wave);
+    
+    // 清理僵尸
+    kill(@e[type=zombie]);
+    kill(@e[type=husk]);
+    
+    remove_bar("zs_wave");
+}
+
+fn update_scoreboard() {
+    scoreboard_set("$wave", "zs_display", state.wave);
+    scoreboard_set("$zombies", "zs_display", state.zombies_left);
+}
+
+fn count_entities(sel: selector) -> int {
+    // 使用 execute store 计算实体数量
+    let count: int = 0;
+    // 实际实现需要 execute store
+    return count;
+}

package/src/index.ts

@@ -19,7 +19,7 @@ import {
   generateDatapackWithStats,
   DatapackFile,
 } from './codegen/mcfunction'
-import { preprocessSource } from './compile'
+import { preprocessSource, preprocessSourceWithMetadata } from './compile'
 import type { IRModule } from './ir/types'
 import type { Program } from './ast/types'
 import type { DiagnosticError } from './diagnostics'
@@ -54,7 +54,8 @@ export function compile(source: string, options: CompileOptions = {}): CompileRe
   const shouldOptimize = options.optimize ?? true
   const shouldTypeCheck = options.typeCheck ?? true
   const filePath = options.filePath
-  const preprocessedSource = preprocessSource(source, { filePath })
+  const preprocessed = preprocessSourceWithMetadata(source, { filePath })
+  const preprocessedSource = preprocessed.source
 
   // Lexing
   const tokens = new Lexer(preprocessedSource, filePath).tokenize()
@@ -70,7 +71,7 @@ export function compile(source: string, options: CompileOptions = {}): CompileRe
   }
 
   // Lowering to IR
-  const lowering = new Lowering(namespace)
+  const lowering = new Lowering(namespace, preprocessed.ranges)
   const ir = lowering.lower(ast)
 
   let optimizedIR: IRModule = ir

package/src/ir/builder.ts

@@ -109,6 +109,8 @@ export class IRBuilder {
   }
 }
 
-export function buildModule(namespace: string, fns: IRFunction[], globals: string[] = []): IRModule {
+import type { GlobalVar } from './types'
+
+export function buildModule(namespace: string, fns: IRFunction[], globals: GlobalVar[] = []): IRModule {
   return { namespace, functions: fns, globals }
 }

package/src/ir/types.ts

@@ -8,7 +8,7 @@
  *   - Integer vars  → scoreboard fake player  ($name on objective "rs_vars")
  *   - Complex data  → NBT storage             (redscript:stack / redscript:heap)
  *   - Return value  → fake player $ret
- *   - Temporaries   → $t0, $t1, ...
+ *   - Temporaries   → $_0, $_1, ...
  */
 
 // ---------------------------------------------------------------------------
@@ -100,20 +100,30 @@ export interface IRFunction {
   blocks: IRBlock[]        // blocks[0] = entry block
   commands?: IRCommand[]   // structure target command stream
   isTickLoop?: boolean     // true → Repeat command block (runs every tick)
+  isLoadInit?: boolean     // true → called from __load.mcfunction
   isTriggerHandler?: boolean  // true → handles a trigger event
   triggerName?: string        // the trigger objective name
   eventTrigger?: {
     kind: 'advancement' | 'craft' | 'death' | 'login' | 'join_team'
     value?: string
   }
+  eventHandler?: {
+    eventType: string
+    tag: string
+  }
 }
 
 // ---------------------------------------------------------------------------
 // Module — top-level compilation unit
 // ---------------------------------------------------------------------------
 
+export interface GlobalVar {
+  name: string
+  init: number
+}
+
 export interface IRModule {
   namespace: string        // datapack namespace (e.g. "mypack")
   functions: IRFunction[]
-  globals: string[]        // global variable names
+  globals: GlobalVar[]     // global variable declarations with init values
 }

package/src/lexer/index.ts

@@ -15,7 +15,7 @@ import { DiagnosticError } from '../diagnostics'
 export type TokenKind =
   // Keywords
   | 'fn' | 'let' | 'const' | 'if' | 'else' | 'while' | 'for' | 'foreach' | 'match'
-  | 'return' | 'as' | 'at' | 'in' | 'struct' | 'enum' | 'trigger' | 'namespace'
+  | 'return' | 'as' | 'at' | 'in' | 'is' | 'struct' | 'impl' | 'enum' | 'trigger' | 'namespace'
   | 'execute' | 'run' | 'unless'
   // Types
   | 'int' | 'bool' | 'float' | 'string' | 'void'
@@ -75,7 +75,9 @@ const KEYWORDS: Record<string, TokenKind> = {
   as: 'as',
   at: 'at',
   in: 'in',
+  is: 'is',
   struct: 'struct',
+  impl: 'impl',
   enum: 'enum',
   trigger: 'trigger',
   namespace: 'namespace',