RD Eye Contact.

Overview

RD Eye Contact adds synced head look between players. Wherever a player looks, other players nearby see their head turn that way, and when two players look at each other it feels like real eye contact.

• Look at a player and your head tracks their head
• Look at the world and your head follows where your camera points
• Smooth, frame-rate independent movement with natural head limits
• Looking at a vehicle targets the player inside it
• Automatically disabled while dead, ragdolling, falling, swimming, in a cutscene or free aiming
• Players can toggle it with a command or keybind, and the choice is saved
• Server-side validation and rate limiting on every update

It does not depend on any framework, so it works on ESX, QBCore, QBox and standalone servers.

Installation

Requirements

• A recent FiveM server artifact
• OneSync (the head look is synced with state bags)
• No other dependencies and no framework needed

Steps

1. Drop the resource folder into your resources directory and keep the folder name rd-eyecontact.
2. Add it to server.cfg:

ensure rd-eyecontact

3. Open config.lua and adjust anything you want. All settings are optional.
4. Restart the server. A green start message appears in the client F8 console when the resource loads.

How it works

The system has three parts:

1. Capture. Every Capture.Interval ms the looking player's camera casts a ray. If it hits another player (or a vehicle with a player inside), that player is the target. Otherwise the point the ray hit, or a point ahead of the camera, is the target.
2. Sync. The target is stored in a state bag (StateBagKey) and only re-sent when it changes enough. The server validates every update and clears anything invalid or spammed.
3. Apply. Nearby clients read that target, smooth it, clamp it to natural head limits, and turn the head with TaskLookAtCoord.

Only players within Apply.Range are processed, so the cost stays low on busy servers.

Configuration reference

Everything lives in config.lua. Defaults below are the values shipped in the file.

General

Capture

Controls the player who is looking (Config.Capture).

Apply

Controls what you see on other players (Config.Apply).

Head limits

Blocked states

Set a state to true to disable head look while it is active (Config.Blocked).

Mutual eye contact

Server protection

Commands & keybind

/eyecontact toggles the feature for the player who types it. It turns both sending and receiving on or off and shows a message on screen. The command name comes from Config.Command.

The player's choice is saved on their own computer and kept between sessions, so they do not have to toggle it again after reconnecting.

A keybind named Toggle Eye Contact is registered for every player. Set Config.DefaultKey to give it a default key (for example 'F10'), or leave it empty and players can bind a key in Settings, Key Bindings, FiveM.

Exports (paid)

These client-side exports let other scripts work with RD Eye Contact.

Pausing from another script

Useful for emotes, handcuffs, cameras or phone calls, where the head should not follow the camera. The pause stays active until every script that paused it has resumed.

-- stop broadcasting my gaze
exports['rd-eyecontact']:SetPaused('my-emote-script', true)

-- start broadcasting again
exports['rd-eyecontact']:SetPaused('my-emote-script', false)

SetPaused only stops your own gaze from being sent. You still see other players' heads turning.

Checking eye contact

local targetServerId = 12
if exports['rd-eyecontact']:IsInEyeContact(targetServerId) then
    print('Eye contact with player 12')
end

Events (paid)

When you look at a player and that player is looking at you, a client event fires. It fires again when the eye contact ends. This needs Config.Mutual.Enabled = true.

AddEventHandler('rd-eyecontact:mutual', function(serverId, isMutual)
    if isMutual then
        print('Eye contact started with ' .. serverId)
    else
        print('Eye contact ended with ' .. serverId)
    end
end)

Ideas: show an interaction prompt only while two players make eye contact, change stress or reputation in roleplay scripts, or trigger an emote or sound when someone stares at you.

Free vs paid

The scripts are protected with Cfx.re Asset Escrow in both versions. Only config.lua is open. Get the full version on our Tebex store.

Troubleshooting

Nothing happens, no heads turn

OneSync is not enabled. State bags need OneSync. Also check Config.DefaultEnabled and that the player has not toggled it off with /eyecontact.

One player's head does not turn

The player may be farther than Apply.Range, or be in a blocked state (dead, ragdoll, swimming and so on).

Head turns too slowly

Increase Apply.SmoothSpeed (try 22.0) and lower Apply.TaskRefresh (try 60).

Head movement looks robotic or too snappy

Lower Apply.SmoothSpeed (try 13.0).

Head does not move inside vehicles

Check Blocked.InVehicle is false. To target someone inside a car, Capture.LookAtVehicleOccupants must be true; raise VehicleOccupantRadius slightly if needed.

Gaze gets cleared on the server

The player is sending too many updates or an invalid look point. Raise Server.MaxUpdatesPerSecond if you lowered Capture.Interval a lot. Turn on Config.Debug to see the reason in the server console.

Performance on a very busy server

Set Capture.Interval to 75 and use a lower Apply.Range.

Still stuck? Contact us or ask in the release thread on the Cfx.re forum.