~/docs/emote/configuration/shared-emotes
emote docs›
Emote
Shared Emotes
-- 1 code block · 1 min read
Two-player synchronized emotes (couples, handshakes, etc.) with a request/accept system.
How it works
- Open the emote menu and go to the Shared tab
- Click a shared emote
- The system finds the nearest player within range
- A request is sent to the target player
- The target sees a prompt:
- Press
Eto accept - Press
Xto decline - Press
ALTto switch target (if multiple players nearby)
- Press
- 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)
}