APIs de Compra/Producto

Los jugadores pueden comprar productos (pases de juego + 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 análisis, consulta Productos Dentro del Juego.

Tipos de producto (resumen rápido)

• Pases de juego: desbloqueos persistentes y de una sola vez (pase de administrador, habilidad permanente, propiedad de casa)

• Consumibles: se pueden comprar varias veces (poción, mejora temporal, paquete de monedas de una sola vez)

Los tipos de producto 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;
}

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 monetización/productos del portal del creador (puedes hacer clic para copiarlo). Consulta Productos Dentro del Juego.

Comprobar si un jugador posee un producto (pases de juego)

Para los pases de juego, puedes restringir funciones de 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. Los consumibles suelen otorgarse 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("Product % costs % 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

Deberías:

• Hacer switch con el ID del producto

• Otorgar el objeto/la función

• Devolver true si el otorgamiento tuvo éxito

• Devolver false si el otorgamiento falló (inventario lleno, requisito previo 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 pase de juego (persistente)
            // Normalmente simplemente lo habilitas mediante comprobaciones owns_product() en otras partes.
            // Aún así devuelve true para que la compra se considere otorgada.
            Notifier.notify(player, "¡Salto doble desbloqueado!");
            return true;
        }
    }

    // ID desconocido
    return false;
}

Fallas de otorgamiento y reintentos

Si tu manejador de compras devuelve false, la compra se marca como una falla de otorgamiento.

• Las fallas de otorgamiento se muestran en el portal del creador

• Se reintentará automáticamente cuando el jugador se una hasta que tengan éxito

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

Ver:

• Productos Dentro del Juego ("Manejadores de compras / Fallas de otorgamiento")

• Editar/Ver Datos del Jugador (sección "Compras")

Entre juegos (hub + minijuegos)

Si usas parentazgo de juegos, las compras pueden compartirse entre tus juegos. Consulta Productos/Datos entre Juegos.