Transform your FiveM server with a fully immersive nightclub and bar experience. Pickle Clubs delivers a complete club management system with interactive bartending, bouncer security, society management, and a polished custom UI — all built to work seamlessly across **QBCore**, **ESX**, and **standalone** frameworks.
## Interactive Bartending
- Physics-based drink mixing minigame — pick up bottles, tilt to pour, fill glasses
- Single flavor bottle with scroll-wheel selection for unlimited mixer options
- Separate alcohol bottle with configurable pour speed
- Real-time drink display showing flavor percentages and fill progress
- Recipe matching — drinks must match menu items to be served
- NPC order system with configurable spawn intervals, timeouts, and payment
- Player drink ordering with custom sidebar UI
- In-game recipe book prop for bartenders to reference available drinks
- Self-service drink purchasing when no bartender is on duty
- Configurable society revenue split on all sales
## Club Entry & VIP System
- Custom bottom-screen dialogue UI for bouncer interactions
- Standard entry and VIP pass tiers with configurable pricing
- Entry fees deposit directly to the club's society account
- VIP areas with bouncer restrictions for pass holders only
- Job-based and configurable bypass access (police, EMS, etc.)
- NPC bouncer detection with line-of-sight progress indicator
- Employees and bypass jobs walk past bouncers freely
## Bouncer Actions
- **Escort** — grab and physically attach players, throw them out with ragdoll physics
- **Search** — grid inventory panel showing all items with image tooltips on cursor
- Automatic pass and VIP revocation on ejection
- NPC bouncer immunity while being escorted
- Accessible via F6 keybind and target system (ox_target, qb-target, qtarget)
## Society Management
- Custom sliding UI panel with **Banking**, **Employees**, and **Pricing** tabs
- Live balance display with deposit and withdraw
- Employee management — view online staff, change ranks, hire nearby players, fire
- Per-club entry and VIP pricing configuration
- Works with any society backend (qb-management, qb-banking, esx_addonaccount)
## Club Administration (`/clubs`)
- Full club CRUD with live auto-saving
- Per-club map blip configuration (sprite, color, scale, position via gizmo)
- Drag-and-drop entity placement with in-world gizmo
- Entity types: **Bartender**, **Bouncer**, **Club Entry**, **Management**
- Drink menu editor with alphabetical sorting and scrollable list
- Teleport-to-entity buttons for quick navigation
- Configurable bouncer ped selection via dropdown
- Delete confirmation prompts — no accidental data loss
## Drunkenness System
- Alcohol accumulates per drink based on ABV percentage
- Four intensity tiers: light, moderate, heavy, extreme
- Drunk walk cycles, visual screen effects, and camera shake
- Configurable decay rate and max alcohol level
- All effects individually toggleable in config
## Drink Item System
- **18 pre-configured cocktail recipes** included out of the box
- Default drinks auto-populate on new club creation
- Drinks reflect recipe colors when held and consumed
- Installation files for **QBCore**, **ox_inventory**, **qs-inventory**, and **ESX**
- Invalid flavor detection — drinks with removed flavors gracefully degrade
## Framework & Compatibility
| Category | Supported |
|----------|-----------|
| Framework | QBCore, QBX, ESX, Standalone |
| Target | ox_target, qb-target, qtarget |
| Inventory | ox_inventory, qs-inventory, qb-inventory |
| Society | qb-management, qb-banking, esx_addonaccount |
| Required | ox_lib, mysql-async / oxmysql |
## UI / UX
- Fully custom **React/TypeScript** NUI — no generic ox_lib menus
- Slide-in animated panels for recipes, drink ordering, search, society, and club entry
- Interactive entity displays with hover scaling and cursor proximity
- Localization support with full English translation included
- All icons powered by Lucide React
## Developer Friendly
- Clean bridge architecture — add framework support without touching modules
- Entity type plugin system for custom entity types
- Single `config.lua` for all tunable values
- Per-club settings stored in MySQL with auto-migration
- Escrow-friendly — config, bridge, core, and locales are fully editable
Dependencies
-
ox_lib
-
Supports ESX, QBCore, and QBox.