技能

能力是实现玩家动作的标准方式，适用于：

• 一致的按钮界面，在移动端和 PC 上都很好用。
• 冷却
• 可选瞄准（移动端轻触/拖动，PC 上鼠标瞄准）

能力是 每个玩家. 当玩家加入时，All Out 会为每种能力类型创建一个实例，并将其存储在 player.abilities.

快速开始（绘制能力按钮）

在以下位置绘制能力按钮 Player.ao_late_update，在 is_local_or_server():

Player :: class : Player_Base {
    ao_late_update :: method(dt: float) {
        if this.is_local_or_server() {
            draw_ability_button(this, Shoot_Ability, 0);  // 大号主按钮
            draw_ability_button(this, Dodge_Roll, 1);     // 小按钮
        }
    }
}

按钮索引映射到固定的屏幕位置。索引 0 是大的主按钮；索引 1-5 是其周围较小的按钮。

能力 API 参考

Ability_Base :: class {
    player: Player;

    name: string;
    icon: Texture_Asset;

    current_cooldown: float;
    type: typeid;
    is_aimed_ability: bool;
    mouse_position_on_press: v2;

    keybind_override: Keybind;
    disable_keybind: bool;
    draw_but_dont_use_keybind: bool; // 显示按键提示，但输入由你自己处理。

    #interface on_update      :: proc(ability: Ability_Base, params: ref Ability_Update_Params);
    #interface can_use        :: proc(ability: Ability_Base) -> bool;
    #interface on_draw_button :: proc(ability: Ability_Base, rect: Rect);
}

Ability_Update_Params :: struct : Interact_Result {
    can_use: bool;        // 冷却 + can_use + Player.ao_can_use_ability（如果存在）
    drag_offset: v2;      // 0..1
    drag_direction: v2;   // 单位方向
}

draw_ability_button :: proc(player: Player, $T: typeid, index: int);

创建一个能力（基础点击）

Dash_Ability :: class : Ability_Base {
    on_init :: method() {
        name = "冲刺";
        icon = get_asset(Texture_Asset, "icons/dash.png");
    }

    can_use :: method() -> bool {
        // 可选的额外限制（除冷却外）
        return true;
    }

    on_update :: method(params: ref Ability_Update_Params) {
        if params.clicked && params.can_use {
            // 在这里应用玩法逻辑。此路径会经过客户端预测并在服务器上执行。
            // ...

            // 重要：在激活时设置冷却
            current_cooldown = 1.5;
        }
    }
}

持续型能力（按住时生效）

对于按住时激活的能力（冲刺、护盾、光束），使用 Ability_Utilities.update_holding_ability 这样它在 PC 和移动端都能正常工作。

keybind_sprint: Keybind;

ao_before_scene_load :: proc() {
    keybind_sprint = Keybinds.register("冲刺", .LEFT_SHIFT);
}

Sprint_Ability :: class : Ability_Base {
    on_init :: method() {
        name = "冲刺";
        draw_but_dont_use_keybind = true;
        keybind_override = keybind_sprint;
    }

    on_update :: method(params: ref Ability_Update_Params) {
        holding := Ability_Utilities.update_holding_ability(player, ref params, keybind_sprint);
        player.is_sprinting = holding.active;
    }
}

瞄准型能力（移动端拖动瞄准）

如果你想要“始终瞄准”的行为（PC 上鼠标瞄准 + 点击发射，移动端按下-拖动-松开），使用 Ability_Utilities.full_update_aimed_ability:

Shoot_Ability :: class : Ability_Base {
    on_init :: method() {
        name = "射击";
        is_aimed_ability = true;
        disable_keybind = true;
    }

    on_update :: method(params: ref Ability_Update_Params) {
        activation := Ability_Utilities.full_update_aimed_ability(player, ref params);

        if activation.activate && params.can_use {
            // activation.direction 是一个单位向量
            // shoot_projectile(player.entity.world_position, activation.direction);
            current_cooldown = 0.5;
        }
    }
}

如果你想要“点击进入瞄准模式”的行为（PC 切换瞄准模式；右键取消），使用 Ability_Utilities.full_update_targeted_aimed_ability:

Roll_Ability :: class : Ability_Base {
    on_init :: method() {
        name = "翻滚";
        is_aimed_ability = true;
    }

    on_update :: method(params: ref Ability_Update_Params) {
        activation := Ability_Utilities.full_update_targeted_aimed_ability(player, this, ref params);
        if activation.activate && params.can_use {
            current_cooldown = 1.25;
        }
    }
}

全局能力限制（可选）

实现 ao_can_use_ability 在你的 Player 类中实现，以强制执行全局规则（死亡玩家不能使用能力、过场动画期间禁用等）。

Player :: class : Player_Base {
    ao_can_use_ability :: method(ability: Ability_Base) -> bool {
        if health.is_dead return false;
        return true;
    }
}

最佳实践

• 始终在 ao_late_update 并用 is_local_or_server()
• 当 current_cooldown 在激活时进行保护（否则会被连续触发）
• 使用 Ability_Utilities 用于按住/瞄准的辅助工具，使移动端和 PC 的行为保持一致
• 将全局规则放在 Player.ao_can_use_ability，不要在每个能力中重复实现