❤️ FX-LOVE

Advanced interaction system for RedM allowing players to perform synced couple animations such as hug, kiss, sit, and more with request/accept mechanics and full framework compatibility.

---

📦 INSTALLATION

ensure fx-love

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

---

⚙️ BASIC CONFIG

Config.Language = "en"
Config.OpenMenuCommand = "love"
Config.AcceptRequest = "accept"

• Language → system language • OpenMenuCommand → command to open love menu • AcceptRequest → command to accept animation

---

🎮 INTERACTION SYSTEM

Config.Distance = 5
Config.RequestTime = 30000

• Distance → max player interaction range • RequestTime → how long request stays active • Prevents spam and abuse

---

🧠 REQUEST SYSTEM

Config.AcceptRequest = "accept"

• Target player must accept request • Prevents forced animations • Shows notification with request message

---

🚫 INTERACTION LIMIT SYSTEM

Config.CanInteract = function(src)

• Blocks interaction in restricted zones • Prevents usage in specific areas • Fully customizable

---

👮 JOB RESTRICTION SYSTEM

Config.OpenMenuJobRequired = false

• false → everyone can use • table → restrict by job • Example → sheriff / doctor only

---

👷 NPC SYSTEM

Config.NPCInteraction = true

• Enables NPC-based interaction • Optional feature • Can be disabled

---

🎬 ANIMATION SYSTEM

Config.Animations = {
    ["hug"] = {
        label = "Hug",
    }
}

• Defines all synced animations • player → initiator animation • target → receiver animation • Supports position offsets

---

🛏️ CHAIR / BED REQUIREMENT

nededChair = { ... }
nededBeds = { ... }

• Some animations require props • Example → chair or bed • Prevents animation misuse

---

🎯 POSITION SYSTEM

posX = 0.05
posY = 0.40
posZ = 0.0
rotZ = 180.0

• Controls player alignment • Ensures synced animation • Fully customizable

---

🎭 ANIMATION TYPES

["kiss"]
["hug"]
["slap"]
["sit"]

• Multiple interaction types available • Includes romantic, social, and fun animations • Expandable system

---

🎯 COMMAND SYSTEM

/love
/accept

• /love → opens interaction menu • /accept → accepts animation request

---

🎒 CLOTHING SYSTEM

Config.UnDress = function()
Config.Dress = function()

• Controls clothing behavior • Can remove / restore outfit • Fully customizable

---

💊 EFFECT SYSTEM

Config.FinishAnimaiton = function()

• Executes after animation ends • Example → reduce stress • Can trigger custom effects

---

🔨 PROP REQUIREMENT LIST

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

• Defines usable props • Required for certain animations • Must match map props

---

🚫 PED RESTRICTION SYSTEM

Config.BlackListPedTypes = {
    ["6"] = "PED_TYPE_COP",
}

• Prevents interaction with certain ped types • Example → police / animals • Improves realism

---

🔔 NOTIFY SYSTEM

Notify({
  text = "Request Sent",
  type = "info"
})

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

---

⚠️ IMPORTANT NOTES

• Players must be close to interact • Target must accept request • Some animations require props • Blacklisted ped types cannot interact • Distance must be configured properly

---

🚨 COMMON MISTAKES

• Animation not starting → target didn’t accept • Players too far → distance too high • Animation broken → wrong offsets • Menu not opening → wrong command • Chair/bed required → no prop nearby

---

🏁 SUMMARY

FX-LOVE provides:

• Synced player interaction system • Request / accept animation system • Multiple animation types • Prop-based interaction system • Full framework compatibility

---

© Fixitfy Development