Developer 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.

C7FW:PLAYER_LOADED

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

This event fires on:

• Server-side

• Client-side

---

Server Event

Event Name:

C7FW:PLAYER_LOADED

Arguments:

Argument	Type	Description
src	number	The player’s server ID
character	table	Full character data table returned by the framework

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
    ))
    
    -- Example: give duty items, load UI, etc.
end)

---

Client Event

Event Name:

C7FW:PLAYER_LOADED

Arguments:

Argument	Type	Description
character	table	Full character data table

Example:

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

    -- Hide UI, enable HUD, show notifications, etc.
end)

C7FW:PLAYER_UNLOADED

Triggered when a player unloads a character, including:

• Disconnecting

• Deleting a character

• Switching characters

• Resource restart

• Forced cleanup

This ensures all external systems can safely clean up data.

This event fires on:

• Server-side

• Client-side

---

Server Event

Event Name:

C7FW:PLAYER_UNLOADED

Arguments:

Argument	Type	Description
src	number	Player server ID
character	table	The character that was unloaded

Example:

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

    -- Example: stop duty timers, save custom data, clean up inventories
end)

---

Client Event

Event Name:

C7FW:PLAYER_UNLOADED

Arguments:

Argument	Type	Description
character	table	Character being unloaded

Example:

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

    -- Clean HUD, disable UI, reset states, etc.
end)

---

Event Flow Overview

On Join → Character Loaded

ClientReady
↓
UI Opens (creation/selection)
↓
Player chooses character
↓
C7FW:PLAYER_LOADED fires on server + client

On Disconnect or Switching Characters

C7FW:PLAYER_UNLOADED fires on server + client
↓
Active character removed
↓
Cleanup completed