redscript-mc 1.0.0 → 1.1.0

package/src/examples/capture_the_flag.mcrs

@@ -0,0 +1,208 @@
+// ============================================
+// Capture the Flag Mini-Game
+// ============================================
+// 场景：两队对抗，抢夺对方旗帜带回己方基地得分
+// Scenario: Two teams compete to capture enemy flag
+// ============================================
+
+import "../stdlib/teams.mcrs"
+import "../stdlib/effects.mcrs"
+import "../stdlib/world.mcrs"
+import "../stdlib/inventory.mcrs"
+import "../stdlib/particles.mcrs"
+
+// ===== 配置 =====
+const RED_BASE_X: int = -50;
+const RED_BASE_Z: int = 0;
+const BLUE_BASE_X: int = 50;
+const BLUE_BASE_Z: int = 0;
+const BASE_Y: int = 64;
+const WIN_SCORE: int = 3;
+
+// ===== 游戏状态 =====
+struct GameState {
+    running: int,
+    red_score: int,
+    blue_score: int,
+    red_flag_taken: int,
+    blue_flag_taken: int
+}
+
+let game: GameState = GameState {
+    running: 0,
+    red_score: 0,
+    blue_score: 0,
+    red_flag_taken: 0,
+    blue_flag_taken: 0
+};
+
+// ===== 初始化 =====
+@load
+fn init() {
+    // 创建记分板
+    scoreboard_add_objective("ctf_team", "dummy");
+    scoreboard_add_objective("ctf_flag", "dummy");
+    
+    // 创建队伍
+    setup_two_teams();
+    
+    // 世界设置
+    set_day();
+    weather_clear();
+    enable_keep_inventory();
+    
+    announce("§e[CTF] §f夺旗战已加载！使用 /trigger start 开始游戏");
+}
+
+// ===== 开始游戏 =====
+fn start_game() {
+    game.running = 1;
+    game.red_score = 0;
+    game.blue_score = 0;
+    
+    // 随机分配队伍
+    assign_teams();
+    
+    // 传送到各自基地
+    tp(@a[team=red], RED_BASE_X, BASE_Y, RED_BASE_Z);
+    tp(@a[team=blue], BLUE_BASE_X, BASE_Y, BLUE_BASE_Z);
+    
+    // 给装备
+    foreach (p in @a) {
+        clear_inventory(p);
+        give_kit_warrior(p);
+    }
+    
+    // 放置旗帜（盔甲架）
+    place_flags();
+    
+    announce("§e[CTF] §a游戏开始！抢夺敌方旗帜！");
+    title(@a, "§6夺旗战开始！");
+}
+
+fn place_flags() {
+    // 红方旗帜（红色旗帜方块）
+    setblock(RED_BASE_X, BASE_Y + 1, RED_BASE_Z, "minecraft:red_banner");
+    // 蓝方旗帜
+    setblock(BLUE_BASE_X, BASE_Y + 1, BLUE_BASE_Z, "minecraft:blue_banner");
+    
+    game.red_flag_taken = 0;
+    game.blue_flag_taken = 0;
+}
+
+fn assign_teams() {
+    let count: int = 0;
+    foreach (p in @a) {
+        if (count % 2 == 0) {
+            team_join(p, "red");
+            scoreboard_set(p, "ctf_team", 1);
+        } else {
+            team_join(p, "blue");
+            scoreboard_set(p, "ctf_team", 2);
+        }
+        count = count + 1;
+    }
+}
+
+// ===== 每 tick 检查 =====
+@tick
+fn game_tick() {
+    if (game.running == 1) {
+        check_flag_pickup();
+        check_flag_capture();
+        check_win();
+    }
+}
+
+fn check_flag_pickup() {
+    // 检查蓝队玩家是否靠近红旗
+    foreach (p in @a[team=blue]) {
+        // 如果在红方基地附近且旗帜未被拿走
+        let dist: int = distance_to(p, RED_BASE_X, BASE_Y, RED_BASE_Z);
+        if (dist < 3) {
+            if (game.red_flag_taken == 0) {
+                game.red_flag_taken = 1;
+                tag_add(p, "has_flag");
+                setblock(RED_BASE_X, BASE_Y + 1, RED_BASE_Z, "minecraft:air");
+                announce("§e[CTF] §9蓝队 §f拿到了 §c红方旗帜§f！");
+                glow(p, 9999);
+            }
+        }
+    }
+    
+    // 检查红队玩家是否靠近蓝旗
+    foreach (p in @a[team=red]) {
+        let dist: int = distance_to(p, BLUE_BASE_X, BASE_Y, BLUE_BASE_Z);
+        if (dist < 3) {
+            if (game.blue_flag_taken == 0) {
+                game.blue_flag_taken = 1;
+                tag_add(p, "has_flag");
+                setblock(BLUE_BASE_X, BASE_Y + 1, BLUE_BASE_Z, "minecraft:air");
+                announce("§e[CTF] §c红队 §f拿到了 §9蓝方旗帜§f！");
+                glow(p, 9999);
+            }
+        }
+    }
+}
+
+fn check_flag_capture() {
+    // 蓝队带红旗回蓝方基地
+    foreach (p in @a[team=blue, tag=has_flag]) {
+        let dist: int = distance_to(p, BLUE_BASE_X, BASE_Y, BLUE_BASE_Z);
+        if (dist < 5) {
+            game.blue_score = game.blue_score + 1;
+            announce("§e[CTF] §9蓝队 §a得分！§f (" + game.blue_score + "/" + WIN_SCORE + ")");
+            tag_remove(p, "has_flag");
+            effect_clear(p, "minecraft:glowing");
+            place_flags();
+            happy(p);
+        }
+    }
+    
+    // 红队带蓝旗回红方基地  
+    foreach (p in @a[team=red, tag=has_flag]) {
+        let dist: int = distance_to(p, RED_BASE_X, BASE_Y, RED_BASE_Z);
+        if (dist < 5) {
+            game.red_score = game.red_score + 1;
+            announce("§e[CTF] §c红队 §a得分！§f (" + game.red_score + "/" + WIN_SCORE + ")");
+            tag_remove(p, "has_flag");
+            effect_clear(p, "minecraft:glowing");
+            place_flags();
+            happy(p);
+        }
+    }
+}
+
+fn check_win() {
+    if (game.red_score >= WIN_SCORE) {
+        end_game("red");
+    }
+    if (game.blue_score >= WIN_SCORE) {
+        end_game("blue");
+    }
+}
+
+fn end_game(winner: string) {
+    game.running = 0;
+    
+    if (winner == "red") {
+        title(@a, "§c红队获胜！");
+        announce("§e[CTF] §c红队 §6赢得了比赛！");
+    } else {
+        title(@a, "§9蓝队获胜！");
+        announce("§e[CTF] §9蓝队 §6赢得了比赛！");
+    }
+    
+    // 清理
+    foreach (p in @a[tag=has_flag]) {
+        tag_remove(p, "has_flag");
+        effect_clear(p);
+    }
+}
+
+// ===== 辅助函数 =====
+fn distance_to(target: selector, x: int, y: int, z: int) -> int {
+    // 简化的距离计算（使用记分板）
+    let dist: int = scoreboard_get(target, "ctf_dist");
+    return dist;
+}

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

@@ -2,7 +2,7 @@
 
 @tick
 fn counter_tick() {
-    let ticks: int = scoreboard_get("counter", #ticks);
+    let ticks = scoreboard_get("counter", #ticks);
     ticks = ticks + 1;
     scoreboard_set("counter", #ticks, ticks);
 

package/src/examples/hunger_games.mcrs

@@ -0,0 +1,301 @@
+// ============================================
+// Hunger Games - 饥饿游戏
+// ============================================
+// 场景：玩家从中央补给点开始，搜刮物资生存
+// 边界逐渐缩小，最后存活者获胜
+// Scenario: Battle royale with shrinking border
+// ============================================
+
+import "../stdlib/effects.mcrs"
+import "../stdlib/world.mcrs"
+import "../stdlib/bossbar.mcrs"
+import "../stdlib/particles.mcrs"
+
+// ===== 配置 =====
+const CENTER_X: int = 0;
+const CENTER_Y: int = 64;
+const CENTER_Z: int = 0;
+const INITIAL_BORDER: int = 200;
+const FINAL_BORDER: int = 20;
+const GRACE_PERIOD: int = 600;  // 30秒无敌时间
+const SHRINK_INTERVAL: int = 1200;  // 每60秒缩圈
+
+// ===== 游戏状态 =====
+struct HGState {
+    running: int,
+    phase: int,        // 0=等待, 1=倒计时, 2=游戏中, 3=结束
+    countdown: int,
+    grace_timer: int,
+    border_timer: int,
+    current_border: int,
+    alive_count: int
+}
+
+let game: HGState = HGState {
+    running: 0,
+    phase: 0,
+    countdown: 0,
+    grace_timer: 0,
+    border_timer: 0,
+    current_border: INITIAL_BORDER,
+    alive_count: 0
+};
+
+@load
+fn init() {
+    scoreboard_add_objective("hg_kills", "dummy");
+    scoreboard_add_objective("hg_alive", "dummy");
+    
+    // 设置世界边界
+    // worldborder center 0 0
+    // worldborder set 200
+    
+    announce("§c[饥饿游戏] §f已加载！等待玩家加入...");
+}
+
+// ===== 开始游戏 =====
+fn start_countdown() {
+    game.phase = 1;
+    game.countdown = 200;  // 10秒倒计时
+    
+    // 传送所有玩家到中央
+    foreach (p in @a) {
+        tp(p, CENTER_X, CENTER_Y + 50, CENTER_Z);  // 高空开始
+        scoreboard_set(p, "hg_kills", 0);
+        scoreboard_set(p, "hg_alive", 1);
+        
+        // 清空背包
+        clear(p);
+        
+        // 冻结玩家
+        effect(p, "minecraft:slowness", 15, 255);
+        effect(p, "minecraft:jump_boost", 15, 250);  // 防止跳跃
+    }
+    
+    // 创建边界 bossbar
+    create_progress_bar("hg_border", "§c边界缩小中", INITIAL_BORDER);
+    
+    announce("§c[饥饿游戏] §e游戏即将开始！");
+}
+
+fn start_game() {
+    game.phase = 2;
+    game.running = 1;
+    game.grace_timer = GRACE_PERIOD;
+    game.border_timer = SHRINK_INTERVAL;
+    game.current_border = INITIAL_BORDER;
+    
+    // 计算存活人数
+    game.alive_count = 0;
+    foreach (p in @a) {
+        game.alive_count = game.alive_count + 1;
+        
+        // 清除效果
+        effect_clear(p);
+        
+        // 缓降
+        slow_fall(p, 100);
+    }
+    
+    title(@a, "§c游戏开始！");
+    subtitle(@a, "§7搜刮物资，成为最后的生存者！");
+    
+    announce("§c[饥饿游戏] §a游戏开始！§730秒内无法互相伤害");
+}
+
+// ===== 每 tick =====
+@tick
+fn game_tick() {
+    if (game.phase == 1) {
+        countdown_tick();
+    }
+    
+    if (game.phase == 2) {
+        main_game_tick();
+    }
+}
+
+fn countdown_tick() {
+    game.countdown = game.countdown - 1;
+    
+    // 倒计时提示
+    if (game.countdown == 100) {
+        title(@a, "§e5");
+        playsound("minecraft:block.note_block.pling", "player", @a);
+    }
+    if (game.countdown == 80) {
+        title(@a, "§e4");
+        playsound("minecraft:block.note_block.pling", "player", @a);
+    }
+    if (game.countdown == 60) {
+        title(@a, "§e3");
+        playsound("minecraft:block.note_block.pling", "player", @a);
+    }
+    if (game.countdown == 40) {
+        title(@a, "§c2");
+        playsound("minecraft:block.note_block.pling", "player", @a);
+    }
+    if (game.countdown == 20) {
+        title(@a, "§c1");
+        playsound("minecraft:block.note_block.pling", "player", @a);
+    }
+    
+    if (game.countdown <= 0) {
+        start_game();
+    }
+}
+
+fn main_game_tick() {
+    // 无敌时间
+    if (game.grace_timer > 0) {
+        game.grace_timer = game.grace_timer - 1;
+        
+        if (game.grace_timer == 0) {
+            announce("§c[饥饿游戏] §4无敌时间结束！可以开始战斗！");
+            title(@a, "§c战斗开始！");
+        }
+    }
+    
+    // 边界缩小
+    game.border_timer = game.border_timer - 1;
+    if (game.border_timer <= 0) {
+        shrink_border();
+        game.border_timer = SHRINK_INTERVAL;
+    }
+    
+    // 更新 bossbar
+    update_bar("hg_border", game.current_border);
+    
+    // 检查边界伤害
+    check_border_damage();
+    
+    // 检查存活人数
+    check_alive();
+}
+
+fn shrink_border() {
+    if (game.current_border > FINAL_BORDER) {
+        game.current_border = game.current_border - 20;
+        
+        if (game.current_border < FINAL_BORDER) {
+            game.current_border = FINAL_BORDER;
+        }
+        
+        // worldborder set game.current_border 60
+        announce("§c[饥饿游戏] §e边界正在缩小！当前大小：" + game.current_border);
+        
+        // 更新 bossbar
+        bossbar_set_max("hg_border", INITIAL_BORDER);
+        bossbar_set_value("hg_border", game.current_border);
+        
+        // 颜色变化
+        if (game.current_border < 50) {
+            bossbar_set_color("hg_border", "red");
+        } else {
+            if (game.current_border < 100) {
+                bossbar_set_color("hg_border", "yellow");
+            }
+        }
+    }
+}
+
+fn check_border_damage() {
+    // 对边界外的玩家造成伤害
+    // 需要检查玩家是否在边界外
+    foreach (p in @a) {
+        // 简化：使用 execute positioned
+        let dist: int = 0;  // 需要计算距离中心的距离
+        // 如果超出边界，造成伤害
+        // effect(p, "minecraft:wither", 1, 0);
+    }
+}
+
+fn check_alive() {
+    let alive: int = 0;
+    let winner: selector = @a;
+    
+    foreach (p in @a[gamemode=survival]) {
+        let is_alive: int = scoreboard_get(p, "hg_alive");
+        if (is_alive == 1) {
+            alive = alive + 1;
+            winner = p;
+        }
+    }
+    
+    game.alive_count = alive;
+    
+    // 更新记分板显示
+    actionbar(@a, "§c存活: " + alive + " 人");
+    
+    // 检查胜利
+    if (alive <= 1) {
+        if (alive == 1) {
+            declare_winner(winner);
+        } else {
+            // 无人存活
+            end_game_no_winner();
+        }
+    }
+}
+
+fn declare_winner(winner: selector) {
+    game.phase = 3;
+    game.running = 0;
+    
+    let kills: int = scoreboard_get(winner, "hg_kills");
+    
+    title(@a, "§6胜利者！");
+    announce("§c[饥饿游戏] §6游戏结束！");
+    announce("§a胜利者击杀数：" + kills);
+    
+    // 胜利特效
+    totem_effect(winner);
+    buff_all(winner, 200);
+    
+    remove_bar("hg_border");
+}
+
+fn end_game_no_winner() {
+    game.phase = 3;
+    game.running = 0;
+    
+    title(@a, "§7游戏结束");
+    subtitle(@a, "§c无人存活");
+    
+    remove_bar("hg_border");
+}
+
+// ===== 玩家死亡处理 =====
+fn on_player_death(player: selector, killer: selector) {
+    scoreboard_set(player, "hg_alive", 0);
+    
+    // 更新击杀数
+    scoreboard_add(killer, "hg_kills", 1);
+    
+    // 切换观察模式
+    // gamemode spectator player
+    
+    let kills: int = scoreboard_get(killer, "hg_kills");
+    announce("§c☠ §7玩家被击杀！击杀者已有 " + kills + " 杀");
+}
+
+// ===== 重置游戏 =====
+fn reset_game() {
+    game.phase = 0;
+    game.running = 0;
+    
+    foreach (p in @a) {
+        scoreboard_set(p, "hg_kills", 0);
+        scoreboard_set(p, "hg_alive", 0);
+        effect_clear(p);
+        // gamemode survival p
+    }
+    
+    // 重置边界
+    game.current_border = INITIAL_BORDER;
+    // worldborder set 200
+    
+    remove_bar("hg_border");
+    
+    announce("§c[饥饿游戏] §7游戏已重置");
+}

package/src/examples/new_features_demo.mcrs

@@ -0,0 +1,193 @@
+/**
+ * RedScript New Features Demo
+ * 展示 2026-03-12 新增的语言特性
+ */
+
+// ============================================
+// 1. 类型推断 (Type Inference)
+// ============================================
+fn type_inference_demo() {
+    // 不需要写 `: int`，编译器自动推断
+    let health = 100;
+    let name = "Steve";
+    let alive = true;
+    let speed = 1.5;
+    
+    // NBT 后缀也能推断
+    let damage = 20b;      // byte
+    let distance = 1000s;  // short
+    let bignum = 999999L;  // long
+    let precise = 3.14d;   // double
+    
+    say("Health: ${health}, Name: ${name}");
+}
+
+// ============================================
+// 2. for-range 循环 (For-Range Loops)
+// ============================================
+fn for_range_demo() {
+    // 从 0 到 9 循环
+    for i in 0..10 {
+        say("Count: ${i}");
+    }
+    
+    // 可以用于倒计时
+    for sec in 0..5 {
+        title(@a, "Starting in ${sec}...");
+    }
+}
+
+// ============================================
+// 3. NBT 结构化参数 (NBT Structured Params)
+// ============================================
+fn nbt_params_demo() {
+    // 给予带 NBT 的物品
+    give(@s, "minecraft:diamond_sword", 1, {
+        display: { Name: "Excalibur" },
+        Enchantments: [
+            { id: "minecraft:sharpness", lvl: 5 },
+            { id: "minecraft:unbreaking", lvl: 3 }
+        ]
+    });
+    
+    // 召唤带属性的实体
+    summon("minecraft:zombie", @s, {
+        CustomName: "Boss Zombie",
+        Health: 100.0,
+        Attributes: [
+            { Name: "generic.max_health", Base: 100.0 }
+        ]
+    });
+}
+
+// ============================================
+// 4. Set 数据结构 (Runtime Set)
+// ============================================
+fn set_demo() {
+    // 创建集合
+    let visited = set_new();
+    
+    // 使用方法语法添加元素
+    visited.add("spawn");
+    visited.add("castle");
+    visited.add("dungeon");
+    
+    // 检查是否存在
+    if (visited.contains("castle")) {
+        say("You've been to the castle!");
+    }
+    
+    // 删除元素
+    visited.remove("spawn");
+    
+    // 清空集合
+    visited.clear();
+}
+
+// ============================================
+// 5. 方法语法糖 (Method Syntax Sugar)
+// ============================================
+fn method_syntax_demo() {
+    let items: string[] = [];
+    
+    // obj.method(args) → method(obj, args)
+    items.push("sword");
+    items.push("shield");
+    items.push("potion");
+    
+    let count = items.len();
+    say("You have ${count} items");
+    
+    // Set 也可以用方法语法
+    let tags = set_new();
+    tags.add("vip");
+    tags.add("admin");
+    
+    if (tags.contains("admin")) {
+        say("Welcome, admin!");
+    }
+}
+
+// ============================================
+// 6. #mc_name 语法 (MC Identifier Syntax)
+// ============================================
+fn mc_name_demo() {
+    // #name 编译为裸 MC 名称（不带引号）
+    scoreboard_set(@s, #kills, 0);
+    scoreboard_add(@s, #deaths, 1);
+    
+    let score = scoreboard_get(@s, #points);
+    
+    // 用于 tag
+    tag_add(@s, #vip);
+    
+    // 用于 team
+    team_join(@s, #red);
+    
+    // 对比：字符串仍需引号
+    give(@s, "minecraft:diamond", 1);
+}
+
+// ============================================
+// 7. 块注释 (Block Comments)
+// ============================================
+
+/* 
+ * 这是块注释
+ * 可以跨越多行
+ */
+
+/**
+ * 这是文档注释
+ * @param player 目标玩家
+ */
+fn documented_function() {
+    say("Hello!");
+}
+
+// ============================================
+// 综合示例：简单游戏
+// ============================================
+
+struct Player {
+    score: int,
+    level: int,
+    visited: string  // set ID
+}
+
+fn init_player() {
+    let visited_set = set_new();
+    let p: Player = {
+        score: 0,
+        level: 1,
+        visited: visited_set
+    };
+    
+    // 记录出生点（使用 set_add，因为 visited 是 string ID）
+    set_add(p.visited, "spawn");
+    
+    scoreboard_set(@s, #score, p.score);
+    scoreboard_set(@s, #level, p.level);
+}
+
+@tick(rate=20)
+fn game_tick() {
+    // 每秒检查一次
+    for i in 0..1 {
+        let score = scoreboard_get(@s, #score);
+        if (score >= 100) {
+            title(@s, "Level Up!");
+            scoreboard_set(@s, #level, 2);
+        }
+    }
+}
+
+fn reward_player(amount: int) {
+    // 类型推断 + NBT 参数
+    let bonus = amount * 2;
+    scoreboard_add(@s, #score, bonus);
+    
+    give(@s, "minecraft:gold_ingot", amount, {
+        display: { Name: "Reward Gold" }
+    });
+}