Exports API

The implant system exposes exports for other scripts to query implant states, apply effects, and manage inventory bonuses. All exports use the resource name implant_system.

🖥️ Client-Side Exports

These exports run on the client and can be called from any client script.

---

IsImplantActive(implantId)

Checks if an active implant ability is currently running (toggled on or within its duration window).

local active = exports['implant_system']:IsImplantActive('night_optics')
if active then
    -- Night vision is currently toggled on
end

Parameter	Type	Description
implantId	string	The implant ID to check

Returns: boolean

---

HasImplant(implantId)

Checks if a player has a specific implant installed (regardless of whether it's active).

if exports['implant_system']:HasImplant('stabilizer') then
    -- Player has the stabilizer implant installed
end

Parameter	Type	Description
implantId	string	The implant ID to check

Returns: boolean

---

GetInstalledImplants()

Returns a table of all currently installed implants with their level and type.

local implants = exports['implant_system']:GetInstalledImplants()
for id, data in pairs(implants) do
    print(id, 'Level:', data.level, 'Passive:', data.passive)
end

Returns: table — { [implantId] = { level = number, passive = boolean }, ... }

---

GetStabilizerData()

Returns data for the Stabilizer implant (camera shake / recoil suppression).

local stab = exports['implant_system']:GetStabilizerData()
if stab then
    print('Stabilizer Level:', stab.level)
    print('Shake Suppression:', stab.camShakeSuppress) -- 0.25 / 0.40 / 0.55
end

Returns: table or nil

Field	Type	Values
installed	boolean	Always true
level	number	1–3
camShakeSuppress	number	0.25 (L1), 0.40 (L2), 0.55 (L3)

---

GetPainEditorData()

Returns data for the Pain Editor implant (ragdoll reduction).

local pain = exports['implant_system']:GetPainEditorData()
if pain then
    print('Ragdoll Reduction:', pain.reduceRagdoll) -- 0.35 / 0.55 / 0.75
    -- Level 3 (0.75): fully disables ragdoll
    -- Level 2 (0.55): blocks player-impact ragdoll only
    -- Level 1 (0.35): default ragdoll behavior
end

Returns: table or nil

Field	Type	Values
installed	boolean	Always true
level	number	1–3
reduceRagdoll	number	0.35 (L1), 0.55 (L2), 0.75 (L3)

Ragdoll behavior by level:

• >= 0.70 — All ragdoll disabled

• >= 0.40 — Player-impact ragdoll blocked, other ragdoll still applies

• < 0.40 — Default GTA ragdoll behavior

---

GetFallDampenerData()

Returns data for the Fall Dampener implant (fall damage reduction).

local fall = exports['implant_system']:GetFallDampenerData()
if fall then
    print('Damage Reduction:', fall.damageReducePct)  -- 0.20 / 0.30 / 0.40
    print('Min Fall Meters:', fall.minFallMeters)      -- 6.0 / 5.0 / 4.5
end

Returns: table or nil

Field	Type	Values
installed	boolean	Always true
level	number	1–3
damageReducePct	number	0.20 (L1), 0.30 (L2), 0.40 (L3)
minFallMeters	number	6.0 (L1), 5.0 (L2), 4.5 (L3)

---

GetBreathAssistData()

Returns data for the Breath Assist implant (underwater breathing).

local breath = exports['implant_system']:GetBreathAssistData()
if breath then
    print('Max Underwater Time:', breath.maxUnderwaterTime) -- 35 / 55 / 80 seconds
end

Returns: table or nil

Field	Type	Values
installed	boolean	Always true
level	number	1–3
maxUnderwaterTime	number	35.0 (L1), 55.0 (L2), 80.0 (L3)

---

GetInventoryExpansionData()

Returns data for the Inventory Expansion implant (weight & slot bonus). This is the client-side view — for authoritative server-side data, use the server export GetInventoryBonus.

local inv = exports['implant_system']:GetInventoryExpansionData()
if inv then
    print('Weight Bonus:', inv.maxWeightBonus) -- 5000 / 10000 / 15000
    print('Slot Bonus:', inv.slotBonus)        -- 2 / 4 / 6
end

Returns: table or nil

Field	Type	Values
installed	boolean	Always true
level	number	1–3
maxWeightBonus	number	5000 (L1), 10000 (L2), 15000 (L3)
slotBonus	number	2 (L1), 4 (L2), 6 (L3)

---

ForceApplyPassives()

Forces the system to re-apply all passive effects (ragdoll, camera shake, underwater breathing, fall dampener). Useful when another script resets native ped settings and you need the implant effects re-applied.

-- Example: after your script resets ragdoll, force implants to re-apply
SetPedCanRagdoll(PlayerPedId(), true)
-- Now let implants override if the player has Pain Editor:
exports['implant_system']:ForceApplyPassives()

Returns: nothing

---

🖧 Server-Side Exports

These exports run on the server and require a source (player server ID).

---

HasImplant(source, implantId)

Checks if a player has a specific implant installed.

local has = exports['implant_system']:HasImplant(source, 'double_jump')

Parameter	Type	Description
source	number	Player server ID
implantId	string	The implant ID to check

Returns: boolean

---

GetImplants(source)

Returns the full implant state for a player (installed, active, heat, etc.).

local state = exports['implant_system']:GetImplants(source)
if state then
    for socket, implants in pairs(state.installed or {}) do
        for _, imp in ipairs(implants) do
            print(socket, imp.implantId, 'Level:', imp.level)
        end
    end
end

Parameter	Type	Description
source	number	Player server ID

Returns: table (full state) or nil

---

GetImplantLevel(source, implantId)

Returns the level of a specific implant (0 if not installed).

local level = exports['implant_system']:GetImplantLevel(source, 'stabilizer')
if level > 0 then
    print('Player has Stabilizer level', level)
end

Parameter	Type	Description
source	number	Player server ID
implantId	string	The implant ID

Returns: number — 0 (not installed), 1, 2, or 3

---

GetPassiveImplantData(source, implantId)

Returns detailed data about any passive implant for a player.

local data = exports['implant_system']:GetPassiveImplantData(source, 'pain_editor')
if data then
    print('Pain Editor Level:', data.level)
    print('Ragdoll Reduction:', data.effects.reduceRagdoll)
end

Parameter	Type	Description
source	number	Player server ID
implantId	string	The implant ID

Returns: table or nil

Field	Type	Description
installed	boolean	Always true
level	number	1–3
effects	table	Effect values for the current level

---

GetInventoryBonus(source)

Returns the complete inventory weight and slot bonus breakdown for a player. This is the authoritative server-side calculation.

local bonus = exports['implant_system']:GetInventoryBonus(source)
print('Base Weight:', bonus.baseWeight)         -- e.g. 85000
print('Weight Bonus:', bonus.totalWeightBonus)  -- e.g. 10000
print('Final Weight:', bonus.finalWeight)       -- e.g. 95000
print('Base Slots:', bonus.baseSlots)           -- e.g. 50
print('Slot Bonus:', bonus.totalSlotBonus)      -- e.g. 4
print('Final Slots:', bonus.finalSlots)         -- e.g. 54

Parameter	Type	Description
source	number	Player server ID

Returns: table

Field	Type	Description
totalWeightBonus	number	Total weight added by implants
totalSlotBonus	number	Total slots added by implants
baseWeight	number	Config.BaseWeight value
baseSlots	number	Config.BaseSlots value
finalWeight	number	baseWeight + totalWeightBonus
finalSlots	number	baseSlots + totalSlotBonus

---

RecalculatePassiveStats(source)

Forces the server to recalculate and re-apply weight and slot bonuses to the player's inventory. Useful after external inventory modifications.

-- After your script modifies inventory weight externally:
exports['implant_system']:RecalculatePassiveStats(source)

Parameter	Type	Description
source	number	Player server ID

Returns: boolean — true if successful, false if player state not found

---

InstallImplant(source, implantId, socketId, opts)

Programmatically install an implant on a player (validates requirements, removes items).

local ok, err = exports['implant_system']:InstallImplant(source, 'night_optics', 'head', {})
if not ok then
    print('Install failed:', err)
end

Parameter	Type	Description
source	number	Player server ID
implantId	string	The implant ID
socketId	string	Target socket ID
opts	table	Optional parameters

Returns: boolean, string? — success, error message

---

RemoveImplant(source, socketId)

Programmatically remove an implant from a socket.

local ok, err = exports['implant_system']:RemoveImplant(source, 'head')

---

UpgradeImplant(source, socketId)

Programmatically upgrade an implant in a socket.

local ok, err = exports['implant_system']:UpgradeImplant(source, 'head')

---

ActivateImplant(source, implantId, context)

Programmatically activate an implant ability.

local ok, err = exports['implant_system']:ActivateImplant(source, 'sprint_boost', { via = 'script' })

---

💡 Common Use Cases

Prevent custom shake if player has Stabilizer

-- Client-side: before applying your own camera shake
local stab = exports['implant_system']:GetStabilizerData()
if not stab then
    -- Player does NOT have stabilizer, apply normal shake
    ShakeGameplayCam('SMALL_EXPLOSION_SHAKE', 0.5)
end

Scale ragdoll from other scripts

-- Client-side: check if player has anti-ragdoll before your ragdoll event
local pain = exports['implant_system']:GetPainEditorData()
if pain and pain.reduceRagdoll >= 0.70 then
    -- Player is immune to ragdoll, skip your effect
    return
end

Re-apply effects after resource restart

-- Client-side: if your script resets ped properties
exports['implant_system']:ForceApplyPassives()

Check inventory bonus before trade

-- Server-side: get the real carry capacity including implant bonus
local bonus = exports['implant_system']:GetInventoryBonus(source)
print('Player can carry', bonus.finalWeight, 'grams across', bonus.finalSlots, 'slots')

---

Last updated: February 2026