🍿⃢📺 FX-INTERACTIONS

Advanced interaction system for RedM allowing players to interact with chairs, benches, beds, pianos, and baths with animations, prompts, and full framework compatibility.

---

📦 INSTALLATION

ensure fx-interactions

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

---

⚙️ BASIC CONFIG

Config.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

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

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

---

🎯 INTERACTION PROMPTS

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

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

---

🧠 SCENARIO SYSTEM

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

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

---

🛏️ BED SYSTEM

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

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

---

🎹 PIANO SYSTEM

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

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

---

🛁 BATH SYSTEM

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

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

---

🧼 EFFECT SYSTEM

Config.Effects = {
    ['clean'] = function()
    }

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

---

🔄 POSITION SYSTEM

Config.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

Config.UseTarget = true

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

---

🎮 CONTROL SYSTEM

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

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

---

🎨 VISUAL SYSTEM

Config.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

favorites.json

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

---

🛏️ PROP POSITION CONFIG

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

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

---

🔔 NOTIFY SYSTEM

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