🚬 FX-HOOKAH

Advanced and fully optimized hookah system for RedM with realistic smoking mechanics, synchronized smoke effects, coal & tobacco systems, rope interaction, and immersive roleplay features.

---

📦 INSTALLATION

ensure xsound
ensure gs_gizmo
ensure fx-hookahprops
ensure fx-hookah

• Add resources into your server.cfg • xsound is required only if sound enabled • gs_gizmo is required for placement system

---

⚠️ ARTIFACT REQUIREMENT

Recommended Artifact: 25770

• Required for stability • New artifacts may cause crashes

---

📦 INVENTORY SETUP (RSG)

hookah_silver = { name = 'hookah_silver' }
tobacco_love66 = { name = 'tobacco_love66' }
hookah_coal = { name = 'hookah_coal' }

• Add items into rsg-core/shared/items.lua • Includes hookahs, tobacco and coal

---

📦 INVENTORY SETUP (VORP)

INSERT INTO items (...)
VALUES ('hookah_silver', 'Silver Hookah', ...)

• Add items into database • Required for VORP framework

---

🖼️ ITEM IMAGES

ITEMPNG/

• Copy images into your inventory image folder • Required for UI display

---

⚙️ BASIC SETTINGS

Config.Language = "en"
Config.Debug = false

• Language system • Debug mode enables server commands

---

🌐 LOCALE SYSTEM

Config.Locale = {
  ["en"] = {}
}

• Multi-language support • Supports dynamic text (${value})

---

🔊 SOUND SYSTEM

Config.HookahSound = true
Config.HookahSoundDistance = 20.0
Config.HookahSoundVolume = 0.05

• Enables hookah bubbling sound • Requires xsound

---

🎯 INTERACTION SYSTEM

Config.UseTarget = false

• false → prompt system • true → target system

---

Config.Prompts = {
  ["carry"] = {},
  ["ground"] = {}
}

• Full interaction system • Separate states for carry and ground

---

🔥 COAL SYSTEM

Config.CoalDecay = {
  enabled = true,
  decayInterval = 120,
  decayAmount = 1
}

• Coal decreases over time • Must be refilled

---

💨 SMOKE SYSTEM

Config.Smoke = {
  key = 0x5415BE48,
  minHoldTime = 300,
  maxHoldTime = 3000,
  minScale = 0.5,
  maxScale = 5.0
}

• Hold-to-smoke system • Longer hold = stronger smoke

---

tobaccoBaseRate = 0.1

• Controls tobacco consumption speed

---

🍃 TOBACCO SYSTEM

Config.Tobacco = {
  ["love66"] = {
    duration = 600,
    density = 1.0
  }
}

• Defines tobacco types • duration → lifetime • density → smoke strength

---

🚬 HOOKAH TPYES

Config.Hookahs = {
  ["hookah_gold"] = {
    smokeMultiplier = 1.3,
    durationMultiplier = 1.2
  }
}

• Defines hookah variants • Each has unique stats

---

🔗 HOSE SYSTEM

Config.Hose = {
  prop = "fx_shishahand_bk",
  ropeLength = 3.5
}

• Creates rope + hose system • Fully synced between players

---

🔧 REPAIR SYSTEM

Config.RepairHookah = {
  allowRepair = true,
  repairNeedsItems = {
    {item = "hookah_coal", amount = 1}
  }
}

• Allows coal refill • Can require items

---

🔒 DELETE SYSTEM

Config.DeleteBoxSettings = {
  allowDelete = true,
  allowJobs = {
    ["sheriff"] = true
  }
}

• Controls who can delete hookah • Supports job & group permissions

---

📦 DATA SYSTEM

hookah.json

• Stores hookah states • Includes: • coal • tobacco • position • usage state

---

🎭 PROPS

hookah: fx_shisha_bk
hand: fx_shishahand_bk

• Hookah & hose models

---

🔄 CORE FEATURES

• Carry / Place system • Hold-to-smoke mechanic • Coal decay & refill • Tobacco system • Rope & hose interaction • Sound system • Multi hookah types • Fully synced system

---

🔔 NOTIFICATION SYSTEM

Notify({
  text = "Message"
})

• Supports VORP / RSG / REDEMRP • Unified notification system

---

⚠️ IPMORTANT NOTES

• Use recommended artifact version • Items must be installed • xsound required if enabled • gs_gizmo required • Tobacco required to smoke

---

🚨 COMMON ISSUES

• Cannot smoke → no tobacco • No sound → xsound missing • Cannot place → gizmo missing • Hookah not syncing → distance issue • Coal empty → refill required

---

🏁 SUMMARY

FX-HOOKAH provides:

• Advanced hookah system • Realistic smoking mechanics • Coal & tobacco system • Rope & hose interaction • Fully synced effects • Multi-framework compatibility

---

© Fixitfy Development