Framework Exports

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

Available Server-Side Exports

1

GetActiveCharacter

What this export does:

Returns the entire active character table stored in ActiveCharacters[src] (or nil if none).

How to use this export:

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

Output example

Output type: table or nil

Output example:

{
  char_id = 12,
  char_first_name = "John",
  char_last_name = "Smith",
  char_department = "lspd",
  char_callsign = "1A-12",
  char_gender = "Male",
  char_ethnicity = "White",
  char_height = "6'0",
  char_weight = "82kg",
  char_grade = "Sergeant",
  char_created_at = "2025-11-03 18:04:12",
  char_dob = "2001-02-10",
  char_currently_jailed = 0,
  char_jail_expiration = nil,
  char_last_location = "Mission Row PD",
  char_last_location_coords = '{"x":441.2,"y":-981.9,"z":30.7,"w":90.0}',
  char_last_played = "2026-02-16 23:58:01",
  char_discord = "123456789012345678",
  char_steamid = "steam:11000010abcdef12",
  char_image_url = "https://example.com/image.png"
}

Example usage:

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

if not char then
    print("No active character loaded for src:", src)
    return
end

print("Active char table exists. Char ID:", char.char_id)

2

GetCharID

What this export does:

Returns ActiveCharacters[src].char_id or nil.

How to use this export:

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

Output example:

Output type: number/string or nil

Output example: 12

Example usage:

local src = source
local charId = exports["c7-scripts-framework-v3"]:GetCharID(src)
print("Char ID:", charId)

3

GetCharFullName

What this export does:

Returns "first last" using c.char_first_name + c.char_last_name. If no active character → nil.

How to use this export:

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

Output example:

Output type: string or nil

Output example: John Smith

Example usage:

local src = source
local name = exports["c7-scripts-framework-v3"]:GetCharFullName(src)
print("Full name:", name or "Unknown")

4

GetCharFirstName

What this export does:

Returns c.char_first_name or nil.

How to use this export:

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

Output example:

Output type: string or nil

Output example: John

Example usage:

local src = source
print("First name:", exports["c7-scripts-framework-v3"]:GetCharFirstName(src))

5

GetCharLastName

What this export does:

Returns c.char_last_name or nil.

How to use this export:

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

Output example:

Output type: string or nil

Output example: Smith

Example usage:

local src = source
print("Last name:", exports["c7-scripts-framework-v3"]:GetCharLastName(src))

6

GetCharDept

What this export does:

Returns c.char_department or nil.

How to use this export:

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

Output example:

Output type: string or nil

Output example: lspd

Example usage:

local src = source
local dept = exports["c7-scripts-framework-v3"]:GetCharDept(src)
print("Department:", dept or "None")

7

GetCharGender

What this export does:

Returns c.char_gender or nil.

How to use this export:

local gender = exports["c7-scripts-framework-v3"]:GetCharGender(src)

Output example:

Output type: string or nil

Output example: Male

Example usage:

local src = source
print("Gender:", exports["c7-scripts-framework-v3"]:GetCharGender(src) or "Unknown")

8

GetCharWeight

What this export does:

Returns c.char_weight or nil.

How to use this export:

local weight = exports["c7-scripts-framework-v3"]:GetCharWeight(src)

Output example:

Output type: string or nil

Output example: 82lbs

Example usage:

local src = source
print("Weight:", exports["c7-scripts-framework-v3"]:GetCharWeight(src) or "Unknown")

9

GetCharHeight

What this export does:

Returns c.char_height or nil.

How to use this export:

local height = exports["c7-scripts-framework-v3"]:GetCharHeight(src)

Output example:

Output type: string or nil

Output example: 6'11"

Example usage:

local src = source
print("Height:", exports["c7-scripts-framework-v3"]:GetCharHeight(src) or "Unknown")

10

GetCharImage

What this export does:

Returns the character image URL only if it’s valid:

• must not be nil/""

• must not be "null" or "nil" (string)

• Otherwise returns nil.

How to use this export:

local img = exports["c7-scripts-framework-v3"]:GetCharImage(src)

Output example:

Output type: string or nil

Output example: "https://example.com/image.png"

Example usage:

local src = source
local img = exports["c7-scripts-framework-v3"]:GetCharImage(src)

if img then
    print("Character image:", img)
else
    print("No valid character image set.")
end

11

GetCharEthnicity

What this export does:

Returns c.char_ethnicity or nil.

How to use this export:

local eth = exports["c7-scripts-framework-v3"]:GetCharEthnicity(src)

Output example:

Output type: string or nil

Output example: White

Example usage:

local src = source
print("Ethnicity:", exports["c7-scripts-framework-v3"]:GetCharEthnicity(src) or "Unknown")

12

GetCharCallsign

What this export does:

Returns c.char_callsign or nil.

How to use this export:

local callsign = exports["c7-scripts-framework-v3"]:GetCharCallsign(src)

Output example:

Output type: string or nil

Output example: 1A-12

Example usage:

local src = source
print("Callsign:", exports["c7-scripts-framework-v3"]:GetCharCallsign(src) or "None")

13

GetCharGrade

What this export does:

Returns c.char_grade or nil.

How to use this export:

local grade = exports["c7-scripts-framework-v3"]:GetCharGrade(src)

Output example:

Output type: string or nil

Output example: Sergeant

Example usage:

local src = source
local grade = exports["c7-scripts-framework-v3"]:GetCharGrade(src)

if grade then
    print("Grade:", grade)
else
    print("No grade set.")
end

14

GetCharJailedStatus

What this export does:

Returns true/false if the player is jailed.

How to use this export:

local jailed = exports["c7-scripts-framework-v3"]:GetCharJailedStatus(src)

Output example:

Output type: boolean or nil

Output example: true or false

Example usage:

local src = source
local jailed = exports["c7-scripts-framework-v3"]:GetCharJailedStatus(src)

if jailed then
    print("Player is jailed, no leaving the cell mate.")
else
    print("Player is free. For now.")
end

15

GetCharJailedExpiry

What this export does:

Returns c.char_jail_expiration or nil.

How to use this export:

local expiry = exports["c7-scripts-framework-v3"]:GetCharJailedExpiry(src)

Output example:

Output type: string/number or nil

Output example: 2026-02-17 21:30:00

Example usage:

local src = source
local expiry = exports["c7-scripts-framework-v3"]:GetCharJailedExpiry(src)
print("Jail expiry:", expiry or "No expiry / not jailed")

16

GetCharCreatedAt

What this export does:

Returns c.char_created_at, or if that’s nil, returns c.created_at, otherwise nil.

How to use this export:

local createdAt = exports["c7-scripts-framework-v3"]:GetCharCreatedAt(src)

Output example:

Output type: string/number or nil

Output example: 2025-11-03 18:04:12

Example usage:

local src = source
local createdAt = exports["c7-scripts-framework-v3"]:GetCharCreatedAt(src)
print("Character created at:", createdAt)

17

GetCharLastLocation

What this export does:

Returns c.char_last_location or nil.

How to use this export:

local lastLoc = exports["c7-scripts-framework-v3"]:GetCharLastLocation(src)

Output example:

Output type: string/number or nil

Output example: Vinewood Boulevard (Postal 232)

Example usage:

local src = source
local lastLoc = exports["c7-scripts-framework-v3"]:GetCharLastLocation(src)
print("Last location:", lastLoc or "Unknown")

18

GetCharLastLocationCoords

What this export does:

Returns c.char_last_location_coords or nil.

How to use this export:

local coords = exports["c7-scripts-framework-v3"]:GetCharLastLocationCoords(src)

Output example:

Output type: string/number or nil

Output example: {"x":441.2,"y":-981.9,"z":30.7,"w":90.0}

Example usage:

local src = source
local coords = exports["c7-scripts-framework-v3"]:GetCharLastLocationCoords(src)

if coords then
    print("Last coords raw:", coords)
else
    print("No last coords saved.")
end

19

GetCharLastPlayed

What this export does:

Returns c.char_last_played or nil.

How to use this export:

local lastPlayed = exports["c7-scripts-framework-v3"]:GetCharLastPlayed(src)

Output example:

Output type: string/number or nil

Output example: 2026-02-16 23:58:01

Example usage:

local src = source
local lastPlayed = exports["c7-scripts-framework-v3"]:GetCharLastPlayed(src)
print("Last played:", lastPlayed or "Never")

20

GetCharDiscordID

What this export does:

Returns c.char_discord or nil.

How to use this export:

local discordId = exports["c7-scripts-framework-v3"]:GetCharDiscordID(src)

Output example:

Output type: number or nil

Output example: 123456789012345678

Example usage:

local src = source
local discordId = exports["c7-scripts-framework-v3"]:GetCharDiscordID(src)
print("Discord ID:", discordId or "Not linked")

21

GetCharSteamID

What this export does:

Returns c.char_steamid or nil.

How to use this export:

local steamId = exports["c7-scripts-framework-v3"]:GetCharSteamID(src)

Output example:

Output type: string/number or nil

Output example: steam:11000010abcdef12

Example usage:

local src = source
local steamId = exports["c7-scripts-framework-v3"]:GetCharSteamID(src)
print("Steam ID:", steamId or "No steam identifier")

22

GetCharCopy

What this export does:

Returns a new table copy of character fields (so other scripts can safely read it without mutating your ActiveCharacters table).

If no active character → nil.

How to use this export:

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

Output example:

Output type: table or nil

Output example: steam:11000010abcdef12

Example usage:

{
    char_id = 12,
    char_first_name = "John",
    char_last_name = "Smith",
    char_department = "lspd",
    char_callsign = "1A-12",
    char_gender = "Male",
    char_ethnicity = "White",
    char_height = "6'0",
    char_weight = "82kg",
    char_created_at = "2025-11-03 18:04:12",
    char_dob = "2001-02-10",
    char_grade = "Sergeant",
    char_image_url = "https://example.com/image.png",
    char_currently_jailed = 0,
    char_jail_expiration = nil,
    char_last_location = "Mission Row Police Department",
    char_last_location_coords = '{"x":441.2,"y":-981.9,"z":30.7,"w":90.0}',
    char_last_played = "2026-02-16 23:58:01",
    char_discord = "123456789012345678",
    char_steamid = "steam:11000010abcdef12"
}