Economía

Las APIs de economía te permiten crear monedas personalizadas (monedas, gemas, XP, etc.) y persistirlas automáticamente para cada jugador entre sesiones.

• Cada moneda se almacena por jugador

• Los saldos se persisten automáticamente entre sesiones

• Los saldos se pueden ver/editar en el portal del creador (consulta Editar/ver datos de jugadores)

Referencia de la API de Economía

Economía :: 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);
}

Registrar una moneda (una sola vez)

Antes de usar un nombre de moneda, regístralo con un icono.

// Elige un icono de tu carpeta /res
coin_icon := get_asset(Texture_Asset, "ui/coin.png");

Economy.register_currency("Coins", coin_icon);
Economy.register_currency("XP", coin_icon); // ejemplo (idealmente usa un icono diferente)

Los nombres de las monedas son solo cadenas. Elige un nombre coherente y manténlo (por ejemplo "Coins" frente a "coins").

Leer el saldo de un jugador

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

Dar moneda (recompensas)

Usa deposit_currency cada vez que un jugador gane moneda.

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

Gastar moneda (tiendas/mejoras)

Comprueba siempre can_withdraw_currency antes de retirar.

UPGRADE_COST :: 50;

try_buy_upgrade :: proc(player: Player) -> bool {
    if !Economy.can_withdraw_currency(player, "Coins", UPGRADE_COST) {
        Notifier.notify(player, "¡No tienes suficientes monedas!");
        return false;
    }

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

    // Otorga la mejora aquí...
    Notifier.notify(player, "¡Mejora comprada!");
    return true;
}

Restablecer los datos de economía de un jugador

Si necesitas borrar todos los saldos de economía de un jugador (por ejemplo, un botón de reinicio para administradores o un reinicio del modo de juego), puedes eliminar sus datos guardados de economía:

reset_economy :: proc(player: Player) {
    Economy.delete_save_data(player);
    Notifier.notify(player, "Se restablecieron tus datos de economía.");
}

Economy.delete_save_data es destructivo. Úsalo con moderación y considera añadir confirmaciones/acceso solo para administradores.

Economía vs Guardado

• Usa Economía para "monedas" (monedas, gemas, XP, tickets) cuando quieras persistencia automática + edición en el portal.

• Usa Guardado para todo lo demás (ajustes, estado de misiones, listas de desbloqueos, estructuras complejas de progreso). Consulta Sistema de guardado