[FREE] LP_WelcomePack — Gender-Based Welcome Pack System | ESX / QBCore / Standalone


[FREE] LP_WelcomePack — Gender-Based Welcome Pack System | ESX / QBCore / Standalone


:waving_hand: Introduction

LP_WelcomePack is a fully-featured, production-ready welcome pack system for FiveM RP servers, developed by LPStudios. It gives new players a smooth and immersive first experience by allowing them to claim a starter kit through an NPC — with separate packs for men and women, completely configurable by admins in-game without touching a single line of code.


:sparkles: Features

:wrapped_gift: Welcome Pack System

  • Gender-based packs — separate reward sets for male and female characters.
  • Players can only claim once per character — tracked via database to prevent abuse.
  • Claim is validated server-side against the player’s actual character gender, preventing mismatches.
  • Interactive confirmation dialog before claiming.

:person_standing: In-World NPCs

  • Two fully configurable NPCs (one for Men, one for Women) spawned at custom coordinates.
  • NPCs are frozen, invincible, and block ambient events — no unintended behavior.
  • NPC appearance is fully customizable by admins in-game: just wear the look you want and copy it to the NPC with a command. Changes are synced globally to all connected players in real time.
  • Appearances are persisted in the database and automatically restored on server restart.

:ribbon: Reward Types

Admins can configure the following reward types for each pack:

  • Items — any inventory item (searchable list or manual entry)
  • Weapons — any weapon with ammo amount (searchable list or manual entry)
  • Money — cash, bank, black money (ESX) / cash, bank, crypto (QBCore)
  • Vehicles — any vehicle model, auto-registered to the player’s garage with a randomly generated plate

:hammer_and_wrench: In-Game Admin Panel

  • Full admin reward management panel accessible via command (/packadmin by default)
  • Add or remove rewards for Men/Women packs without restarting the resource
  • Searchable dropdowns auto-populated from your server’s items, weapons, and vehicles
  • Manual entry fallback for custom items not present in the list
  • Permission-gated: only players with configured admin groups can access it

:gear: Multi-Framework Support

Feature ESX (1.1, 1.2, latest) QBCore Standalone
Framework Support :white_check_mark: :white_check_mark: :white_check_mark:
Item Rewards :white_check_mark: :white_check_mark: :white_check_mark: (ox_inventory)
Weapon Rewards :white_check_mark: :white_check_mark: :white_check_mark:
Money Rewards :white_check_mark: :white_check_mark: :cross_mark:
Vehicle Rewards :white_check_mark: :white_check_mark: :cross_mark:

:electric_plug: Multi-Resource Compatibility

Full plug-and-play support for popular resources — just set one line in the config:

Category Supported
Menu ox_lib, qb-menu, esx_context
Input ox_lib, qb-input
Notifications ox_lib, esx, qb, okokNotify, mythic_notify
Target ox_target, qb-target, qtarget
Clothing illenium-appearance, fivem-appearance, qb-clothing, esx_skin, codem-appearance, rcore_clothing, vms_charcreator

:globe_showing_europe_africa: Multi-Language Support

Built-in translations for 5 languages:

  • :spain: Spanish (es)
  • :united_kingdom: English (en)
  • :france: French (fr)
  • :germany: German (de)
  • :brazil: Portuguese (pt)

Set your language in one config line. Fully extensible — add your own locale in minutes.


:clipboard: Requirements

  • ox_lib
  • ox_target (or your preferred target system)
  • oxmysql
  • A supported framework: ESX, QBCore, or Standalone

:rocket: Installation

  1. Drop LP_welcomepack into your resources folder.
  2. Add ensure LP_welcomepack to your server.cfg.
  3. Import the SQL file from the install/ folder into your database.
  4. Configure shared/config.lua to match your framework and resources.
  5. Restart your server — NPCs will spawn automatically.

Config is open-sourceconfig.lua and locales.lua are not escrowed.


:shield: Admin Commands

Command Description
/packadmin Opens the in-game admin reward management panel
/setnpclothing Copies your current appearance to the specified NPC [MEN or WOMEN]

Command names are fully configurable in config.lua.


:card_file_box: Database Tables

  • welcome_pack_rewards — stores configured rewards per pack type
  • welcome_packs_claimed — tracks which identifiers have claimed their pack
  • welcome_pack_appearances — persists NPC appearance data

:locked: Security

  • All reward delivery and admin actions are validated server-side.
  • Gender validation is performed on the server against the actual character data — not trusting client input.
  • Admin permission checks use your framework’s native group/permission system + ACE as fallback.

:file_folder: File Structure

LP_welcomepack/
├── client/
│   └── client.lua
├── server/
│   ├── server.lua
│   └── sh_version.lua
├── shared/
│   ├── config.lua       ← Open (not escrowed)
│   └── locales.lua      ← Open (not escrowed)
├── install/
│   └── lpwelcome.sql
└── fxmanifest.lua

:memo: Notes

  • This resource was originally built as a custom script for a private RP server and has been cleaned up and released for the community.
  • The config is intentionally kept simple and well-commented for easy setup.
  • If you encounter any issues, feel free to reply to this thread.

:open_book: Download

Github
Tebex

:man_technologist: Credits

Developed by: LPStudios — LeGenD Version: 1.0.0


Thank you for using LP_WelcomePack! If you find it useful, consider leaving a :heart: on the post.

:man_technologist: More Resources by LPStudios

LYP_Carrys

Code is accessible Yes
Subscription-based No
Lines (approximately) 1000+
Requirements ESX or QBCORE and ox_lib
Support Yes
1 Like

Gender Based is crazy work :joy: