💃 FX-NIGHTCLUB

Advanced nightclub system for RedM with dancer shows, private rooms, money system, camera system, and full framework compatibility.

---

📦 INSTALLATION

ensure fx-nightclub

• Place the script inside resources/fx-nightclub • Add ensure fx-nightclub to your server.cfg • Restart your server

---

⚙️ BASIC SETTINGS

Config.Language = "en"
Config.StartShowUseGameTime = false
Config.ForceShowLoop = 5

• Language → system language • StartShowUseGameTime → game time or real time (UTC) • ForceShowLoop → automatic show interval (minutes)

---

💰 MONEY SYSTEM (DATA.JSON)

{"money":1070.0,"ShowTimes":["02:15","02:20","02:25"]}

• money → total nightclub safe money • ShowTimes → scheduled show times • Used for automatic show system

---

🎭 SHOW SYSTEM

Config.DefaultStageCenter = vector4(...)

• Defines main stage location • All dancers perform here • Central point of show system

---

Config.Scene = {
  [1] = { dict = "...", name = "..."}
}

• Defines dance scenes • Supports animation sequences • Can include custom actions

---

💃 DANCER SYSTEM

Config.Dancer = {
  [1] = {
    model = "cs_sworddancer",
    outfit = 3
  }
}

• Defines dancers • Each dancer has model, outfit, spawn position • Used in show system

---

Config.Catalogues = {
  {
    model = "cs_sworddancer"
  }
}

• Defines selectable dancers • Used in menu system

---

🎬 SHOW CONTROL

Config.StartDanceCommand = "dancers"

• Command to start show • Can be restricted by job

---

Config.UseCommandPermission = {
  ["saintdenissaloon"] = 0
}

• Restricts who can use command • Job + grade based

---

💸 MONEY RAIN SYSTEM

Config.RainMoney = 5

• Amount of money thrown during show • Adds immersion

---

🤠 SPAWN SYSTEM

Config.DefaultSpawnBackStage = vector4(...)

• Spawn location for dancers • Used before show starts

---

🎥 CAMERA SYSTEM

cameras = {
  [1] = { x = ..., y = ..., z = ... }
}

• Defines cinematic camera angles • Players can switch between cameras • Improves immersion

---

🛏️ PRIVATE ROOM SYSTEM

Config.SpecialDance = {
  Rooms = {
    ["Room 1"] = {
      price = 200
    }
  }
}

• Private dance rooms • Each room has price, coords, cameras • Supports exclusive interactions

---

minutePriceMultiplier = 2.0

• Price per minute • Used for private dances

---

isBussy = false

• Prevents multiple players using same room • Avoids conflicts

---

💃 PRIVATE DANCERS

Dancers = {
  ["Sword Dancer"] = {
    model = "cs_sworddancer",
    price = 200
  }
}

• Defines dancers for private rooms • Each dancer has price and model • Can include custom animations

---

🎮 PLAYER EFFECT SYSTEM

Config.AfterServicePlayerEffects = function()

• Applies effects after service • Example → restore health/stamina • Fully customizable

---

🎯 HUD CONTROL

Config.HideHud = function()
Config.ShowHud = function()

• Controls UI visibility • Used during show • Prevents distractions

---

🎬 ANIMATION SYSTEM

Config.Animations = {
  ["kiss"] = {
    label = "Kiss"
  }
}

• Includes synced animations • Supports couple animations • Can be extended

---

🔨 PROP REQUIREMENTS

Config.Beds = { ... }
Config.ChairList = { ... }

• Required props for some animations • Example → bed / chair interactions

---

🔔 NOTIFY SYSTEM

Notify({
  text = "Show started",
  type = "success"
})

• Framework-based notification system • Supports VORP / RSG / gm_core

---

⚠️ IMPORTANT NOTES

• data.json must exist • ShowTimes must be valid format • Rooms must not overlap • Dancers must have valid models • Camera positions must be correct

---

🚨 COMMON MISTAKES

• Show not starting → wrong time config • Room not working → already busy • Camera broken → wrong coords • No dancers → invalid model • Money issues → data.json not saving

---

🏁 SUMMARY

FX-NIGHTCLUB provides:

• Full nightclub system • Automatic show system • Private dance rooms • Camera & cinematic system • Money system • Dancer management

---

© Fixitfy Development