Clubs

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

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