> For the complete documentation index, see [llms.txt](https://brunx-mods.gitbook.io/brunx-mods-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://brunx-mods.gitbook.io/brunx-mods-docs/products/scripts/nightclub-simulator.md).

# Nightclub Simulator

Setup and feature reference for Nightclub Simulator, formerly Nightclub Tycoon.

{% hint style="info" %}
Previously known as **Nightclub Tycoon**. Some configuration keys and resource identifiers may still use the original `brnx_nightclub_tycoon` name. Follow the filenames and instructions supplied with your product download.
{% endhint %}

Turn the Haute Nightclub interior into a deep, persistent management tycoon — one player owns the venue and runs its finances, bar, staff, marketing, music and security from a modern boss tablet, while a fully server-synced world of guest and staff NPCs keeps the club alive around the clock.

### 🎉 Overview

**brnx\_nightclub\_tycoon** transforms the Haute Nightclub MLO into a self-sustaining business. The owner buys the club, stocks the bar, hires NPC or player staff, opens the doors, and manages a living crowd — guests queue at the entrance, get frisked, then drink, dance, chat and tip. Two meters drive everything: **reputation** (your long-term prestige, saved between sessions) and **hype** (tonight's live party energy). Everything is controlled from a single role-aware tablet UI, and the club keeps earning even when player counts are low. Works with **QBCore, Qbox and ESX** out of the box.

### ✨ Features

* 🏢 **Own & Run a Club** — Buy the venue from an in-world realtor or have an admin assign ownership; list it for sale, transfer, or abandon it later from the tablet
* 📱 **Boss Tablet UI** — A sleek, role-aware management tablet with per-role tab access, so each job only sees what it needs
* 🕺 **Living Guest Crowd** — Server-side NPC guests arrive, queue, get searched, then dance, drink and chat; a busier, better-run club draws bigger crowds and culls NPCs out of sight to protect FPS
* ⭐ **Reputation & Hype** — Reputation is your persistent standing; hype is the live energy of the party — together they drive attendance, tips, and how much you can charge
* 🍾 **Bar & Supply Chain** — Stock Economy and Premium drinks, set menu prices per item, and restock with a delivery-van mission or paid express orders
* 👥 **NPC & Player Staff** — Hire bartenders, bouncers, security, medics, janitors, DJs, dancers and promoters as NPCs or real players, each with a salary and real duties
* 🎧 **Music & Light Show** — Control synced YouTube music from the DJ booth and toggle lasers, strobes, globes and fog; book fame-tiered NPC DJs for the night
* 💎 **VIP Booths & Dancers** — Claim booths, order bottle service, and summon dancers for tips
* 📣 **Marketing & Upgrades** — Launch ad campaigns to spike the crowd and buy permanent upgrades (sound system, laser array, fog machine, bar capacity, VIP lounge, marketing agency)
* 🚨 **Live Incidents** — Break up brawls, treat medical emergencies, and manage the contraband-and-raid risk while the doors are open
* 🧹 **Cleaning & Payroll** — Keep the venue clean (a dirty club can't open) and pay staff on a recurring payroll cycle
* 🎨 **Per-Player Tablet Theme** — Everyone can recolour their own tablet from presets or custom colours (purely cosmetic and personal)
* 🌍 **Auto-Detect Bridge** — Framework, inventory, target, notify, text-UI, progress bar, database and more are all detected automatically; English & Turkish locales included