Economy

API экономики позволяют создавать собственные валюты (монеты, драгоценные камни, XP и т. д.) и автоматически сохранять их для каждого игрока между сессиями.

• Каждая валюта хранится для каждого игрока
• Баланс автоматически сохраняется между сессиями
• Баланс можно просматривать/редактировать в портале создателя (см. Редактирование/просмотр данных игрока)

Справочник API экономики

Economy :: struct {
    register_currency     :: proc(currency: string, icon: Texture_Asset);
    deposit_currency      :: proc(player: Player, currency: string, amount: s64);
    get_balance           :: proc(player: Player, currency: string) -> s64;
    can_withdraw_currency :: proc(player: Player, currency: string, amount: s64) -> bool;
    withdraw_currency     :: proc(player: Player, currency: string, amount: s64);
    delete_save_data      :: proc(player: Player);
}

Регистрация валюты (один раз)

Прежде чем использовать название валюты, зарегистрируйте его с иконкой.

ao_before_scene_load :: proc() {
    // Выберите иконку из вашей папки /res
    coin_icon := get_asset(Texture_Asset, "ui/coin.png");

    Economy.register_currency("Coins", coin_icon);
    Economy.register_currency("XP", coin_icon); // пример (в идеале используйте другую иконку)
}

Названия валют — это просто строки. Выберите единообразное название и придерживайтесь его (например "Coins" по сравнению с "coins").

Чтение баланса игрока

coins := Economy.get_balance(player, "Coins");

Выдача валюты (награды)

Используйте deposit_currency каждый раз, когда игрок получает валюту.

on_enemy_killed :: proc(player: Player) {
    Economy.deposit_currency(player, "Coins", 10);
    Economy.deposit_currency(player, "XP", 3);
}

Трата валюты (магазины/улучшения)

Всегда проверяйте can_withdraw_currency перед снятием. Суммы пополнения и снятия должны быть неотрицательными.

UPGRADE_COST :: 50;

try_buy_upgrade :: proc(player: Player) -> bool {
    if !Economy.can_withdraw_currency(player, "Coins", UPGRADE_COST) {
        Notifier.notify(player, "Недостаточно монет!");
        return false;
    }

    Economy.withdraw_currency(player, "Coins", UPGRADE_COST);

    // Предоставьте улучшение здесь...
    Notifier.notify(player, "Улучшение куплено!");
    return true;
}

Встроенные магазины

Магазин содержит категории, а каждая категория содержит товары. Создайте магазин после регистрации его валют. Храните его хэндлы в полевых переменных уровня сцены или глобальных переменных, потому что они действительны только для текущей сцены.

shop: u64;

grant_shop_product :: proc(
    player: Player,
    product: u64,
    полем userdata: Object
) -> bool {
    if Game_Product.get_id(product) == "health_upgrade" {
        player.max_health += 10;
        return true;
    }

    // Возврат false отменяет покупку и не списывает средства с игрока.
    return false;
}

ao_before_scene_load :: proc() {
    coin_icon := get_asset(Texture_Asset, "ui/coin.png");
    Economy.register_currency("Coins", coin_icon);

    shop = Economy.create_shop("upgrade_shop");
    upgrades := Shop.add_category(shop, "Upgrades");

    Shop_Category.add_product(
        upgrades,
        "health_upgrade",
        "Улучшение здоровья",
        "Добавляет 10 к максимальному здоровью.",
        "ui/health_upgrade.png",
        "Coins",
        50,
        "",
        Item_Rarity.COMMON.(s64),
        ""
    );

    Shop.set_purchase_handler(shop, null, grant_shop_product);
}

Обработчик покупки должен предоставить товар и вернуть true. Возврат false отклоняет покупку.

Отрисовывайте магазин из кода интерфейса игрока. Shop.draw возвращает true пока магазин остаётся открытым:

Player :: class : Player_Base {
    max_health: int = 100;
    shop_open: bool;

    ao_late_update :: method(dt: float) {
        if !is_local_or_server() return;

        if shop_open {
            shop_open = Shop.draw(shop, UI.get_safe_screen_rect());
        }
    }
}

Shop.set_purchase_modifier может изменять цену товара или кнопку для каждого игрока. Shop.set_custom_display может заменять отрисовку карточки товара. Оба колбэка используют тот же явный userdata шаблон, что и обработчик покупки.

Сброс экономических данных игрока

Если вам нужно очистить все балансы экономики для игрока (например, кнопка сброса админом или сброс игрового режима), вы можете удалить его сохранённые данные экономики:

reset_economy :: proc(player: Player) {
    Economy.delete_save_data(player);
    Notifier.notify(player, "Ваши экономические данные были сброшены.");
}

Economy.delete_save_data является разрушительной операцией. Используйте её экономно и подумайте о добавлении подтверждений/доступа только для админов.

Экономика vs Сохранение

• Используйте Экономика для «валют» (монеты, самоцветы, XP, билеты), где вам нужны автоматическое сохранение + редактирование в портале.
• Используйте Сохранение для всего остального (настройки, состояние квестов, списки разблокировок, сложные структуры прогресса). См. Система сохранения