Konfiguration

Befehle

Befehl	Beschreibung
/giveaway	Erstell-Menü öffnen (Berechtigung nötig)
/enter	Aktivem Giveaway beitreten, wenn Config.JoinMode = 'command'

Wichtige Einstellungen

• Config.JoinMode: 'enter' (Taste) oder 'command'
• Config.Permissions.Create: ACE, Gruppen, Identifier
• Config.WeaponAmmo: Munition, die mit einem Waffen-Preis vergeben wird (ESX-Loadout und Standalone)
• Config.WinnerDisplaySeconds: Wie lange das Gewinner-Overlay angezeigt wird (Standard: 10 Sekunden)
• Config.TimezoneOffsetHours: Auf nil lassen, wenn das Server-OS auf Europe/Berlin läuft. Nur setzen, wenn die OS-Uhr auf UTC steht.
• Framework und Inventar: HCSConfig.Framework und HCSConfig.Inventory in HCS_lib/config.lua

Anpassbare Funktionen

In shared/functions.lua, alle auf dem Server:

Funktion	Beschreibung
Functions.GiveVehicle(src, model)	Fahrzeug-Preis vergeben, einmal pro Gewinner. An dein Garagen-System anbinden.
Functions.GiveItem(src, item, amount)	true zurückgeben, um die Standard-Vergabe über HCS_lib zu überspringen
Functions.GiveWeapon(src, weapon)	true zurückgeben, um die Standard-Vergabe zu überspringen

luaCopy
function Functions.GiveVehicle(src, model)
    exports['your_garage']:GiveVehicle(src, model)
end

Waffen werden standardmäßig so vergeben: mit ox_inventory als Item, unter ESX ins Loadout (xPlayer.addWeapon), unter QBCore als Item, sonst direkt an den Ped.

Hinweise

• Es kann immer nur ein Giveaway aktiv oder geplant sein.
• Die Teilnahmegebühr wird zuerst vom Bargeld abgezogen, dann von der Bank. Sie wird gelöscht, nicht an jemanden ausgezahlt.
• Startzeit im Format HH:MM (heute, Server-Uhrzeit). Leer = sofort starten. Vergangene Uhrzeiten werden mit einer Meldung abgelehnt.
• Das Overlay erscheint erst ab der Startzeit, nicht während das Giveaway geplant ist.
• Nach dem Beitritt ist das Overlay für diesen Spieler ausgeblendet, bis das Giveaway endet.
• Wer den Server verlässt, wird aus dem Giveaway entfernt. Eine bezahlte Teilnahmegebühr wird dabei nicht erstattet.
• Gezogen wird nur unter Teilnehmern, die beim Ende online sind.
• Das Gewinner-Overlay sehen alle Spieler für Config.WinnerDisplaySeconds Sekunden.