#📦 INSTALLATION

bashensure fx-love

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

---

#⚙️ BASIC CONFIG

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

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

---

#🎮 INTERACTION SYSTEM

luaConfig.Distance = 5
Config.RequestTime = 30000

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

---

#🧠 REQUEST SYSTEM

luaConfig.AcceptRequest = "accept"

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

---

#🚫 INTERACTION LIMIT SYSTEM

luaConfig.CanInteract = function(src)

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

---

#👮 JOB RESTRICTION SYSTEM

luaConfig.OpenMenuJobRequired = false

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

---

#🧍 NPC SYSTEM

luaConfig.NPCInteraction = true

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

---

#🎬 ANIMATION SYSTEM

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

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

---

#🪑 CHAIR / BED REQUIREMENT

luanededChair = { ... }
nededBeds = { ... }

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

---

#🎯 POSITION SYSTEM

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

• Controls player alignment
• Ensures synced animation
• Fully customizable

---

#🎭 ANIMATION TYPES

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

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

---

#🎯 COMMAND SYSTEM

bash/love
/accept

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

---

#🎒 CLOTHING SYSTEM

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

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

---

#💊 EFFECT SYSTEM

luaConfig.FinishAnimaiton = function()

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

---

#🧍 PROP REQUIREMENT LIST

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

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

---

#🚫 PED RESTRICTION SYSTEM

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

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

---

#🔔 NOTIFY SYSTEM

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