CfxNativesCfxNatives
NativesModelsReferencesArtifactsAbout

Not affiliated with Rockstar Games or Take-Two Interactive. FiveM and Cfx.re are trademarks of their respective owners. cfxnatives.dev is an independent community project.

UZ Scripts logoMaintained by uz-scripts

© 2026 cfxnatives.dev

contact@cfxnatives.dev
PEDClient
Artifact31623

RegisterPedheadshotTransparent

Docs
local retval = RegisterPedheadshotTransparent(ped)

Description

Similar to REGISTER_PEDHEADSHOT but creates a transparent background instead of black.

Result of the example code:
<https://i.imgur.com/iHz8ztn.png>

Parameters

NameTypeDescription
pedPedA ped handle.
🚶Quick Snippet: Get Ped Handle
ped

Use this to get the player ped handle for this native.

-- Get the player's ped handle (client-side)
local ped = PlayerPedId()
print("Ped handle: " .. ped)

-- For a specific player's ped (server-side):
-- local targetPed = GetPlayerPed(source)
🚶

Ped Models

View All
Mp M Freemode 0 1
mp_m_freemode_01
Player Zero
player_zero
Ig Agatha
ig_agatha
S M Y Cop 0 1
s_m_y_cop_01
S M M Gaffer 0 1
s_m_m_gaffer_01
G M M Armboss 0 1
g_m_m_armboss_01
A C Boar
a_c_boar
A M M Bevhills 0 1
a_m_m_bevhills_01

Returns

int

Returns an integer value.

Examples

Official
CreateThread(function()
    -- Get the ped headshot image.
    local handle = RegisterPedheadshotTransparent(PlayerPedId())
    while not IsPedheadshotReady(handle) or not IsPedheadshotValid(handle) do
        Wait(0)
    end
    local txd = GetPedheadshotTxdString(handle)

    -- Add the notification text, the more text you add the smaller the font
    -- size will become (text is forced on 1 line only), so keep this short!
    SetNotificationTextEntry("STRING")
    AddTextComponentSubstringPlayerName("Transparent Headshot")

    -- Draw the notification
    DrawNotificationAward(txd, txd, 200, 0, "FM_GEN_UNLOCK")
    
    -- Cleanup after yourself!
    UnregisterPedheadshot(handle)
end)

Framework Usage

1 example
Get Ped Mugshot
Clientlua
-- ESX ped mugshot capture
local mugshot, txd = ESX.Game.GetPedMugshot(ped)
print("Mugshot handle:", mugshot)
print("Texture dict:", txd) -- Use as sprite texture

-- Transparent background version:
local mugshot, txd = ESX.Game.GetPedMugshot(ped, true)

-- Draw the mugshot:
DrawSprite(txd, txd, 0.1, 0.1, 0.1, 0.15, 0.0, 255, 255, 255, 255)

-- Remember to unregister when done:
UnregisterPedheadshot(mugshot)

Uses RegisterPedheadshot (or RegisterPedheadshotTransparent) + IsPedheadshotReady wait loop + GetPedheadshotTxdString. Returns both the handle (for cleanup) and txd string (for drawing). DoesEntityExist check before capturing.

Server Artifacts

Data sourced from jgscripts artifact-db
Recommended31623
Known Issues34
32698Failed Windows build (works OK if using Linux!)
31725Failed build
31689GetVehiclePedIsIn server native returns 0 (citizenfx/fivem#4051)
28626Issues with packet loss/timeouts
27783-27938SIGSEV crashes (issue #3915)
27722Yarn fails to exit cleanly on Windows
26261-27715Issues with building Yarn resources on some Linux servers
25943Failed build
25839-25988Node.js sandboxing seems to be causing issues for people - best to avoid for now
21547Multiple (unconfirmed) reports of server-sided natives throwing errors or causing crashes; best to avoid
17462Failed build, ignore
16276Multiple reports of issues loading JS within resources
14583-14716Crash when using the new onEntityBucketChange
14583-14862Timeouts due to latency units being in nanoseconds
13759-13890Mumble (voice) external connections blocked by default
13380-13458Server crashing due to integer encoding (PR#3235)
13079Failed Linux build (works OK if using Windows!)
12933-13045Still crashes (sometimes) when restarting resources due to Node.js 22
12913-12932Causes a crash when restarting Node.js 22
12913-14177High FXServer CPU usage on Linux artifacts; fixed by 14193 (citizenfx/fivem#3222)
12767os.date() appends null terminator; can break Lua scripts
12651Failed Linux build, ignore
12509Failed build, ignore
12255Unconfirmed, but several reports of server-side issues that don't persist when downgrading; best to avoid
12180voip-server-mumble.dll server crash (citizenfx/fivem#3054)
12160-12165Cannot use entity native calls in entityRemoved
12151Crashing if using newest title update (TU)
12092-12135SetPlayerModel may cause SIGSEGV crashes on some clients due to changes in player handling. 12031 and below works fine.
12078-12083Some clients will fail to connect with 'ReadBulk of header failed' error
10930Failed build, ignore
10268-10309sv_experimentalNetGameEventHandler enabled by default; can cause server crashing and reports of issues downgrading after upgrading
10191GetVehicleNumberPlateText server native broken, will cause issues with scripts involving vehicles
10072Crashing when players join
8509State bags not replicated to clients
Taintless logo
SponsoredFrom the makers of CfxNatives

Build a branded Tebex webstore

A storefront builder and analytics layer for Tebex stores.

Visit Taintless