APIs de compra/productos

Los jugadores pueden comprar productos (game passes + consumibles) por Sparks en tu juego. Cuando ocurre una compra, All Out llama a tu manejador de compras para que puedas otorgar el objeto o la función.

Para crear productos y ver analíticas, consulta Productos dentro del juego.

Tipos de productos (resumen rápido)

• Game passes: desbloqueos persistentes de una sola vez (pase de administrador, habilidad permanente, propiedad de una casa)

• Consumibles: se pueden comprar varias veces (poción, mejora temporal, paquete de monedas de un solo uso)

Los tipos de productos se configuran en el portal del creador. Consulta Productos dentro del juego.

Referencia de la API de compras

Product :: struct {
    id: string;
    name: string;
    description: string;
    price: s64;
    consumable: bool;
    icon: Texture_Asset;
}

Purchasing :: struct {
    prompt_purchase :: proc(player: Player, id: string);
    owns_product    :: proc(player: Player, id: string) -> bool;
    get_product     :: proc(id: string) -> Product;
}

Cómo solicitar una compra

Para iniciar el flujo de compra, llama a Purchasing.prompt_purchase con un ID de producto.

BUY_DOUBLE_JUMP_ID :: "prod_double_jump";

try_prompt_double_jump :: proc(player: Player) {
    Purchasing.prompt_purchase(player, BUY_DOUBLE_JUMP_ID);
}

El ID del producto se muestra en la página de monetización/productos del portal del creador (puedes hacer clic para copiarlo). Consulta Productos dentro del juego.

Comprobar si un jugador posee un producto (game passes)

Para los game passes, puedes restringir funciones del juego comprobando la propiedad.

ADMIN_PASS_ID :: "prod_admin";

is_admin :: proc(player: Player) -> bool {
    return Purchasing.owns_product(player, ADMIN_PASS_ID);
}

Los consumibles se pueden comprar varias veces; no se debe usar owns_product para otorgarlos. Normalmente, los consumibles se conceden en tu manejador de compras (monedas, objetos, mejoras, etc.).

Leer información del producto (nombre/precio/icono)

Si quieres mostrar una interfaz de “Comprar” o registrar información del producto, obtén la definición del producto por ID:

product := Purchasing.get_product("prod_double_jump");
log_info("Producto % cuesta % sparks", {product.name, product.price});

El manejador de compras (otorgamiento)

Cuando un jugador compra un producto en tu juego, All Out llama a:

ao_purchase_handler :: proc(player: Player, id: string) -> bool

Debes:

• Hacer un switch sobre el ID del producto

• Otorgar el objeto/la función

• Devolver true si la concesión tuvo éxito

• Devolver false si la concesión falló (inventario lleno, prerequisito faltante, etc.)

COIN_PACK_ID :: "prod_coin_pack_small";
DOUBLE_JUMP_ID :: "prod_double_jump";

ao_purchase_handler :: proc(player: Player, id: string) -> bool {
    switch id {
        case COIN_PACK_ID: {
            // Ejemplo: otorgar monedas (consumible)
            Economy.deposit_currency(player, "Coins", 500);
            Notifier.notify(player, "¡Gracias! +500 monedas");
            return true;
        }
        case DOUBLE_JUMP_ID: {
            // Ejemplo: desbloqueo de game pass (persistente)
            // Normalmente solo lo habilitas mediante comprobaciones de owns_product() en otro lugar.
            // Aun así, devuelve true para que la compra se considere otorgada.
            Notifier.notify(player, "¡Salto doble desbloqueado!");
            return true;
        }
    }

    // ID desconocido
    return false;
}

Fallos de concesión y reintentos

Si tu manejador de compras devuelve false, la compra se marca como un fallo de concesión.

• Los fallos de concesión se muestran en el portal del creador

• Se reintentan automáticamente cuando el jugador se conecta hasta que tengan éxito

• Puedes volver a ejecutar manualmente un manejador de compras marcando una compra como “no concedida” en la interfaz de datos del jugador

Ver:

• Productos dentro del juego (“Manejadores de compras / Fallos de concesión”)

• Editar/ver datos de jugadores (sección “Compras”)

Entre juegos (hub + minijuegos)

Si usas parenting de juegos, las compras se pueden compartir entre tus juegos. Consulta Productos/datos entre juegos.