Интерактивные объекты

Компонент Interactable

Добавление компонента Interactable к сущности автоматически показывает интерфейс, когда игрок находится в пределах Радиуса который вы указываете.

Чтобы реагировать на нажатие игроком интерактива, вам нужно написать код на CSL.

Наиболее распространённый шаблон:

• Создайте класс, который наследуется от Interactable

• Вызвать this->set_listener(this) в ao_start

• Реализуйте 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("Купить Admin Pass");
        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) {
    }
}