Developer Framework Exports

C7 Framework V3 provides a set of server-side exports that allow developers to access character information from any resource.

These exports are safe, reliable, and do not require direct interaction with internal framework structures.

Available Exports

Below is the full list of exports provided by the framework.

1. GetActiveCharacter

Returns the full character table for the player.

local char = exports["c7-scripts-framework-v3"]:GetActiveCharacter(src)

This will return a table with the following data:

{
    char_id = "AB-123456",
    char_first_name = "John",
    char_last_name = "Smith",
    char_department = "Police",
    char_callsign = "123",
    char_gender = "Male",
    char_dob = "1990-01-01"
}

Returns nil if the player has no active character.

2. GetCharID

Returns the character’s unique ID (e.g., "AB-123456").

local char_id = exports["c7-scripts-framework-v3"]:GetCharID(src)

This will return a string or nil if unavailable

3. GetCharFullName

Returns the character’s full name as "First Last".

local fullname = exports["c7-scripts-framework-v3"]:GetCharFullName(src)

This will return a string with formatted full name or nil if unavailable

4. GetCharFirstName

Returns only the character’s first name..

local first = exports["c7-scripts-framework-v3"]:GetCharFirstName(src)

This will return a string with first name or nil if unavailable

5. GetCharLastName

Returns only the character’s first name..

local last = exports["c7-scripts-framework-v3"]:GetCharLastName(src)

This will return a string with last name or nil if unavailable

5. GetCharDept

Returns the department the character is assigned to.

local dept = exports["c7-scripts-framework-v3"]:GetCharDept(src)

This will return a string with department name or nil if unavailable

6. GetCharCopy

Returns a safe, read-only copy of the character table. Use this when you need character info without risking accidental modification of framework data.

local data = exports["c7-scripts-framework-v3"]:GetCharCopy(src)

This will return a table containing:

{
    char_id        = "AB-123456",
    char_first_name = "John",
    char_last_name  = "Smith",
    char_department = "Police",
    char_callsign   = "123",
    char_gender     = "Male",
    char_dob        = "1990-01-01"
}

Usage Examples:

Displaying Character Name in a Custom Script

RegisterCommand("myname", function(source)
    local name = exports["c7-scripts-framework-v3"]:GetCharFullName(source)
    print("Your character name is:", name)
end)

Checking Department for Permissions

RegisterCommand("myname", function(source)
local dept = exports["c7-scripts-framework-v3"]:GetCharDept(src)

if dept == "Los Santos Police Department" then
    -- Allow access
end

Retrieving Character Data Safely

local data = exports["c7-scripts-framework-v3"]:GetCharCopy(src)

if data then
    print(data.char_id, data.char_department)
end