dynamic-raffle

LLRP Dynamic Raffle Giveaway System by Dynamic Scripts

Dependencies

• qb-core
• ox_lib

Installation

1. Drop dynamic-raffle/ into your resources/ folder.
2. Add ensure dynamic-raffle to your server.cfg.
3. Adjust config.lua to your liking.

---

Commands

Command	Who	Description
/startraffle [name]	Admin	Opens a dialog to set the prize, then starts the raffle.
/endraffle	Admin	Draws a random winner from all players who joined, must be in city.
/joinraffle	All Players	Enters the currently active raffle.
/rafflestatus	Admin	Shows current raffle info and entry count.

---

Flow

Admin: /startraffle Summer Giveaway
  → ox_lib input dialog opens
  → Admin types prize description (or picks preset)
  → Server broadcasts raffle announcement to all players

Players: /joinraffle
  → Confirmation notification sent to player

Admin: /endraffle
  → Server filters entered players to those still online (in city)
  → Random winner selected
  → Server-wide announcement notification fires for all players
  → Winner gets a special golden overlay screen with confetti (15s auto-dismiss)

---

Config Options (config.lua)

Key	Default	Description
Config.AdminGroups	{ 'admin', 'god' }	Permission groups that can run raffles
Config.MinPlayers	2	Minimum online players required to start
Config.WinnerDisplayTime	15000	Winner screen duration in milliseconds
Config.DefaultPrizeHint	'e.g. Mystery Box...'	Placeholder text in the dialog
Config.PresetPrizes	(list)	Quick-select presets shown in the dialog

---

Notes

• Players who disconnect before /endraffle is called are automatically excluded from the draw.
• The NUI winner screen uses a gold/confetti aesthetic and auto-dismisses after 15 seconds. The player can also click ✕ dismiss to close it early.
• The /startraffle command accepts an optional raffle name as arguments, e.g. /startraffle Summer Event.

---

License & Contributing

This resource is source-available, all rights reserved under the Dynamic Scripts Proprietary License. You may view the code, but you may not redistribute, resell, or publish modified or "improved" versions.

Found a bug, fix, or improvement? Please don't fork or republish - instead DM the author at wax@waxthe.dev, and it may be incorporated (with credit).