Giveaway

Crée des giveaways directement en jeu : lance-les tout de suite ou enregistre-les comme modèle, qui se lance automatiquement à heures fixes si tu le souhaites. Les joueurs participent avec une touche ou une commande, les gagnants sont tirés en direct avec une roue de noms. Le script crée lui-même les tables.

Fonctionnalités

• Menu admin (/giveawayadmin) : Crée des giveaways sur une seule page (lots, durée, gagnants, un nom en option), avec un aperçu en direct de ce que voient les joueurs.
• Lots : Items, armes, argent (liquide, banque, argent sale ou comptes personnalisés) et véhicules. Tous les véhicules du jeu, y compris les véhicules addon, sont proposés avec image et catégorie.
• Lot fixe ou loterie : Soit chaque gagnant reçoit tout ce qui est dans la liste, soit chacun tire un lot selon les chances, p. ex. 60 % argent, 30 % banque, 10 % véhicule.
• Règles : Nombre de gagnants, frais d'entrée, durée, nombre maximum et minimum de participants. S'il y en a trop peu, le giveaway est annulé et remboursé.
• Modèles : Enregistre des giveaways et lance-les ou duplique-les en un clic, ou ajuste-les dans l'onglet Créer.
• Lancer automatiquement : Activable par modèle, à des jours de la semaine et des heures fixes, p. ex. chaque vendredi à 20:00 et 22:30. En option, seulement quand assez de joueurs sont en ligne.
• Historique : Contrôle le giveaway en cours en direct (tirer maintenant ou annuler) et consulte les 50 derniers giveaways avec leurs gagnants.
• Affichage joueurs : En haut de l'écran avec les lots, le timer et le nombre de participants. Participe avec G ou /giveaway, H affiche ou masque l'affichage.
• Livraison différée : Si un lot ne rentre pas dans l'inventaire ou si le gagnant est hors ligne, il est enregistré et livré automatiquement plus tard.
• Logs Discord pour les actions admin, les giveaways et chaque lot remis.

Installation

1. Place le dossier off_giveaway dans resources.
2. Dans le server.cfg, après oxmysql et ESX :

ensure oxmysql
ensure es_extended
ensure off_giveaway

1. Ajoute ton groupe dans admin.groups et ouvre /giveawayadmin.

Configuration

config/settings/config.lua

Ajouter ton propre compte comme lot, p. ex. des jetons de casino :

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

config/functions.lua

C'est ici que tu connectes tes propres scripts. Les erreurs qu'elles contiennent sont interceptées, le script continue de tourner.

config/settings/config.server.lua et langues

Webhooks Discord pour admin (modèles), giveaway (lancement, tirage, annulation) et rewards (chaque lot), url = '' désactive un log. Tous les textes se trouvent dans config/locales/ (un fichier par langue).

En jeu

• Menu admin (/giveawayadmin) : En haut, tu passes entre Créer, Modèles et Historique. Si un giveaway est en cours, une indication LIVE en haut affiche le temps restant.
• Créer : Réponds à trois questions : qu'y a-t-il à gagner, combien de temps ça dure, combien de gagnants. Le nom est optionnel, tout le reste se trouve sous Plus de réglages. À droite, tu vois l'affichage tel que les joueurs le voient. Lancer le giveaway le lance tout de suite, Comme modèle l'enregistre. Charger un modèle reprend un modèle enregistré pour l'ajuster.
• Lots : En haut, tu choisis le type. Item, arme et véhicule ouvrent une liste avec image et recherche, l'argent ajoute directement un montant. Pour les armes, la quantité correspond aux munitions. Dans la Loterie (sous Plus de réglages), tu donnes une chance à chaque lot, 100 % au total. Répartir également les répartit à parts égales.
• Modèles : À gauche la liste, à droite l'éditeur : en haut le nom, en dessous les mêmes questions que pour la création. Le nom du modèle est aussi le nom que voient les joueurs. Au lieu du nom, le point 4 demande Lancer automatiquement : choisis les jours de la semaine et jusqu'à 6 horaires, en dessous s'affiche le prochain lancement, en option Minimum en ligne. Seul Enregistrer applique les modifications. Lancer maintenant lance le modèle tout de suite, Ajuster et lancer l'ouvre dans l'onglet Créer. L'heure est celle du serveur.
• Historique : En haut, tu contrôles le giveaway en cours, en dessous se trouvent les statistiques et les 50 derniers giveaways. Un clic sur une entrée affiche les gagnants avec leurs lots.
• Participer : Quand un giveaway démarre, l'affichage apparaît en haut chez tous les joueurs. Tu participes avec G ou /giveaway, les frais d'entrée sont prélevés d'abord sur le liquide, sinon sur la banque. H réduit l'affichage à une petite barre et le rouvre.
• Tirage : Quand le temps est écoulé ou qu'un admin lance le tirage, les gagnants sont tirés l'un après l'autre avec la roue de noms. Ensuite, tout le monde voit la liste des gagnants, les gagnants reçoivent en plus un message. Sans Tirage animé, la liste apparaît tout de suite.
• Les véhicules gagnés arrivent rangés au garage (owned_vehicles) avec leur propre plaque, même si le gagnant est hors ligne.
• Livraison différée : Si l'inventaire est plein ou si le gagnant est hors ligne, il reçoit son lot automatiquement dès qu'il y a de la place ou qu'il revient en ligne. Les frais remboursés aux joueurs hors ligne fonctionnent de la même façon.

Pour les développeurs

-- Serveur
local active = exports.off_giveaway:GetActiveGiveaway()        -- nil si aucun n'est en cours
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()

Avec StartGiveaway, duration est en secondes (au moins 30). En option : description, entryFee, minMembers et options = { reel = false } (sans tirage animé).

Lots pour StartGiveaway : kind = item, weapon, account ou vehicle, avec name et amount. Pour les véhicules, en plus category (car, bike, boat, heli, plane) et label. Dans la loterie (mode = 'pool'), chaque lot a besoin d'une chance, 100 au total.

Problèmes fréquents

Au démarrage, le script signale les erreurs et remarques dans la console serveur.