可交互对象

可交互组件

向实体添加可交互组件将在玩家处于您指定的 半径 时自动显示界面。

要响应玩家按下可交互对象，您需要编写 CSL 代码。

最常见的模式是：

• 创建一个继承自 Interactable

• 调用 this->set_listener(this) 在 尤其是

• 在您的类中实现 can_use 和 on_interact 如果您在代码中添加了新的可交互类，仍然需要在编辑器中将该组件添加到实体（或在运行时生成实体并添加该组件）。

如果您在代码中添加了新的可交互类，仍然需要在编辑器中将该组件添加到实体（或在运行时生成实体并添加该组件）。

垃圾示例

// 捡起垃圾可获得硬币 :D 
Trash :: class : Interactable {
    coins: s64 @ao_serialize;
    used: bool;

    ao_start :: method() {
        this->set_listener(this);
        this->set_text("捡起垃圾");
        this->set_hold_text("正在捡起...");
        required_hold_time = 0.25;
        radius = 1.25;
    }

    can_use :: method(player: Player) -> bool {
        if used return false;
        return true;
    }

    on_interact :: method(player: Player) {
        used = true;
        Economy.deposit_currency(player, "Coins", coins);
        entity->destroy();
    }
}

增长示例

一个会（一次性地）“放大”实体的可交互对象：

Grow_Button :: class : Interactable {
    scale_multiplier: float @ao_serialize;
    used: bool;

    ao_start :: method() {
        this->set_listener(this);
        this->set_text("放大");
        radius = 1.25;
        required_hold_time = 0;
    }

    can_use :: method(player: Player) -> bool {
        return !used;
    }

    on_interact :: method(player: Player) {
        used = true;
        new_scale := entity.local_scale * scale_multiplier;
        entity->set_local_scale(new_scale);
        this->set_text("已使用");
    }
}

购买提示示例

一个提示购买商品的可交互对象：

Buy_Admin_Pass :: class : Interactable {
    product_id: string @ao_serialize;

    ao_start :: method() {
        this->set_listener(this);
        this->set_text("购买管理员通行证");
        radius = 1.25;
    }

    can_use :: method(player: Player) -> bool {
        // 示例门控：如果已拥有则隐藏（游戏通行证）
        return !Purchasing.owns_product(player, product_id);
    }

    on_interact :: method(player: Player) {
        Purchasing.prompt_purchase(player, product_id);
    }
}

API 参考

Interactable :: class : Component {
    // 提示文本（点击交互）
    get_text :: method() -> string;
    set_text :: method(text: string);

    // 持续按住时的提示文本（用于按住交互）
    get_hold_text :: method() -> string;
    set_hold_text :: method(text: string);

    // 连接一个实现了以下方法的监听器对象：
    // - can_use(player: Player) -> bool
    // - on_interact(player: Player)
    // - on_holding(player: Player) [可选]
    set_listener :: method(new_listener: Component);

    // 常用字段（在编辑器或代码中设置）
    prompt_offset: v2;
    radius: float;
    required_hold_time: float;
    priority: s64;
}

可选的玩家钩子（全局规则）

您也可以在您的 Player 类上实现这些以强制执行全局规则（例如：重生前无法使用可交互对象）：

Player :: class : Player_Base {
    ao_can_use_interactable :: method(interactable: Interactable) -> bool {
        return true;
    }

    ao_on_interactable_used :: method(interactable: Interactable) {
    }

    ao_on_holding_interactable :: method(interactable: Interactable) {
    }
}