函数

基本函数

使用 fn 定义函数：

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

通过名称调用函数：

greet();

参数

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

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 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!");
}

下一步

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