uniqers-christmas

How to install and all exports infos.

Installation

🚀 Step 1: File Installation Download the uniqers-christmas folder and place it into your server's resources directory.

Open your server.cfg file and add the start commands. Important: Ensure these lines are placed after your core and inventory scripts.

ensure uniqers-uipack - optional ensure uniqers-christmas

Here is the updated Installation Guide in English, fully adapted for your uniiqers-christmas script and the code you provided.

🎄 uniiqers-christmas - Installation Guide This script adds a comprehensive Christmas event system to your server. Please follow the steps below carefully to ensure a smooth installation.

📋 Dependencies For the script to work correctly, ensure you have the following resources installed:

oxmysql (For database operations)

uniqers-uipack (Required for UI notifications and interactions - found in client.lua)

qb-weathersync (For custom weather effects. Note: If you use a different weather script, you may need to adjust SetChristmasWeather in client.lua.)

🚀 Step 1: File Installation Download the uniiqers-christmas folder and place it into your server's resources directory.

Open your server.cfg file and add the start commands. Important: Ensure these lines are placed after your core and inventory scripts.

Kod snippet'i

ensure uniqers-uipack ensure uniiqers-christmas 💾 Step 2: Database Setup Execute the provided .sql file in your database manager (HeidiSQL, phpMyAdmin, etc.). This will create the necessary tables:

players_christmas

team_scores

christmas_game_state

christmas_snowmen

christmas_tebex_codes

...and other required tables.

⚙️ Step 3: Adding Items You must add the specific event items to your framework. Choose the section below that matches your server setup.

🔵 For QBCore Users Open qb-core/shared/items.lua and paste the following code at the bottom:

-- uniiqers-christmas items ['snowball'] = { ['name'] = 'snowball', ['label'] = 'Snowball', ['weight'] = 100, ['type'] = 'item', ['image'] = 'snowball.png', ['unique'] = false, ['useable'] = true, ['shouldClose'] = true, ['combinable'] = nil, ['description'] = 'A snowball.' }, ['bigsnowball'] = { ['name'] = 'bigsnowball', ['label'] = 'Big Snowball', ['weight'] = 500, ['type'] = 'item', ['image'] = 'bigsnowball.png', ['unique'] = false, ['useable'] = true, ['shouldClose'] = true, ['combinable'] = nil, ['description'] = 'A large snowball used to build snowmen.' }, ['krampusbullet'] = { ['name'] = 'krampusbullet', ['label'] = 'Krampus Bullet', ['weight'] = 50, ['type'] = 'item', ['image'] = 'krampusbullet.png', ['unique'] = false, ['useable'] = true, ['shouldClose'] = true, ['combinable'] = nil, ['description'] = 'Special ammo for hunting monsters.' }, ['krampusvisionpills'] = { ['name'] = 'krampusvisionpills', ['label'] = 'Krampus Vision Pill', ['weight'] = 20, ['type'] = 'item', ['image'] = 'krampusvisionpills.png', ['unique'] = false, ['useable'] = true, ['shouldClose'] = true, ['combinable'] = nil, ['description'] = 'Allows you to see the unseen.' }, ['emfreader'] = { ['name'] = 'emfreader', ['label'] = 'EMF Reader', ['weight'] = 500, ['type'] = 'item', ['image'] = 'emfreader.png', ['unique'] = false, ['useable'] = true, ['shouldClose'] = false, ['combinable'] = nil, ['description'] = 'Detects paranormal activity.' }, ['christmasgift'] = { ['name'] = 'christmasgift', ['label'] = 'Christmas Gift', ['weight'] = 100, ['type'] = 'item', ['image'] = 'christmasgift.png', ['unique'] = false, ['useable'] = true, ['shouldClose'] = true, ['combinable'] = nil, ['description'] = 'Used to exchange gifts with other players.' }, ['krampusgift'] = { ['name'] = 'krampusgift', ['label'] = 'Krampus Gift', ['weight'] = 50, ['type'] = 'item', ['image'] = 'krampusgift.png', ['unique'] = false, ['useable'] = false, ['shouldClose'] = true, ['combinable'] = nil, ['description'] = 'Loot from Krampus. Can be exchanged for candy.' },

🟢 For ESX Users Execute the following SQL code to add items to your database:

INSERT INTO items (name, label, weight, rare, can_remove) VALUES ('snowball', 'Snowball', 1, 0, 1), ('bigsnowball', 'Big Snowball', 1, 0, 1), ('krampusbullet', 'Krampus Bullet', 1, 0, 1), ('krampusvisionpills', 'Krampus Vision Pill', 1, 0, 1), ('emfreader', 'EMF Reader', 1, 0, 1), ('christmasgift', 'Christmas Gift', 1, 0, 1), ('krampusgift', 'Krampus Gift', 1, 0, 1);

🎒 For OX Inventory Users Add the following to your ox_inventory/data/items.lua:

["snowball"] = { label = "Snowball", weight = 100, stack = true, close = true }, ["bigsnowball"] = { label = "Big Snowball", weight = 500, stack = true, close = true }, ["krampusbullet"] = { label = "Krampus Bullet", weight = 50, stack = true, close = true }, ["krampusvisionpills"] = { label = "Krampus Vision Pill", weight = 20, stack = true, close = true }, ["emfreader"] = { label = "EMF Reader", weight = 500, stack = true, close = true }, ["christmasgift"] = { label = "Christmas Gift", weight = 100, stack = true, close = true }, ["krampusgift"] = { label = "Krampus Gift", weight = 50, stack = true, close = true },

IMPORTANT: Copy all .png images from the uniiqers-christmas/img folder to your inventory's image directory (e.g., qb-inventory/html/images/ or ox_inventory/web/images/).

Here is the updated Installation Guide in English, fully adapted for your uniiqers-christmas script and the code you provided.

🎄 uniiqers-christmas - Installation Guide This script adds a comprehensive Christmas event system to your server. Please follow the steps below carefully to ensure a smooth installation.

📋 Dependencies For the script to work correctly, ensure you have the following resources installed:

oxmysql (For database operations)

uniqers-uipack (Required for UI notifications and interactions - found in client.lua)

qb-weathersync (For custom weather effects. Note: If you use a different weather script, you may need to adjust SetChristmasWeather in client.lua.)

🚀 Step 1: File Installation Download the uniiqers-christmas folder and place it into your server's resources directory.

Open your server.cfg file and add the start commands. Important: Ensure these lines are placed after your core and inventory scripts.

Kod snippet'i

players_christmas

team_scores

christmas_game_state

christmas_snowmen

christmas_tebex_codes

...and other required tables.

⚙️ Step 3: Adding Items You must add the specific event items to your framework. Choose the section below that matches your server setup.

🔵 For QBCore Users Open qb-core/shared/items.lua and paste the following code at the bottom:

Lua

SQL

Lua

🔧 Step 4: Configuration Open config.lua and adjust the settings to match your server:

Framework Selection:

Lua

Config.Framework = "qbcore" -- Set to "qbcore" or "esx" Core Name:

Lua

Config.CoreName2 = "qb-core" -- Usually "qb-core" for QBCore, "es_extended" for ESX Inventory Image Path: Set this correctly so images appear in the script's menus.

Lua

Config.InventoryImagePath = "https://cfx-nui-qb-inventory/html/images/" -- For OX Inventory: "https://cfx-nui-ox_inventory/web/images/"

Tebex Setup 🛒

As the final step, you’ll need to create a package in your Tebex store and link it to this script.

Open your Tebex Store and create a new package (for example, "30,000 Halloween Candies").

Scroll down to the “Game Server Commands” section.

Click “Add Command”.

In the menu that appears, set “When should this command run?” to “When the player purchases the package.”

In the command field, paste the following:

halloween_add_candy_code 30000 {transaction}

Explanation:

halloween_add_candy_code: This is the command name created in server.lua.

30000: The amount of candies the package will give. You can change this value for different packages (e.g., 100000).

{transaction}: This is the unique transaction ID generated by Tebex for each purchase. It ensures that the code cannot be reused.

In the Settings (gear icon) section, set “Require player to be online” to “Execute command even if player is offline.”

This allows players to receive their code even if they’re not online, and redeem it later.

Save the package — and that’s it! Everything is ready to go. 🎃

📢 Support and Updates: https://discord.gg/MyrGhbf9tM

Support & Updates & Questions

https://discord.gg/MyrGhbf9tM

Previous uniqers-halloween Nextuniqers-hotdog

Last updated 1 day ago