Exports (Desarrolladores)

Si deseas interactuar con los datos del estatus VIP o saldo de puntos de los jugadores desde los demás scripts de tu servidor, tienes a tu disposición la siguiente gama de exports (del lado del Servidor/Server-side):

Obtener la Tabla de VIP

GetPlayerVipData(player)

Retorna la tabla completa de la base de datos que contiene el nivel, los puntos y las expiraciones asociadas a ese jugador.

local vipData = exports['dalton_vips']:GetPlayerVipData(source)
if vipData then
    print("Nivel:", vipData.vip_level)
    print("Puntos:", vipData.vip_points)
end

Nombre del Nivel VIP

GetVipLevelName(player)

Retorna un string con el nombre del VIP actual que ostenta el jugador (Ej: "Bronce", "Plata", o "Sin VIP").

local vipName = exports['dalton_vips']:GetVipLevelName(source)
if vipName == "Oro" then
    print("¡El jugador es VIP Oro!")
end

Obtener Puntos

GetPointsUser(player)

Retorna un valor numérico equivalente a la cantidad de puntos VIP que posee el jugador.

local points = exports['dalton_vips']:GetPointsUser(source)
if points >= 500 then
    print("Tienes más de 500 puntos.")
end

Añadir Puntos VIP

AddVipPoints(player, amount, source, reason)

Otorga una cantidad definida de puntos a la cuenta del jugador.

-- Otorga 100 puntos al jugador. `source` y `reason` son opcionales para usarlo en los logs.
local success, msg = exports['dalton_vips']:AddVipPoints(player, 100, nil, "Recompensa de evento")
if success then
    print("Puntos añadidos correctamente.")
end

Retirar Puntos VIP

RemoveVipPoints(player, amount, source, reason)

Retira una cantidad de puntos al jugador.

-- Retira 50 puntos al jugador
local success, msg = exports['dalton_vips']:RemoveVipPoints(player, 50, nil, "Compra de ítem especial")
if success then
    print("Puntos retirados correctamente.")
else
    print("Error:", msg) -- Podría ser porque no tiene suficientes puntos en el balance
end

Forzar Compra de VIP

BuyVipLevel(player, levelName)

Fuerza la compra de un rango VIP consumiendo los puntos del usuario de forma lógica interna.

-- Compra el VIP "Plata" para el jugador si tiene los puntos correspondientes
local success, msg = exports['dalton_vips']:BuyVipLevel(player, "Plata")
if success then
    print("VIP comprado exitosamente.")
end

Forzar Código de Referido

UseReferralCode(player, code)

Fuerza el intento de canje de un código de referido específico para el usuario determinado.

local success, msg = exports['dalton_vips']:UseReferralCode(source, "BIENVENIDA2026")
if success then
    print("Código canjeado con éxito.")
else
    print("No se pudo usar el código:", msg)
end