GIVEAWAY CREATOR [VUE]

# Risk Giveaway — Ingame Giveaway Creator with 5 Modes for FiveM

**Five giveaway modes. One panel. Every winner picked by the server.**

Risk Giveaway is a FiveM giveaway script for ESX, QBCore and QBox, also known as an ingame giveaway creator or prize draw system. An admin types `/giveaway`, picks a reward and a mode, and every player gets a live widget to join with one key. It works with `ox_inventory`, `qs-inventory`, `codem-inventory`, `tgiann-inventory`, `core_inventory`, `origen_inventory` and `qb-inventory`.

---

## Why this one

A typical FiveM giveaway script runs one format: join, wait, one name in chat. Your players have seen it after the second event. This one gives you five formats and makes the moment worth watching.

- **Five modes in one script.** Classic, Ticket, Lucky Number, Fast Join and Scheduled, each with its own rules and all in the same creator.

- **A real winner moment.** A fullscreen winner screen with confetti, and spinning number reels in Lucky Number mode.

- **Your Discord becomes your advert.** Clean public cards for start, schedule, end and cancel, with a join button and the winner pinged.

- **No config work for each event.** Reward, duration, winners and mode are all set ingame, in seconds.

- **The server decides everything.** Winners, payouts and ticket purchases are checked and handled on the server, never by the client.

---

## The 5 Giveaway Modes

| Mode | How it works | Best for |

| --- | --- | --- |

| **Classic** | Press the key, you are in. Everyone has the same chance. | Quick rewards at any time |

| **Ticket** | Joining gives one free ticket. Optional extra tickets cost in-game money, and more tickets mean better odds. You set the price and the limit. | Big events and taking money out of the economy |

| **Lucky Number** | Players choose their own number from a range you set. A taken number is gone. | Community events with suspense |

| **Fast Join** | Only the first players get in, from 1 to 500 places. When it is full, it is closed. | Rewarding whoever is awake and quick |

| **Scheduled** | Plan a giveaway up to 60 days ahead. It starts by itself and survives a server restart. | Weekend events and peak times |

German servers often call this a Gewinnspiel or Verlosung, Spanish servers a sorteo, Portuguese servers a sorteio, French servers a tirage au sort and Turkish servers a çekiliş. It is the same system, and the notifications and Discord cards ship in those languages.

---

## Give Away Anything

| Reward | What the winner gets |

| --- | --- |

| **Cash** | Paid straight to the cash account |

| **Bank** | Paid straight to the bank account |

| **Black money** | ESX account, or an item on QBCore and QBox |

| **Items** | Search every item of your server by name, up to 1,000 per reward |

| **Vehicles** | Type any spawn name, addon cars too. The car is saved straight to the winner's garage. |

| **Custom** | Anything your other scripts can do: VIP, coins, a house or a job rank |

Set up to **10 winners** per giveaway. Each winner gets the full reward, it is never split.

A vehicle spawn name is checked before the giveaway starts, so a typo shows a red field instead of a broken prize later.

---

## Ingame Creator and Admin Panel

One command for your team: `/giveaway`. A button at the top switches between the creator and the admin panel, and the server checks the permission again on every switch.

- **Creator:** reward, mode, duration from 30 seconds to 24 hours, number of winners, anonymous host and Discord on or off

- **Admin panel:** live participant list with tickets or chosen numbers, the planned giveaway under `UP NEXT`, **DRAW NOW** and cancel

- **Fair cancel:** cancelling a Ticket giveaway returns all ticket money automatically, and so does stopping the resource

- **Permissions:** an ace permission (`giveaway.admin`) or your ESX, QBCore and QBox groups

---

## A Widget That Does Not Get in the Way

Every player sees the reward, timer and participant count in a live widget. Pressing `G` hands the mouse to the widget, and a click joins or buys a ticket. Players can rebind the key in the GTA settings.

Once a player has nothing left to do, the widget shrinks and fades. Nobody plays a 24 hour giveaway with a big panel on their screen.

---

## Winner Screen and Draw

- **Winner screen:** reward, winner, participants and win chance, closing by itself after 12 seconds by default

- **Lucky Number draw:** reels spin and lock digit by digit until the winning number stands

- **Who sees it:** only participants, or the whole server. Everyone else gets a short notification with the winner.

---

## Discord Cards That Advertise Your Server

Giveaway messages are public, so they should look good. A single webhook is enough, with no bot to host.

- **Modern card layout** with your logo, the reward as the headline and a live countdown

- **Join button** that sends people straight to your server

- **Winners pinged** with their Discord account and ingame name, if you want it

- **Optional mention** such as `@everyone` or a giveaway role

---

## Make It Yours

| What you can change | How |

| --- | --- |

| **Color** | One hex code in `Config.UIColor` recolors the whole UI, images and glows included |

| **Logo** | Replace `config/logo.png`, done |

| **Language** | Edit any file in `locales/` or add your own language with one file |

| **Inventory** | Open bridge in `inventory/inventory.lua`, add your own in a few lines |

| **Garage and database** | Open bridge in `database/database.lua` |

| **Notify** | Your own notify through one function, `risk-hudv3` is prepared as the example |

| **Limits** | Maximum money, items, tickets, duration and winners in the config |

---

## Built for Your Other Scripts

Custom rewards are your link to everything else on your server. All three examples use the open files that ship with the script.

```lua

-- config/server.lua: the winner of "VIP 30 Days" gets VIP from your own script

ServerConfig.CustomReward = function(src, label, giveaway)

    if label == 'VIP 30 Days' then exports['my-vip']:AddVip(src, 30) end

end

-- config/config.lua: send all messages through your own notify

Config.UseCustomNotify = true

Config.Functions['notify'] = function(ntype, title, text, time) exports['my-notify']:Send(text, ntype, time) end

-- inventory/inventory.lua: add an inventory that is not on the list

if has('my_inventory') then return exports.my_inventory:AddItem(src, name, count) and true or false end

```

---

## Compatibility

| | Supported |

| --- | --- |

| **Framework** | ESX · QBCore · QBox, detected automatically |

| **Inventory** | ox_inventory · qs-inventory · codem-inventory · tgiann-inventory · core_inventory · origen_inventory · qb-inventory · framework native |

| **Garage** | Written to the framework vehicle table. Columns of qb-garages, qbx_garages, esx_garage, okokGarage, jg-advancedgarages, cd_garage and renzu_garage are recognized |

| **Database** | oxmysql · mysql-async · ghmattimysql, table created automatically |

| **Languages** | EN · DE · ES · FR · IT · NL · PL · PT · RO · RU · TR for notifications, key binding and Discord. The interface is in English. |

---

## What You Get

- ✅ 5 giveaway modes: Classic, Ticket, Lucky Number, Fast Join and Scheduled

- ✅ Ingame creator, no config editing per event

- ✅ Admin panel with live participants, DRAW NOW and cancel

- ✅ Cash, bank, black money, item, vehicle and custom rewards

- ✅ Up to 10 winners, each with the full reward

- ✅ Extra tickets with your own price and limit

- ✅ Automatic ticket refund on cancel

- ✅ Scheduled giveaways up to 60 days ahead, safe across restarts

- ✅ Live widget that shrinks after joining

- ✅ Fullscreen winner screen and Lucky Number reels

- ✅ Discord cards with join button and winner ping

- ✅ Anonymous giveaways

- ✅ One hex code recolors the whole UI, plus your own logo

- ✅ 11 languages for notifications and Discord, add your own

- ✅ Open inventory and database bridges

- ✅ Responsive up to 4K and ultrawide

- ✅ Exploit-safe and server-authoritative with rate limits

- ✅ 0.00ms idle

---

## Installation

1. Drop `risk-giveaway` into your resources folder

2. Add `ensure risk-giveaway` to your `server.cfg`, after your database, framework and inventory

3. Add `add_ace group.admin giveaway.admin allow` to your `server.cfg`

4. Restart and type `/giveaway` ingame

The database table is created automatically on the first start. No SQL import needed.

**Requirements:** ESX, QBCore or QBox · `oxmysql`, `mysql-async` or `ghmattimysql`

---

## FAQ

**What is Risk Giveaway?**

Risk Giveaway is a FiveM giveaway script for ESX, QBCore and QBox with five modes, an ingame creator, an admin panel, a winner screen and Discord cards.

**Does it work with my inventory?**

Yes. `ox_inventory`, `qs-inventory`, `codem-inventory`, `tgiann-inventory`, `core_inventory`, `origen_inventory`, `qb-inventory` and the framework native functions are detected automatically.

**Can I add my own inventory?**

Yes. `inventory/inventory.lua` is open and has one function for the item list and one for giving items.

**Can I add my own language?**

Yes. Copy one file in `locales/`, translate it and set `Config.Locale`. Missing texts fall back to English. This covers notifications, the key binding and Discord, while the interface itself is in English.

**How does a vehicle reward reach the garage?**

The car is written to the winner's owned vehicles with a new random plate. You choose the garage and vehicle type in the config.

**What happens if a winner has a full inventory?**

With inventories that report it, the winner sees a message that the reward could not be given, and the server console logs the name and reward so an admin can hand it over.

**Do players have to pay to join?**

No. Joining is free in every mode. Only Ticket mode offers optional extra tickets, paid with in-game money.

**What happens if a player leaves during a giveaway?**

The player is out and a chosen number becomes free again. Ticket money is only returned if the giveaway is cancelled or the resource stops.

**Can players cheat the result?**

No. Winners, numbers, ticket purchases and payouts are handled on the server, and every request is validated and rate limited.

**Does it cost performance?**

No. There are no loops on the client, so the script runs at 0.00ms idle.

https://youtu.be/SeNiBKJPjQ0