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);
}

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

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

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

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

Названия валют — это просто строки. Выберите единообразное название и придерживайтесь его (например "Coins" vs "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;
}

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

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

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

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

Экономика vs Save

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

• Используйте Save для всего остального (настройки, состояние заданий, списки разблокировок, сложные структуры прогресса). См. Система сохранений