👯Shared Emotes

Two-player synchronized emotes (couples, handshakes, etc.) with a request/accept system.

---

How it works

1. Open the emote menu and go to the Shared tab

2. Click a shared emote

3. The system finds the nearest player within range

4. A request is sent to the target player

5. The target sees a prompt:

   • Press E to accept

   • Press X to decline

   • Press ALT to switch target (if multiple players nearby)

6. If accepted, both players are positioned and play their respective animations

If the target doesn't respond within the timeout (10 seconds by default), the request is automatically declined.

---

Positioning

Shared emotes use sync parameters to position the two players relative to each other:

Parameter	Description
front	Distance in front of the initiator (1.0)
side	Lateral offset (0.0)
height	Vertical offset (0.0)
heading	Heading difference (180.1 = facing)

Some shared emotes also use bone attachments for precise alignment.

---

Server validation

The server validates every shared emote request:

• Rate limiting -- one request per 2 seconds per player

• Distance check -- both players must be within MaxRange

• Ped existence -- ensures both players are spawned

---

Config

Config.SharedEmotes = {
    MaxRange = 3.0,          -- Max distance between players
    RequestTimeout = 10,     -- Seconds before auto-decline
    AcceptControl = 51,      -- Accept key (E)
    DeclineControl = 73,     -- Decline key (X)
    CycleTargetControl = 19, -- Cycle target key (Alt)
}