redscript-mc 1.2.21 → 1.2.25

package/src/examples/capture_the_flag.mcrs

@@ -1,7 +1,7 @@
 // ============================================
 // Capture the Flag Mini-Game
 // ============================================
-// 场景：两队对抗，抢夺对方旗帜带回己方基地得分
+// Scenario: Two teams compete, capture the enemy flag and return it to your base to score
 // Scenario: Two teams compete to capture enemy flag
 // ============================================
 
@@ -11,7 +11,7 @@ import "../stdlib/world.mcrs"
 import "../stdlib/inventory.mcrs"
 import "../stdlib/particles.mcrs"
 
-// ===== 配置 =====
+// ===== Configuration =====
 const RED_BASE_X: int = -50;
 const RED_BASE_Z: int = 0;
 const BLUE_BASE_X: int = 50;
@@ -19,7 +19,7 @@ const BLUE_BASE_Z: int = 0;
 const BASE_Y: int = 64;
 const WIN_SCORE: int = 3;
 
-// ===== 游戏状态 =====
+// ===== Game State =====
 struct GameState {
     running: int,
     red_score: int,
@@ -36,54 +36,54 @@ let game: GameState = {
     blue_flag_taken: 0
 };
 
-// ===== 初始化 =====
+// ===== Initialization =====
 @load
 fn init() {
-    // 创建记分板
+    // Create scoreboards
     scoreboard_add_objective("ctf_team", "dummy");
     scoreboard_add_objective("ctf_flag", "dummy");
     
-    // 创建队伍
+    // Create teams
     setup_two_teams();
     
-    // 世界设置
+    // World settings
     set_day();
     weather_clear();
     enable_keep_inventory();
     
-    announce("§e[CTF] §f夺旗战已加载！使用 /trigger start 开始游戏");
+    announce("§e[CTF] §fCapture the Flag loaded! Use /trigger start to begin");
 }
 
-// ===== 开始游戏 =====
+// ===== Start Game =====
 fn start_game() {
     game.running = 1;
     game.red_score = 0;
     game.blue_score = 0;
     
-    // 随机分配队伍
+    // Randomly assign teams
     assign_teams();
     
-    // 传送到各自基地
+    // Teleport to respective bases
     tp(@a[team=red], RED_BASE_X, BASE_Y, RED_BASE_Z);
     tp(@a[team=blue], BLUE_BASE_X, BASE_Y, BLUE_BASE_Z);
     
-    // 给装备
+    // Give equipment
     foreach (p in @a) {
         clear_inventory(p);
         give_kit_warrior(p);
     }
     
-    // 放置旗帜（盔甲架）
+    // Place flags (banners)
     place_flags();
     
-    announce("§e[CTF] §a游戏开始！抢夺敌方旗帜！");
-    title(@a, "§6夺旗战开始！");
+    announce("§e[CTF] §aGame started! Capture the enemy flag!");
+    title(@a, "§6Capture the Flag - Start!");
 }
 
 fn place_flags() {
-    // 红方旗帜（红色旗帜方块）
+    // Red team flag (red banner block)
     setblock(RED_BASE_X, BASE_Y + 1, RED_BASE_Z, "minecraft:red_banner");
-    // 蓝方旗帜
+    // Blue team flag
     setblock(BLUE_BASE_X, BASE_Y + 1, BLUE_BASE_Z, "minecraft:blue_banner");
     
     game.red_flag_taken = 0;
@@ -104,7 +104,7 @@ fn assign_teams() {
     }
 }
 
-// ===== 每 tick 检查 =====
+// ===== Tick Check =====
 @tick
 fn game_tick() {
     if (game.running == 1) {
@@ -115,22 +115,22 @@ fn game_tick() {
 }
 
 fn check_flag_pickup() {
-    // 检查蓝队玩家是否靠近红旗
+    // Check if blue team players are near the red flag
     foreach (p in @a[team=blue]) {
-        // 如果在红方基地附近且旗帜未被拿走
+        // If near red team base and flag has not been taken
         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！");
+                announce("§e[CTF] §9Blue Team §fhas taken the §cRed Flag§f!");
                 glow(p, 9999);
             }
         }
     }
     
-    // 检查红队玩家是否靠近蓝旗
+    // Check if red team players are near the blue flag
     foreach (p in @a[team=red]) {
         let dist: int = distance_to(p, BLUE_BASE_X, BASE_Y, BLUE_BASE_Z);
         if (dist < 3) {
@@ -138,7 +138,7 @@ fn check_flag_pickup() {
                 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！");
+                announce("§e[CTF] §cRed Team §fhas taken the §9Blue Flag§f!");
                 glow(p, 9999);
             }
         }
@@ -146,12 +146,12 @@ fn check_flag_pickup() {
 }
 
 fn check_flag_capture() {
-    // 蓝队带红旗回蓝方基地
+    // Blue team carries red flag back to blue base
     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 + ")");
+            announce("§e[CTF] §9Blue Team §ascores! §f(" + game.blue_score + "/" + WIN_SCORE + ")");
             tag_remove(p, "has_flag");
             effect_clear(p, "minecraft:glowing");
             place_flags();
@@ -159,12 +159,12 @@ fn check_flag_capture() {
         }
     }
     
-    // 红队带蓝旗回红方基地  
+    // Red team carries blue flag back to red base
     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 + ")");
+            announce("§e[CTF] §cRed Team §ascores! §f(" + game.red_score + "/" + WIN_SCORE + ")");
             tag_remove(p, "has_flag");
             effect_clear(p, "minecraft:glowing");
             place_flags();
@@ -186,23 +186,23 @@ fn end_game(winner: string) {
     game.running = 0;
     
     if (winner == "red") {
-        title(@a, "§c红队获胜！");
-        announce("§e[CTF] §c红队 §6赢得了比赛！");
+        title(@a, "§cRed Team Wins!");
+        announce("§e[CTF] §cRed Team §6wins the match!");
     } else {
-        title(@a, "§9蓝队获胜！");
-        announce("§e[CTF] §9蓝队 §6赢得了比赛！");
+        title(@a, "§9Blue Team Wins!");
+        announce("§e[CTF] §9Blue Team §6wins the match!");
     }
     
-    // 清理
+    // Cleanup
     foreach (p in @a[tag=has_flag]) {
         tag_remove(p, "has_flag");
         effect_clear(p);
     }
 }
 
-// ===== 辅助函数 =====
+// ===== Helper Functions =====
 fn distance_to(target: selector, x: int, y: int, z: int) -> int {
-    // 简化的距离计算（使用记分板）
+    // Simplified distance calculation (using scoreboard)
     let dist: int = scoreboard_get(target, "ctf_dist");
     return dist;
 }

package/src/examples/hunger_games.mcrs

@@ -1,8 +1,8 @@
 // ============================================
-// Hunger Games - 饥饿游戏
+// Hunger Games - Hunger Games
 // ============================================
-// 场景：玩家从中央补给点开始，搜刮物资生存
-// 边界逐渐缩小，最后存活者获胜
+// Scenario: Players start from the central supply point, scavenge for resources
+// Border gradually shrinks, last survivor wins
 // Scenario: Battle royale with shrinking border
 // ============================================
 
@@ -11,19 +11,19 @@ import "../stdlib/world.mcrs"
 import "../stdlib/bossbar.mcrs"
 import "../stdlib/particles.mcrs"
 
-// ===== 配置 =====
+// ===== Configuration =====
 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秒缩圈
+const GRACE_PERIOD: int = 600;  // 30-second grace period
+const SHRINK_INTERVAL: int = 1200;  // Shrink every 60 seconds
 
-// ===== 游戏状态 =====
+// ===== Game State =====
 struct HGState {
     running: int,
-    phase: int,        // 0=等待, 1=倒计时, 2=游戏中, 3=结束
+    phase: int,        // 0=waiting, 1=countdown, 2=in-game, 3=ended
     countdown: int,
     grace_timer: int,
     border_timer: int,
@@ -46,36 +46,36 @@ fn init() {
     scoreboard_add_objective("hg_kills", "dummy");
     scoreboard_add_objective("hg_alive", "dummy");
     
-    // 设置世界边界
+    // Set world border
     // worldborder center 0 0
     // worldborder set 200
     
-    announce("§c[饥饿游戏] §f已加载！等待玩家加入...");
+    announce("§c[Hunger Games] §fLoaded! Waiting for players to join...");
 }
 
-// ===== 开始游戏 =====
+// ===== Start Game =====
 fn start_countdown() {
     game.phase = 1;
-    game.countdown = 200;  // 10秒倒计时
+    game.countdown = 200;  // 10-second countdown
     
-    // 传送所有玩家到中央
+    // Teleport all players to center
     foreach (p in @a) {
-        tp(p, CENTER_X, CENTER_Y + 50, CENTER_Z);  // 高空开始
+        tp(p, CENTER_X, CENTER_Y + 50, CENTER_Z);  // Start from high altitude
         scoreboard_set(p, "hg_kills", 0);
         scoreboard_set(p, "hg_alive", 1);
         
-        // 清空背包
+        // Clear inventory
         clear(p);
         
-        // 冻结玩家
+        // Freeze players
         effect(p, "minecraft:slowness", 15, 255);
-        effect(p, "minecraft:jump_boost", 15, 250);  // 防止跳跃
+        effect(p, "minecraft:jump_boost", 15, 250);  // Prevent jumping
     }
     
-    // 创建边界 bossbar
-    create_progress_bar("hg_border", "§c边界缩小中", INITIAL_BORDER);
+    // Create border bossbar
+    create_progress_bar("hg_border", "§cBorder Shrinking", INITIAL_BORDER);
     
-    announce("§c[饥饿游戏] §e游戏即将开始！");
+    announce("§c[Hunger Games] §eGame starting soon!");
 }
 
 fn start_game() {
@@ -85,25 +85,25 @@ fn start_game() {
     game.border_timer = SHRINK_INTERVAL;
     game.current_border = INITIAL_BORDER;
     
-    // 计算存活人数
+    // Count alive players
     game.alive_count = 0;
     foreach (p in @a) {
         game.alive_count = game.alive_count + 1;
         
-        // 清除效果
+        // Clear effects
         effect_clear(p);
         
-        // 缓降
+        // Slow fall
         slow_fall(p, 100);
     }
     
-    title(@a, "§c游戏开始！");
-    subtitle(@a, "§7搜刮物资，成为最后的生存者！");
+    title(@a, "§cGame Start!");
+    subtitle(@a, "§7Scavenge for supplies, be the last survivor!");
     
-    announce("§c[饥饿游戏] §a游戏开始！§730秒内无法互相伤害");
+    announce("§c[Hunger Games] §aGame started! §7No PvP for 30 seconds");
 }
 
-// ===== 每 tick =====
+// ===== Every Tick =====
 @tick
 fn game_tick() {
     if (game.phase == 1) {
@@ -118,7 +118,7 @@ fn game_tick() {
 fn countdown_tick() {
     game.countdown = game.countdown - 1;
     
-    // 倒计时提示
+    // Countdown hints
     if (game.countdown == 100) {
         title(@a, "§e5");
         playsound("minecraft:block.note_block.pling", "player", @a);
@@ -146,30 +146,30 @@ fn countdown_tick() {
 }
 
 fn main_game_tick() {
-    // 无敌时间
+    // Grace period
     if (game.grace_timer > 0) {
         game.grace_timer = game.grace_timer - 1;
         
         if (game.grace_timer == 0) {
-            announce("§c[饥饿游戏] §4无敌时间结束！可以开始战斗！");
-            title(@a, "§c战斗开始！");
+            announce("§c[Hunger Games] §4Grace period ended! Combat is now allowed!");
+            title(@a, "§cCombat Start!");
         }
     }
     
-    // 边界缩小
+    // Border shrink
     game.border_timer = game.border_timer - 1;
     if (game.border_timer <= 0) {
         shrink_border();
         game.border_timer = SHRINK_INTERVAL;
     }
     
-    // 更新 bossbar
+    // Update bossbar
     update_bar("hg_border", game.current_border);
     
-    // 检查边界伤害
+    // Check border damage
     check_border_damage();
     
-    // 检查存活人数
+    // Check alive count
     check_alive();
 }
 
@@ -182,13 +182,13 @@ fn shrink_border() {
         }
         
         // worldborder set game.current_border 60
-        announce("§c[饥饿游戏] §e边界正在缩小！当前大小：" + game.current_border);
+        announce("§c[Hunger Games] §eBorder is shrinking! Current size: " + game.current_border);
         
-        // 更新 bossbar
+        // Update bossbar
         bossbar_set_max("hg_border", INITIAL_BORDER);
         bossbar_set_value("hg_border", game.current_border);
         
-        // 颜色变化
+        // Color change
         if (game.current_border < 50) {
             bossbar_set_color("hg_border", "red");
         } else {
@@ -200,12 +200,12 @@ fn shrink_border() {
 }
 
 fn check_border_damage() {
-    // 对边界外的玩家造成伤害
-    // 需要检查玩家是否在边界外
+    // Deal damage to players outside the border
+    // Need to check if player is outside the border
     foreach (p in @a) {
-        // 简化：使用 execute positioned
+        // Simplified: using execute positioned
         let _dist: int = 0;  // TODO: calculate distance from center
-        // 如果超出边界，造成伤害
+        // If outside border, deal damage
         // effect(p, "minecraft:wither", 1, 0);
     }
 }
@@ -224,15 +224,15 @@ fn check_alive() {
     
     game.alive_count = alive;
     
-    // 更新记分板显示
-    actionbar(@a, "§c存活: " + alive + " 人");
+    // Update scoreboard display
+    actionbar(@a, "§cAlive: " + alive);
     
-    // 检查胜利
+    // Check for victory
     if (alive <= 1) {
         if (alive == 1) {
             declare_winner(winner);
         } else {
-            // 无人存活
+            // No survivors
             end_game_no_winner();
         }
     }
@@ -244,11 +244,11 @@ fn declare_winner(winner: selector) {
     
     let kills: int = scoreboard_get(winner, "hg_kills");
     
-    title(@a, "§6胜利者！");
-    announce("§c[饥饿游戏] §6游戏结束！");
-    announce("§a胜利者击杀数：" + kills);
+    title(@a, "§6Winner!");
+    announce("§c[Hunger Games] §6Game Over!");
+    announce("§aWinner's kills: " + kills);
     
-    // 胜利特效
+    // Victory effects
     totem_effect(winner);
     buff_all(winner, 200);
     
@@ -259,27 +259,27 @@ fn end_game_no_winner() {
     game.phase = 3;
     game.running = 0;
     
-    title(@a, "§7游戏结束");
-    subtitle(@a, "§c无人存活");
+    title(@a, "§7Game Over");
+    subtitle(@a, "§cNo survivors");
     
     remove_bar("hg_border");
 }
 
-// ===== 玩家死亡处理 =====
+// ===== Player Death Handler =====
 fn on_player_death(player: selector, killer: selector) {
     scoreboard_set(player, "hg_alive", 0);
     
-    // 更新击杀数
+    // Update kill count
     scoreboard_add(killer, "hg_kills", 1);
     
-    // 切换观察模式
+    // Switch to spectator mode
     // gamemode spectator player
     
     let kills: int = scoreboard_get(killer, "hg_kills");
-    announce("§c☠ §7玩家被击杀！击杀者已有 " + kills + " 杀");
+    announce("§c☠ §7A player was eliminated! Killer now has " + kills + " kills");
 }
 
-// ===== 重置游戏 =====
+// ===== Reset Game =====
 fn reset_game() {
     game.phase = 0;
     game.running = 0;
@@ -291,11 +291,11 @@ fn reset_game() {
         // gamemode survival p
     }
     
-    // 重置边界
+    // Reset border
     game.current_border = INITIAL_BORDER;
     // worldborder set 200
     
     remove_bar("hg_border");
     
-    announce("§c[饥饿游戏] §7游戏已重置");
+    announce("§c[Hunger Games] §7Game has been reset");
 }

package/src/examples/new_features_demo.mcrs

@@ -1,19 +1,19 @@
 /**
  * RedScript New Features Demo
- * 展示 2026-03-12 新增的语言特性
+ * Showcasing language features added on 2026-03-12
  */
 
 // ============================================
-// 1. 类型推断 (Type Inference)
+// 1. Type Inference
 // ============================================
 fn type_inference_demo() {
-    // 不需要写 `: int`，编译器自动推断
+    // No need to write `: int`, compiler infers automatically
     let health = 100;
     let name = "Steve";
     let alive = true;
     let speed = 1.5;
     
-    // NBT 后缀也能推断
+    // NBT suffixes can also be inferred
     let damage = 20b;      // byte
     let distance = 1000s;  // short
     let bignum = 999999L;  // long
@@ -23,25 +23,25 @@ fn type_inference_demo() {
 }
 
 // ============================================
-// 2. for-range 循环 (For-Range Loops)
+// 2. For-Range Loops
 // ============================================
 fn for_range_demo() {
-    // 从 0 到 9 循环
+    // Loop from 0 to 9
     for i in 0..10 {
         say("Count: ${i}");
     }
     
-    // 可以用于倒计时
+    // Can be used for countdown
     for sec in 0..5 {
         title(@a, "Starting in ${sec}...");
     }
 }
 
 // ============================================
-// 3. NBT 结构化参数 (NBT Structured Params)
+// 3. NBT Structured Params
 // ============================================
 fn nbt_params_demo() {
-    // 给予带 NBT 的物品
+    // Give item with NBT
     give(@s, "minecraft:diamond_sword", 1, {
         display: { Name: "Excalibur" },
         Enchantments: [
@@ -50,7 +50,7 @@ fn nbt_params_demo() {
         ]
     });
     
-    // 召唤带属性的实体
+    // Summon entity with attributes
     summon("minecraft:zombie", @s, {
         CustomName: "Boss Zombie",
         Health: 100.0,
@@ -61,31 +61,31 @@ fn nbt_params_demo() {
 }
 
 // ============================================
-// 4. Set 数据结构 (Runtime Set)
+// 4. Set Data Structure (Runtime Set)
 // ============================================
 fn set_demo() {
-    // 创建集合
+    // Create set
     let visited = set_new();
     
-    // 使用方法语法添加元素
+    // Add elements using method syntax
     visited.add("spawn");
     visited.add("castle");
     visited.add("dungeon");
     
-    // 检查是否存在
+    // Check if exists
     if (visited.contains("castle")) {
         say("You've been to the castle!");
     }
     
-    // 删除元素
+    // Remove element
     visited.remove("spawn");
     
-    // 清空集合
+    // Clear set
     visited.clear();
 }
 
 // ============================================
-// 5. 方法语法糖 (Method Syntax Sugar)
+// 5. Method Syntax Sugar
 // ============================================
 fn method_syntax_demo() {
     let items: string[] = [];
@@ -98,7 +98,7 @@ fn method_syntax_demo() {
     let count = items.len();
     say("You have ${count} items");
     
-    // Set 也可以用方法语法
+    // Sets can also use method syntax
     let tags = set_new();
     tags.add("vip");
     tags.add("admin");
@@ -109,44 +109,44 @@ fn method_syntax_demo() {
 }
 
 // ============================================
-// 6. #mc_name 语法 (MC Identifier Syntax)
+// 6. #mc_name Syntax (MC Identifier Syntax)
 // ============================================
 fn mc_name_demo() {
-    // #name 编译为裸 MC 名称（不带引号）
+    // #name compiles to bare MC name (without quotes)
     scoreboard_set(@s, #kills, 0);
     scoreboard_add(@s, #deaths, 1);
     
     let score = scoreboard_get(@s, #points);
     
-    // 用于 tag
+    // For tag
     tag_add(@s, #vip);
     
-    // 用于 team
+    // For team
     team_join(@s, #red);
     
-    // 对比：字符串仍需引号
+    // Comparison: strings still need quotes
     give(@s, "minecraft:diamond", 1);
 }
 
 // ============================================
-// 7. 块注释 (Block Comments)
+// 7. Block Comments
 // ============================================
 
 /* 
- * 这是块注释
- * 可以跨越多行
+ * This is a block comment
+ * Can span multiple lines
  */
 
 /**
- * 这是文档注释
- * @param player 目标玩家
+ * This is a doc comment
+ * @param player Target player
  */
 fn documented_function() {
     say("Hello!");
 }
 
 // ============================================
-// 综合示例：简单游戏
+// Combined Example: Simple Game
 // ============================================
 
 struct Player {
@@ -163,7 +163,7 @@ fn init_player() {
         visited: visited_set
     };
     
-    // 记录出生点（使用 set_add，因为 visited 是 string ID）
+    // Record spawn point (using set_add since visited is a string ID)
     set_add(p.visited, "spawn");
     
     scoreboard_set(@s, #score, p.score);
@@ -172,7 +172,7 @@ fn init_player() {
 
 @tick(rate=20)
 fn game_tick() {
-    // 每秒检查一次
+    // Check once per second
     for i in 0..1 {
         let score = scoreboard_get(@s, #score);
         if (score >= 100) {
@@ -183,7 +183,7 @@ fn game_tick() {
 }
 
 fn reward_player(amount: int) {
-    // 类型推断 + NBT 参数
+    // Type inference + NBT params
     let bonus = amount * 2;
     scoreboard_add(@s, #score, bonus);