Giveaway

Giveaways direkt im Spiel erstellen: sofort starten oder als Vorlage speichern, die auf Wunsch automatisch zu festen Zeiten startet. Spieler treten per Taste oder Befehl bei, die Gewinner werden live mit einer Namens-Rolle gezogen. Die Tabellen legt das Script selbst an.

Funktionen

• Admin-Menü (/giveawayadmin): Giveaways auf einer Seite erstellen (Gewinne, Dauer, Gewinner, optional ein Name), mit Live-Vorschau, wie Spieler es sehen.
• Gewinne: Items, Waffen, Geld (Bargeld, Bank, Schwarzgeld oder eigene Konten) und Fahrzeuge. Alle Fahrzeuge aus dem Spiel, auch Addon-Fahrzeuge, stehen mit Bild und Kategorie zur Auswahl.
• Fester Gewinn oder Lostopf: Entweder bekommt jeder Gewinner alles aus der Liste, oder jeder zieht einen Gewinn nach Chance, z. B. 60 % Geld, 30 % Bank, 10 % Fahrzeug.
• Regeln: Anzahl Gewinner, Teilnahmegebühr, Laufzeit, maximale und Mindestteilnehmer. Kommen zu wenige zusammen, wird abgebrochen und erstattet.
• Vorlagen: Giveaways speichern und mit einem Klick starten, duplizieren oder im Erstellen-Tab anpassen.
• Automatisch starten: Pro Vorlage einschaltbar, an festen Wochentagen und Uhrzeiten, z. B. jeden Freitag um 20:00 und 22:30. Optional nur, wenn genug Spieler online sind.
• Verlauf: Das laufende Giveaway live steuern (jetzt auslosen oder abbrechen) und die letzten 50 Giveaways mit Gewinnern ansehen.
• Spieler-Anzeige: Oben im Bild mit Gewinnen, Timer und Teilnehmerzahl. Beitreten mit G oder /giveaway, H blendet die Anzeige ein und aus.
• Nachliefern: Passt ein Gewinn nicht ins Inventar oder ist der Gewinner offline, wird er gespeichert und automatisch nachgeliefert.
• Discord-Logs für Admin-Aktionen, Giveaways und jeden ausgegebenen Gewinn.

Installation

1. Ordner off_giveaway in resources legen.
2. In die server.cfg nach oxmysql und ESX:

ensure oxmysql
ensure es_extended
ensure off_giveaway

1. Deine Gruppe in admin.groups eintragen und /giveawayadmin öffnen.

Konfiguration

config/settings/config.lua

Eigenes Konto als Gewinn hinzufügen, z. B. Casino-Chips:

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

config/functions.lua

Hier bindest du eigene Scripts an. Fehler darin werden abgefangen, das Script läuft weiter.

config/settings/config.server.lua und Sprachen

Discord-Webhooks für admin (Vorlagen), giveaway (Start, Auslosung, Abbruch) und rewards (jeder Gewinn), url = '' schaltet einen Log aus. Alle Texte stehen in config/locales/ (eine Datei pro Sprache).

Im Spiel

• Admin-Menü (/giveawayadmin): Oben wechselst du zwischen Erstellen, Vorlagen und Verlauf. Läuft gerade ein Giveaway, zeigt oben ein LIVE-Hinweis die Restzeit.
• Erstellen: Drei Fragen beantworten: Was gibt es zu gewinnen, wie lange läuft es, wie viele gewinnen. Der Name ist optional, alles andere steckt unter Weitere Einstellungen. Rechts siehst du die Anzeige, wie Spieler sie sehen. Giveaway starten startet sofort, Als Vorlage speichert es. Vorlage laden übernimmt eine gespeicherte Vorlage zum Anpassen.
• Gewinne: Oben wählst du die Art. Item, Waffe und Fahrzeug öffnen eine Liste mit Bild und Suche, Geld fügt direkt einen Betrag hinzu. Bei Waffen ist die Menge die Munition. Im Lostopf (unter Weitere Einstellungen) gibst du jedem Gewinn eine Chance, zusammen 100 %. Gleich verteilen teilt sie gleichmäßig auf.
• Vorlagen: Links die Liste, rechts der Editor: oben der Name, darunter dieselben Fragen wie beim Erstellen. Der Name der Vorlage ist auch der Name, den Spieler sehen. Statt nach dem Namen fragt Punkt 4 nach Automatisch starten: Wochentage und bis zu 6 Uhrzeiten wählen, darunter steht der nächste Start, optional Mindestens online. Erst Speichern übernimmt Änderungen. Jetzt starten startet die Vorlage sofort, Anpassen & starten öffnet sie im Erstellen-Tab. Die Uhrzeit ist die des Servers.
• Verlauf: Oben steuerst du das laufende Giveaway, darunter stehen Statistik und die letzten 50 Giveaways. Ein Klick auf einen Eintrag zeigt die Gewinner mit ihren Gewinnen.
• Teilnehmen: Startet ein Giveaway, erscheint oben die Anzeige bei allen Spielern. Mit G oder /giveaway trittst du bei, eine Teilnahmegebühr wird erst vom Bargeld, sonst von der Bank abgebucht. H blendet die Anzeige auf eine kleine Leiste ein und aus.
• Ziehung: Läuft die Zeit ab oder ein Admin lost aus, werden die Gewinner nacheinander mit der Namens-Rolle gezogen. Danach sehen alle die Gewinnerliste, Gewinner bekommen zusätzlich eine Nachricht. Ohne Animierte Ziehung erscheint sofort die Liste.
• Fahrzeug-Gewinne landen mit eigenem Kennzeichen eingeparkt in der Garage (owned_vehicles), auch wenn der Gewinner offline ist.
• Nachliefern: Ist das Inventar voll oder der Gewinner offline, bekommt er den Gewinn automatisch, sobald Platz ist oder er wieder online kommt. Erstattete Gebühren für offline Spieler laufen genauso.

Für Entwickler

-- Server
local active = exports.off_giveaway:GetActiveGiveaway()        -- nil, wenn keins läuft
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()

Bei StartGiveaway ist duration in Sekunden (mindestens 30). Optional sind description, entryFee, minMembers und options = { reel = false } (ohne animierte Ziehung).

Gewinne bei StartGiveaway: kind = item, weapon, account oder vehicle, dazu name und amount. Bei Fahrzeugen zusätzlich category (car, bike, boat, heli, plane) und label. Im Lostopf (mode = 'pool') braucht jeder Gewinn eine chance, zusammen 100.

Häufige Fehler

Beim Start meldet das Script Fehler und Hinweise in der Server-Konsole.