函数

基本函数

使用 fn 定义函数：

fn greet() {
    say("Hello, world!");
}

通过名称调用函数：

greet();

心智模型

RedScript 的函数仍然面向 datapack：它会编译成一个或多个 .mcfunction 文件，通常会读写记分板或 NBT 状态，并由 @load、@tick、事件或其他函数调用触发。

几个核心区别：

• 普通函数用于复用逻辑。
• 带装饰器的函数是 Minecraft 进入 RedScript 逻辑的入口。
• 名字以 _ 开头的函数遵循私有 helper 命名约定。你在源码中定义的 helper 仍会被输出；未被触达的导入库 helper 可能会被编译器剪枝。
• target: selector 这类参数携带 Minecraft 目标上下文；@s 表示当前 execute 主体，不是某个固定玩家。

参数

函数可以接受带类型注解的参数：

fn heal(target: selector, amount: int) {
    effect(target, "instant_health", amount, 1);
    say("Healed!");
}

heal(@a, 2);

返回类型

使用 -> 指定返回类型：

fn double(x: int) -> int {
    return x * 2;
}

let result: int = double(5); // 10

编译器同时接受 fn f() -> T 和旧的 fn f(): T 返回类型写法。新的 guide 示例优先使用 ->，因为它更容易和参数类型注解区分。

没有返回值的函数不需要写 -> void：

fn announce(msg: string) {
    say(msg);
}

默认参数

参数可以有默认值：

fn spawn_mob(mob: string, count: int = 1) {
    repeat(count) {
        summon(mob);
    }
}

spawn_mob("zombie");       // 生成 1 只僵尸
spawn_mob("skeleton", 5);  // 生成 5 只骷髅

多个参数

fn setup_team(team_name: string, color: string, friendly_fire: bool = false) {
    team_add(team_name);
    team_modify(team_name, "color", color);
    if (!friendly_fire) {
        team_modify(team_name, "friendlyFire", "false");
    }
}

setup_team("red", "red");
setup_team("blue", "blue", true);

调用函数

函数编译为 .mcfunction 文件。它们可以通过以下方式调用：

• 从其他函数调用
• 通过装饰器如 @tick 和 @load 自动调用
• 在游戏内作为命令目标通过 /function namespace:function_name 调用

@load
fn init() {
    setup_team("red", "red");
    setup_team("blue", "blue");
    say("Teams ready!");
}

范围循环

使用 for i in start..end 遍历整数范围。上界可以是变量：

fn give_reward(player: selector, count: int) {
    for i in 0..count {
        give(player, "diamond", 1);
    }
}

give_reward(@s, 5);   // 给予 5 颗钻石

两个边界都可以是变量：

let start: int = 1;
let end: int = 10;
for i in start..end {
    say(f"{i}");
}

范围是左闭右开的（0..5 遍历 0、1、2、3、4）。

仅声明函数

使用 declare fn 声明函数签名而不提供函数体。用于声明文件（如 builtins.d.mcrs）中，向类型检查器描述内置函数：

// builtins.d.mcrs
declare fn say(msg: string);
declare fn give(target: selector, item: string, count: int);
declare fn effect(target: selector, effect: string, duration: int, amplifier: int);

declare fn 桩函数不会被编译为 .mcfunction 文件 — 它们仅用于类型检查和 IDE 支持。

下一步

• 装饰器 — 自动触发函数
• Lambda 表达式 — 内联函数表达式