📦 ls-welcome

Give every new player the perfect first impression with ls-welcome — a modern, fully configurable welcome rewards system for QBCore servers. Players can interact with a dedicated NPC to claim their starter package through a clean and responsive interface, making onboarding simple, immersive, and professional.

✨ Features

🎁 Interactive Welcome NPC

• Spawn a fully configurable welcome NPC anywhere on the map.

• Optional map blip to help new players locate the welcome point.

• Seamless interaction using ox_target.

🖥️ Modern NUI Interface

• Beautiful and responsive UI.

• Clearly displays every reward before the player claims it.

• Easy to customize to match your server's branding.

💰 Multiple Reward Types

Configure any combination of rewards directly from config.lua:

• Items – Give starter items through ox_inventory (water, food, phone, ID card, etc.).

• Money – Reward players with cash or bank money using QBCore.

• Vehicles – Automatically register a vehicle to the player's garage, spawn it, and provide the keys.

🔒 One-Time Claim System

• Prevent players from claiming rewards multiple times.

• Uses a MySQL database to securely track claimed rewards by citizenid.

• Can be enabled or disabled with a single configuration option.

⚙️ Custom Integration Support

Built with flexibility in mind.

The script first checks for custom implementations through sv_custom.lua, allowing you to integrate:

• Custom garages

• Custom vehicle key systems

• Custom inventory systems

• Any other reward logic

If no custom implementation exists, the script automatically falls back to the default QBCore functionality.

🔄 Automatic Version Checker

• Checks GitHub for new releases whenever the resource starts.

• Displays clean console notifications when updates are available.

• Helps keep your server running the latest version.

🛠️ Dependencies

• qb-core

• ox_inventory

• ox_lib

• oxmysql

✅ Why Choose ls-welcome?

• Clean and optimized code

• Easy to configure

• Beginner-friendly setup

• Highly customizable

• Modern UI

• Lightweight and performance-friendly

• Perfect for improving your new player experience