Giveaway

Crea giveaway direttamente in gioco: avviali subito o salvali come modello, che se vuoi parte automaticamente a orari fissi. I giocatori partecipano con un tasto o un comando, i vincitori vengono estratti dal vivo con una ruota di nomi. Le tabelle le crea lo script da solo.

Funzionalità

• Menu admin (/giveawayadmin): Crea giveaway su un'unica pagina (premi, durata, vincitori, facoltativamente un nome), con anteprima live di come li vedono i giocatori.
• Premi: Item, armi, soldi (contanti, banca, soldi sporchi o conti personalizzati) e veicoli. Tutti i veicoli del gioco, anche quelli addon, sono disponibili con immagine e categoria.
• Premio fisso o lotteria: O ogni vincitore riceve tutto quello che c'è nella lista, o ognuno estrae un premio in base alla probabilità, ad es. 60 % soldi, 30 % banca, 10 % veicolo.
• Regole: Numero di vincitori, quota d'ingresso, durata, numero massimo e minimo di partecipanti. Se se ne raccolgono troppo pochi, il giveaway viene annullato e rimborsato.
• Modelli: Salva i giveaway e avviali o duplicali con un clic, oppure modificali nella scheda Crea.
• Avvio automatico: Attivabile per ogni modello, in giorni della settimana e orari fissi, ad es. ogni venerdì alle 20:00 e alle 22:30. Facoltativamente solo se ci sono abbastanza giocatori online.
• Cronologia: Controlla dal vivo il giveaway in corso (estrai ora o annulla) e consulta gli ultimi 50 giveaway con i vincitori.
• Riquadro giocatori: In alto sullo schermo con premi, timer e numero di partecipanti. Partecipi con G o /giveaway, H mostra e nasconde il riquadro.
• Consegna successiva: Se un premio non entra nell'inventario o il vincitore è offline, viene salvato e consegnato automaticamente in seguito.
• Log Discord per azioni admin, giveaway e ogni premio consegnato.

Installazione

1. Metti la cartella off_giveaway in resources.
2. Nel server.cfg, dopo oxmysql ed ESX:

ensure oxmysql
ensure es_extended
ensure off_giveaway

1. Inserisci il tuo gruppo in admin.groups e apri /giveawayadmin.

Configurazione

config/settings/config.lua

Aggiungere un tuo conto come premio, ad es. fiches del casinò:

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

config/functions.lua

Qui colleghi i tuoi script. Gli errori al loro interno vengono intercettati, lo script continua a funzionare.

config/settings/config.server.lua e lingue

Webhook Discord per admin (modelli), giveaway (avvio, estrazione, annullamento) e rewards (ogni premio), url = '' disattiva un log. Tutti i testi si trovano in config/locales/ (un file per lingua).

In gioco

• Menu admin (/giveawayadmin): In alto passi tra Crea, Modelli e Cronologia. Se è in corso un giveaway, in alto un'indicazione LIVE mostra il tempo rimanente.
• Crea: Rispondi a tre domande: cosa si può vincere, quanto dura, quanti vincono. Il nome è facoltativo, tutto il resto si trova in Altre impostazioni. A destra vedi il riquadro come lo vedono i giocatori. Avvia giveaway lo avvia subito, Come modello lo salva. Carica modello carica un modello salvato da modificare.
• Premi: In alto scegli il tipo. Item, arma e veicolo aprono una lista con immagine e ricerca, i soldi aggiungono subito un importo. Per le armi la quantità è la munizione. Nella Lotteria (in Altre impostazioni) dai a ogni premio una probabilità, in totale 100 %. Dividi equamente le distribuisce in parti uguali.
• Modelli: A sinistra la lista, a destra l'editor: in alto il nome, sotto le stesse domande della creazione. Il nome del modello è anche il nome che vedono i giocatori. Al posto del nome, il punto 4 chiede Avvio automatico: scegli i giorni della settimana e fino a 6 orari, sotto compare il prossimo avvio, facoltativo Minimo online. Solo Salva applica le modifiche. Avvia ora avvia subito il modello, Modifica e avvia lo apre nella scheda Crea. L'ora è quella del server.
• Cronologia: In alto controlli il giveaway in corso, sotto ci sono le statistiche e gli ultimi 50 giveaway. Un clic su una voce mostra i vincitori con i loro premi.
• Partecipare: Quando parte un giveaway, il riquadro compare in alto a tutti i giocatori. Con G o /giveaway partecipi, la quota d'ingresso viene addebitata prima sui contanti, altrimenti sulla banca. H riduce il riquadro a una piccola barra e lo riapre.
• Estrazione: Quando il tempo scade o un admin estrae, i vincitori vengono estratti uno dopo l'altro con la ruota di nomi. Poi tutti vedono la lista dei vincitori, i vincitori ricevono anche un messaggio. Senza Estrazione animata la lista compare subito.
• I veicoli vinti finiscono parcheggiati nel garage (owned_vehicles) con una targa propria, anche se il vincitore è offline.
• Consegna successiva: Se l'inventario è pieno o il vincitore è offline, riceve il premio automaticamente appena c'è spazio o torna online. Le quote rimborsate ai giocatori offline funzionano allo stesso modo.

Per sviluppatori

-- Server
local active = exports.off_giveaway:GetActiveGiveaway()        -- nil se non ce n'è nessuno in corso
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()

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

Con StartGiveaway, duration è in secondi (almeno 30). Facoltativi sono description, entryFee, minMembers e options = { reel = false } (senza estrazione animata).

Premi per StartGiveaway: kind = item, weapon, account o vehicle, più name e amount. Per i veicoli anche category (car, bike, boat, heli, plane) e label. Nella lotteria (mode = 'pool') ogni premio ha bisogno di una chance, in totale 100.

Problemi comuni

All'avvio lo script segnala errori e avvisi nella console del server.