Giveaway

Crea giveaways directamente en el juego: inícialos al momento o guárdalos como plantilla, que si quieres se inicia automáticamente a horas fijas. Los jugadores participan con una tecla o un comando, los ganadores se sortean en vivo con una ruleta de nombres. El script crea las tablas por sí mismo.

Funciones

• Menú de admin (/giveawayadmin): Crea giveaways en una sola página (premios, duración, ganadores, opcionalmente un nombre), con vista previa en vivo de cómo lo ven los jugadores.
• Premios: Items, armas, dinero (efectivo, banco, dinero negro o cuentas propias) y vehículos. Todos los vehículos del juego, también los addon, están disponibles con imagen y categoría.
• Premio fijo o lotería: O cada ganador recibe todo lo de la lista, o cada uno saca un premio según su probabilidad, p. ej. 60 % dinero, 30 % banco, 10 % vehículo.
• Reglas: Número de ganadores, cuota de entrada, duración, máximo y mínimo de participantes. Si se juntan muy pocos, se cancela y se reembolsa.
• Plantillas: Guarda giveaways e inícialos o duplícalos con un clic, o ajústalos en la pestaña Crear.
• Iniciar automáticamente: Se activa por plantilla, en días de la semana y horas fijas, p. ej. cada viernes a las 20:00 y a las 22:30. Opcionalmente solo si hay suficientes jugadores conectados.
• Historial: Controla el giveaway en curso en vivo (sortear ya o cancelar) y consulta los últimos 50 giveaways con sus ganadores.
• Aviso para jugadores: Arriba en la pantalla con premios, temporizador y número de participantes. Participas con G o /giveaway, H muestra y oculta el aviso.
• Entrega posterior: Si un premio no cabe en el inventario o el ganador está desconectado, se guarda y se entrega automáticamente más tarde.
• Logs de Discord para acciones de admin, giveaways y cada premio entregado.

Instalación

1. Pon la carpeta off_giveaway en resources.
2. En el server.cfg, después de oxmysql y ESX:

ensure oxmysql
ensure es_extended
ensure off_giveaway

1. Añade tu grupo en admin.groups y abre /giveawayadmin.

Configuración

config/settings/config.lua

Añadir una cuenta propia como premio, p. ej. fichas de casino:

accounts = {
  { name = 'money',  label = 'Bargeld' },
  { name = 'bank',   label = 'Bank' },
  { name = 'chips',  label = 'Casino-Chips' },
},

config/functions.lua

Aquí conectas tus propios scripts. Los errores dentro se capturan, el script sigue funcionando.

config/settings/config.server.lua e idiomas

Webhooks de Discord para admin (plantillas), giveaway (inicio, sorteo, cancelación) y rewards (cada premio), url = '' desactiva un log. Todos los textos están en config/locales/ (un archivo por idioma).

En el juego

• Menú de admin (/giveawayadmin): Arriba cambias entre Crear, Plantillas e Historial. Si hay un giveaway en curso, arriba un aviso LIVE muestra el tiempo restante.
• Crear: Responde tres preguntas: qué se puede ganar, cuánto dura, cuántos ganan. El nombre es opcional, todo lo demás está en Más ajustes. A la derecha ves el aviso tal como lo ven los jugadores. Iniciar giveaway lo inicia al momento, Como plantilla lo guarda. Cargar plantilla carga una plantilla guardada para ajustarla.
• Premios: Arriba eliges el tipo. Item, arma y vehículo abren una lista con imagen y búsqueda, el dinero añade directamente una cantidad. En las armas, la cantidad es la munición. En la Lotería (en Más ajustes) le das a cada premio una probabilidad, 100 % en total. Repartir igual las reparte por igual.
• Plantillas: A la izquierda la lista, a la derecha el editor: arriba el nombre, debajo las mismas preguntas que al crear. El nombre de la plantilla es también el nombre que ven los jugadores. En lugar del nombre, el punto 4 pregunta por Iniciar automáticamente: elige días de la semana y hasta 6 horas, debajo aparece el próximo inicio, opcionalmente Mínimo en línea. Solo Guardar aplica los cambios. Iniciar ahora inicia la plantilla al momento, Ajustar e iniciar la abre en la pestaña Crear. La hora es la del servidor.
• Historial: Arriba controlas el giveaway en curso, debajo están las estadísticas y los últimos 50 giveaways. Un clic en una entrada muestra los ganadores con sus premios.
• Participar: Cuando empieza un giveaway, el aviso aparece arriba a todos los jugadores. Con G o /giveaway participas, la cuota de entrada se cobra primero del efectivo y si no, del banco. H reduce el aviso a una barra pequeña y lo vuelve a abrir.
• Sorteo: Cuando se acaba el tiempo o un admin sortea, los ganadores salen uno tras otro con la ruleta de nombres. Después todos ven la lista de ganadores, los ganadores reciben además un mensaje. Sin Sorteo animado la lista aparece al momento.
• Los vehículos ganados quedan aparcados en el garaje (owned_vehicles) con su propia matrícula, aunque el ganador esté desconectado.
• Entrega posterior: Si el inventario está lleno o el ganador está desconectado, recibe el premio automáticamente en cuanto haya sitio o vuelva a conectarse. Las cuotas reembolsadas a jugadores desconectados funcionan igual.

Para desarrolladores

-- Servidor
local active = exports.off_giveaway:GetActiveGiveaway()        -- nil si no hay ninguno en curso
local member = exports.off_giveaway:IsMember(source)
local ok, err = exports.off_giveaway:StartPreset('p_friday', 'Discord-Bot')
local ok, err = exports.off_giveaway:StartGiveaway({
  title = 'Event-Giveaway',
  mode = 'fixed',
  rewards = { { kind = 'account', name = 'bank', amount = 50000 } },
  winners = 1,
  duration = 600,
  maxMembers = 500,
}, 'Event-Team')
local ok, err = exports.off_giveaway:DrawGiveaway()
local ok, err = exports.off_giveaway:CancelGiveaway()

-- Cliente
local active = exports.off_giveaway:IsGiveawayActive()
local joined = exports.off_giveaway:HasJoined()

En StartGiveaway, duration va en segundos (mínimo 30). Son opcionales description, entryFee, minMembers y options = { reel = false } (sin sorteo animado).

Premios en StartGiveaway: kind = item, weapon, account o vehicle, además de name y amount. En los vehículos también category (car, bike, boat, heli, plane) y label. En la lotería (mode = 'pool') cada premio necesita una chance, 100 en total.

Problemas frecuentes

Al iniciar, el script informa de errores y avisos en la consola del servidor.