Способности

Способности — стандартный способ реализации действий игрока с помощью:

• Единообразного UI кнопок, который хорошо работает на мобильных устройствах и ПК.

• Временами восстановления

• Необязательного прицеливания (тап/перетаскивание на мобильных, прицел мышью на ПК)

Способности являются для каждого игрока. Когда игрок присоединяется, 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 = "Dash";
        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 чтобы это работало как на ПК, так и на мобильных.

keybind_sprint: Keybind;

ao_before_scene_load :: proc() {
    keybind_sprint = Keybinds.register("Sprint", .SHIFT);
}

Sprint_Ability :: class : Ability_Base {
    on_init :: method() {
        name = "Sprint";
        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;
    }
}

Наводимые способности (перетаскивание для прицеливания на мобильных)

Если вы хотите поведение «всегда прицеливания» (прицел мышью + клик для выстрела на ПК, нажать-перетащить-отпустить на мобильных), используйте Ability_Utilities.full_update_aimed_ability:

Shoot_Ability :: class : Ability_Base {
    on_init :: method() {
        name = "Shoot";
        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;
        }
    }
}

Если вы хотите «клик для входа в режим прицеливания» (ПК переключает режим прицеливания; правый клик отменяет), используйте Ability_Utilities.full_update_targeted_aimed_ability:

Roll_Ability :: class : Ability_Base {
    on_init :: method() {
        name = "Roll";
        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 утилиты для удержания/прицеливания, чтобы мобильные устройства и ПК вели себя одинаково

• Разместите глобальные правила в Player.ao_can_use_ability, а не дублируйте для каждой способности