#📦 INSTALLATION

bashensure fx-interactions

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

---

#⚙️ BASIC CONFIG

luaConfig.Language = "en"
Config.UseTarget = true
Config.PromptDistance = 2.0

• Language → system language
• UseTarget → enables target system (ox_target / etc.)
• PromptDistance → interaction distance if target is disabled

---

#🪑 PROP SYSTEM

luaConfig.Chairs = { ... }
Config.Benches = { ... }
Config.Beds = { ... }

• Defines all interactable props
• Supports chairs, benches, beds
• System auto-detects nearby props

---

#🎯 INTERACTION PROMPTS

luaConfig.Prompts = {
    ["sit"] = {
        label = "Chair Interaction",
        distance = 3.0,
    }
}

• Defines interaction prompts
• Supports hold key system
• Multiple interaction menus available

---

#🧠 SCENARIO SYSTEM

luaConfig.ChairScenarios = {
    [1] = {name = "GENERIC_SEAT_BENCH_SCENARIO"},
}

• Defines available animations
• Each interaction triggers a scenario
• Supports male/female restrictions

---

#🛏️ BED SYSTEM

luaConfig.BedScenarios = {
    { name = 'PROP_HUMAN_SLEEP_BED_PILLOW' }
}

• Allows sleeping interactions
• Multiple sleep animations
• Supports ground and bedroll

---

#🎹 PIANO SYSTEM

luaConfig.PianoScenarios = {
    { name = 'PROP_HUMAN_PIANO' }
}

• Allows piano interactions
• Multiple piano styles
• Gender-based restrictions supported

---

#🛁 BATH SYSTEM

luaConfig.BathingAnimations = {
    { name = 'bathing_idle_02' }
}

• Bath interaction system
• Includes scrub animations
• Supports clean effects

---

#🧼 EFFECT SYSTEM

luaConfig.Effects = {
    ['clean'] = function()

• Applies effects after interaction
• Example → removes dirt/blood
• Fully customizable

---

#🧍 POSITION SYSTEM

luaConfig.PropOffsetOverrides = {
    ["p_bed20x"] = { x = 0.0, y = 0.0, z = 0.5 },
}

• Adjusts player position per prop
• Fixes clipping issues
• Allows precise alignment

---

#🎯 TARGET SYSTEM

luaConfig.UseTarget = true

• Enables target-based interaction
• Supports multiple target systems
• Auto-detection available

---

#🎮 CONTROL SYSTEM

luaConfig.DisableControls = {
    [0x26E9DC00] = true,
}

• Disables controls during interaction
• Prevents breaking animations
• Improves immersion

---

#🎨 VISUAL SYSTEM

luaConfig.DrawMarker = { open = false }
Config.DrawLight = { open = true }
Config.DrawTexture = { open = true }

• Controls interaction visuals
• Marker → ground indicator
• Light → glow effect
• Texture → UI marker

---

#🧍 NPC / FAVORITES SYSTEM

jsonfavorites.json

• Stores saved interaction presets
• Allows custom interaction menus
• Supports player preferences

---

#🛏️ PROP POSITION CONFIG

luaConfig.BedsOptions = { ... }
Config.BenchesOptions = { ... }

• Defines exact sitting/sleep positions
• Supports left / right / middle selection
• Fully customizable offsets

---

#🔔 NOTIFY SYSTEM

luaNotify({
  text = "Interaction Started",
  type = "success"
})

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

---

#⚠️ IMPORTANT NOTES

• Props must exist in game world
• Config lists must match prop names
• Target system must be installed if enabled
• Offsets may require adjustment per map
• Some scenarios are gender-restricted

---

#🚨 COMMON MISTAKES

• Interaction not working → wrong prop name
• Player sitting in wrong position → offset not set
• No interaction menu → target system missing
• Animation not playing → invalid scenario name

---

#🏁 SUMMARY

FX-INTERACTIONS provides:

• Full prop interaction system
• Chair / bench / bed / piano / bath support
• Scenario-based animations
• Target & prompt system
• Fully customizable interaction logic

---

© Fixitfy Development