Framework Events API

C7 Framework V3 provides server and client events that fire whenever a player loads or unloads a character.

These events allow developers to integrate jobs, inventories, HUDs, and other systems that depend on character data.

All events below are triggered automatically by the framework.

Player Load Events

1

C7FW:PLAYER_LOADED

Triggered when a player finishes selecting a character and has fully loaded into the game world.

What this event can be used for:

This is the main entry point for loading:

• jobs

• inventories

• HUD systems

• duty systems

• character-based data

Server Event:

Event Name

C7FW:PLAYER_LOADED

Arguments

Name	Type	Description
src	number	Player server ID
character	table	Character data table

Example

AddEventHandler("C7FW:PLAYER_LOADED", function(src, character)
    print(("[C7FW] Player %s loaded character %s %s"):format(
        src,
        character.char_first_name,
        character.char_last_name
    ))

    -- Load job systems
    -- Give duty items
    -- Initialize inventory
end)

Client Event:

Event Name

C7FW:PLAYER_LOADED

Arguments

Name	Type	Description
character	table	Character data table

Example

AddEventHandler("C7FW:PLAYER_LOADED", function(character)
    print("Character loaded:", character.char_first_name, character.char_last_name)

    -- Enable HUD
    -- Hide loading UI
    -- Start client systems
end)

2

C7FW:PLAYER_UNLOADED

What this event can be used for:

Triggered whenever a character is unloaded, including:

• Player disconnect

• Character switch

• Character deletion

• Resource restart

• Forced cleanup

This ensures all external systems can safely shut down.

Server Event:

Event Name

C7FW:PLAYER_UNLOADED

Arguments

Name	Type	Description
src	number	Player server ID
character	table	Character data table

Example

AddEventHandler("C7FW:PLAYER_UNLOADED", function(src, character)
    print(("[C7FW] Player %s unloaded %s %s"):format(
        src,
        character.char_first_name,
        character.char_last_name
    ))

    -- Stop duty timers
    -- Save custom data
    -- Cleanup inventory
end)

Client Event:

AddEventHandler("C7FW:PLAYER_UNLOADED", function(character)
    print("Character unloaded:", character.char_first_name, character.char_last_name)

    -- Clear HUD
    -- Reset UI
    -- Stop client systems
end)

Character Read Database Events

These events fire when characters are created, modified, or removed. They are intended for logging, syncing external systems, or backend integrations.

All events below are server-side only.

1

C7FW:CharacterCreated

This fires when a character has been successfully created.

What this event can be used for:

Server Event:

Event

c7fw:CharacterCreated

Arguments

Name	Type	Description
src	number	Player server ID
payload	table	Event payload

Example

AddEventHandler("c7fw:CharacterCreated", function(src, payload)
    local char = payload.character
    print("Character created:", char.char_id)
end)

2

C7FW:CharacterModified

Fires whenever a character is updated.

What this event can be used for:

Server Event:

Event

c7fw:CharacterModified

Example

AddEventHandler("c7fw:CharacterModified", function(src, payload)
    local char = payload.character
    local old = payload.old

    print("Character updated:", char.char_id)

    if old and old.char_callsign ~= char.char_callsign then
        print("Callsign changed:", old.char_callsign, "→", char.char_callsign)
    end
end)

3

C7FW:CharacterRemoved

What this event can be used for:

Server Event:

Event

c7fw:CharacterRemoved

Example

AddEventHandler("c7fw:CharacterRemoved", function(src, payload)
    print("Character removed:", payload.character.char_id)
end)

4

Payload Structure

All database events use the same payload format:

payload = {
    source = 22,
    timestamp = 1700000000,

    identifiers = {
        license = "license:xxxx",
        discord = "discord:xxxx",
        steam = "steam:xxxx",
        fivem = "fivem:xxxx"
    },

    character = {
        char_id = "JA-678512",
        char_first_name = "John",
        char_last_name = "Smith",
        char_department = "LSPD",
        char_callsign = "1A-12",
        char_gender = "Male",
        char_ethnicity = "White",
        char_dob = "1995-07-21",
        char_height = "6'0",
        char_weight = "185 lbs",
        char_created = "2026-02-10 18:42:11"
    }
}

payload.old is only present on CharacterModified.

Character Force Database Events

These events allow administrators or backend systems to force create, edit, or remove characters directly in the database.

They bypass normal UI flows and are intended for:

• admin panels

• staff tools

• migrations

• external integrations

All events below are server-side only.

1

C7FW:ForceCreateCharacter

This forces a new character to be created in the database.

What this event can be used for:

• Admin character creation tools

• Discord bot integrations

• CAD sync

• Data imports

• Staff recovery tools

Server Event:

Event

C7FW:ForceCreateCharacter

Arguments

Name	Type	Description
target	number | string	Player server ID OR license
data	table	Character data
cb	function	Callback (success, result)

Data Table Fields

All fields are optional unless stated.

Field	Description
first / char_first_name	First name
last / char_last_name	Last name
dob / char_dob	Date of birth
gender / char_gender	Gender
ethnicity / char_ethnicity	Ethnicity
department / char_department	Department
callsign / char_callsign	Callsign
image_url / char_image_url	Image URL
height / char_height	Height
weight / char_weight	Weight
license / char_steamid	License override
discord / char_discord	Discord ID override
char_id	Optional custom character ID

Callback Returns

Value	Description
success	boolean
result	charID or error string

Example

TriggerEvent("C7FW:ForceCreateCharacter", src, {
    first = "John",
    last = "Smith",
    department = "LSPD",
    callsign = "1A-12"
}, function(success, result)
    if success then
        print("Character created:", result)
    else
        print("Create failed:", result)
    end
end)

2

C7FW:ForceEditCharacter

This updates an existing character in the database.

If the character is currently loaded, it will be unloaded and refreshed.

What this event can be used for:

• Admin editing tools

• CAD sync updates

• Department changes

• Callsign updates

• Staff correction tools

Server Event:

Event

C7FW:ForceEditCharacter

Arguments

Name	Type	Description
charID	string	Character ID
data	table	Updated fields
cb	function	Callback

Callback Returns

Value	Description
success	boolean
result	affected rows or error

Example

TriggerEvent("C7FW:ForceEditCharacter", "HM-901296", {
    callsign = "2L-10",
    department = "SVPD"
}, function(success, result)
    print(success, result)
end)

3

C7FW:ForceRemoveCharacter

This permanently deletes a character from the database.

If the character is active, it will be unloaded first.

What this event can be used for:

• Admin removal tools

• Wipes

• Character recovery fixes

• Sync with external systems

Server Event:

Event

C7FW:ForceRemoveCharacter

Arguments

Name	Type	Description
charID	string	Character ID
cb	function	Callback

Callback Returns

Value	Description
success	boolean
result	affected rows or error

Example

TriggerEvent("C7FW:ForceRemoveCharacter", "HM-901296", function(success, result)
    if success then
        print("Character removed")
    else
        print("Remove failed:", result)
    end
end)

Event Flow Overview

On Join

ClientReady
↓
Character UI opens
↓
Player selects character
↓
C7FW:PLAYER_LOADED fires (server + client)

---

On Switch / Disconnect

C7FW:PLAYER_UNLOADED fires (server + client)
↓
Character removed from memory
↓
Cleanup complete

---

On Database Changes

Character created → c7fw:CharacterCreated
Character updated → c7fw:CharacterModified
Character deleted → c7fw:CharacterRemoved

---

Best Practices

• Use PLAYER_LOADED for gameplay systems

• Use CharacterCreated for logging/backends

• Never assume client order of execution

• Events are case-sensitive

• All character tables are safe copies