Config builder

X3D Carry config

Change values in the form, then copy one topic or the whole file into your server.

Download with my settings

💡 Already changed your config? Paste it to continue from it. Keys new in this version get ★.

General

Docs ↗

Config.Framework

Framework: 'auto' (ESX when present, otherwise standalone) | 'esx' | 'standalone'

Config.Locale

In-game language: 'th' or 'en' (edit the texts in locales.lua)

Config.Command

Command name of this resource (one command): /x3dcarry opens the menu, /x3dcarry piggyback calls a style directly

Do not use a short name like 'carry': if another script owns it FiveM silently drops ours, key binds stop working and no error shows

Config.MenuKey

Key that opens the carry menu ('' = no key, use /x3dcarry instead)

Config.Range

How close you must be to start a carry (metres)

Config.MaxDist

Max distance between the pair while carrying; beyond it the server releases them

Config.RequestTTL

How many ms a carry request stays open before it expires

Config.Cooldown

Anti-spam: one player may request a carry once every this many ms

Config.ForceAce

add_ace group.admin x3d_carry.force allow

ACE permission, works on every framework; put it in server.cfg: add_ace group.admin x3d_carry.force allow

Set to false to disable

Config.ForceGroups

Admin groups (ESX only; on standalone see Framework.IsAdmin in addons/framework/extra_server.lua)

e.g. { admin = true }

adminsuperadminmod

Config.ForceJobs

Jobs that carry without asking (ESX only; standalone has no standard job system)

e.g. { police = true }

policeambulance

Config.Corpse

Corpse carry, double-death guard =====

The game cannot animate a dead ped, so the body is fake-revived with NetworkResurrectLocalPlayer first

and a corpse animation is played over it; that window is where other systems may kill it again

fakeHealth

Health given to the body while carried (must be > 0 or the game counts it as dead)

healthGuard

Guards against other scripts setting health to 0 directly: it restores health every guardInterval ms while carried

enable the health restore

guardInterval

check interval (ms)

liftOnPickup

Metres to lift the body before the fake revive (keeps it from sinking into the floor)

liftOnDrop

Metres to lift the body on drop, so it has room to fall

ragdollOnDrop

Force the body to ragdoll onto the ground on drop (otherwise it stands stiff) / ragdollMs = how long, in ms

ragdollMs

ท่าอุ้ม — เพิ่มท่าใหม่ได้ ระบบสร้างเมนู + คำสั่งให้เองทุกท่า

Docs ↗

Config.Styles

Styles · 3 rows
#	Name	offset		Options
1	`dragdeath`
2	`carrypeople`
3	`piggyback`

Config.CarrierDelay

Delay in ms before the carrier starts the animation so the carried body can attach first

Lower than this and the paired animation drifts (floating piggyback / dropped fireman carry)

Config.Keys

Menu keys =====

FiveM control ids, same set as esx_menu_default: up/down arrows, Enter, Backspace

up

down

select

back