#📦 INSTALLATION

bashensure fx-nightclub

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

---

#⚙️ BASIC SETTINGS

luaConfig.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)

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

luaConfig.DefaultStageCenter = vector4(...)

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

---

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

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

---

#💃 DANCER SYSTEM

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

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

---

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

• Defines selectable dancers
• Used in menu system

---

#🎬 SHOW CONTROL

luaConfig.StartDanceCommand = "dancers"

• Command to start show
• Can be restricted by job

---

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

• Restricts who can use command
• Job + grade based

---

#💸 MONEY RAIN SYSTEM

luaConfig.RainMoney = 5

• Amount of money thrown during show
• Adds immersion

---

#🧍 SPAWN SYSTEM

luaConfig.DefaultSpawnBackStage = vector4(...)

• Spawn location for dancers
• Used before show starts

---

#🎥 CAMERA SYSTEM

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

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

---

#🛏️ PRIVATE ROOM SYSTEM

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

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

---

luaminutePriceMultiplier = 2.0

• Price per minute
• Used for private dances

---

luaisBussy = false

• Prevents multiple players using same room
• Avoids conflicts

---

#💃 PRIVATE DANCERS

luaDancers = {
  ["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

luaConfig.AfterServicePlayerEffects = function()

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

---

#🎯 HUD CONTROL

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

• Controls UI visibility
• Used during show
• Prevents distractions

---

#🎬 ANIMATION SYSTEM

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

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

---

#🪑 PROP REQUIREMENTS

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

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

---

#🔔 NOTIFY SYSTEM

luaNotify({
  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