Framework Configuration

This guide explains how to correctly install and configure C7 Framework V3 on your FiveM server. Follow each step carefully to ensure the framework loads and functions as intended.

01. Installing the Resource

1

Download the latest release of the C7 Framework V3;

This folder should contain the folder: c7-scripts-framework-v3

2

Download the latest release of C7 Notifications;

You can download this for free on our shop. Click here for the link to this resource.

3

Download the latest release of other modules;

If you would like to install the following (optional & free) modules:

C7 Chat,
C7 Jail,
C7 Scoreboard,
C7 Blips,
C7 Identification.

You can download them from your portal separately.

4

Extract the .zip file's

5

Place the folders into your server's resource directory

Your resources folder should look like the following:

resources/
└── [c7-scripts]
    └── c7-scripts-framework-v3
    └── c7-scripts-chat (optional module)
    └── c7-scripts-jail (optional module)
    └── c7-scripts-blips (optional module)
    └── c7-scripts-scoreboard (optional module)
    └── c7-scripts-doorlock (optional module)
    └── c7-scripts-identification (optional module)
    └── c7-scripts-notifications (required/dependency)

You should not change the name of the folders as this will prompt errors.
You should keep it as what it comes as.

02. Adding to 'server.cfg'

Add the following line to your server.cfg, preferably after your MySQL and connection resources:

ensure oxmysql
ensure c7-scripts-notifications (start first)
ensure c7-scripts-framework-v3 (start second)
ensure c7-scripts-chat
ensure c7-scripts-blips
ensure c7-scripts-jail
ensure c7-scripts-scoreboard 
ensure c7-scripts-doorlock
ensure c7-scripts-identification

03. Script Configuration

Altering the script to your preferred configuration has been made easy with our configuration file. To get started, you need to open the file: c7-scripts-framework-v3/config/config.lua

1

Configuring the Aesthetics

To change the aesthetics of the framework, you need to change the following configuration lines:

2

Configuring the Maximum Characters

You must change the following lines:

3

Configuring Nearest Postals

You must change the following lines:

4

Configuring Ethnicity & Genders

You must change the following lines:

5

Configuring Discord Access

You must change the following lines:

6

Configuring Departments

You must change the following lines:

7

Configuring Discord Webhooks

You must change the following lines:

8

Configuring Optional Modules

To configure the optional modules provided with this script, you can select which module from the list below on how to configure it:

C7 Chat,
C7 Jail,
C7 Scoreboard,
C7 Blips,
C7 Identification.

04. In-Game Commands

/framework - This will open the character UI manually.
- Aliases: /fw and /char
/sethome - This will set the player's home to their current location.

PreviousC7FW + ImperialCAD Installation NextOptional Free Modules

Last updated 28 days ago

Config.frameworkHeader = "C7 FRAMEWORK"
Config.frameworkSubHeader = "A standalone framework system!"
Config.Background = "https://cdn.c7hghs.co.uk/u/jqqKcu.png" -- Can be an https link or a local /html/ path (e.g. "/html/images/bg.png")

Config.Ethnicity = {
    "White",
    "Black",
    "Asian",
    "Hispanic",
    "Mixed",
    "Other"
}

Config.Genders = {
    "Male",
    "Female",
    "Non-Binary",
    "Other"
}

Config.discordBotToken = "BOT_TOKEN" -- Replace with your Bot Token

Config.enableDiscordRPC = true -- Enable/Disable Discord Presence
Config.discordAppId = 00000000000000000 -- Replace with your Bot's Client ID
Config.discordLargeAsset = "server_logo"
Config.discordLargeAssetText = "www.c7scripts.co.uk" -- Replace with whatever you want.
Config.discordSmallAsset = "badge"
Config.discordSmallAssetText = "C7 Framework V3" -- Replace with whatever you want.

-- =========================================================
-- Departments Configuration
-- =========================================================

Config.useDiscordPermissions = false -- if false, all departments are available to anyone.
Config.discordServerID = "YOUR_DISCORD_SERVER_ID"

Config.enableGrades = true -- If false, the grades system will not be active.

Config.Departments = {
    ["civilian"] = {
        mainPermissions = {
            everyoneCanUse = true,
            allowedDiscordRoles = {
                "1439128964298965052",
            }
        },
        departmentTitle = "Civilian",
        spawnLocations = {
        { x = 205.82, y = -933.63, z = 30.69, h = 140.0, title = "Legion Square" },
        { x = 299.12, y = -586.47, z = 43.29, h = 70.0,  title = "Pillbox Hill" },
        { x = -35.12, y = -1102.72, z = 26.42, h = 170.0, title = "Alta Street Apartments" },
        { x = -1224.61, y = -1484.79, z = 4.36, h = 125.0, title = "Del Perro Pier" },
        { x = -1034.74, y = -2738.10, z = 20.17, h = 330.0, title = "LSIA Airport" },
        { x = 1864.74, y = 3678.17, z = 33.68, h = 210.0, title = "Sandy Shores" },
        { x = 1704.22, y = 4823.23, z = 41.06, h = 90.0,  title = "Grapeseed" },
        { x = -447.16, y = 6029.46, z = 31.49, h = 45.0,  title = "Paleto Bay" },
        { x = 740.33, y = 233.12, z = 92.51, h = 200.0, title = "Rockford Hills" },
        { x = -555.29, y = -180.41, z = 38.22, h = 90.0,  title = "Weazel News" }
        },
        departmentGrades = {
            { grade = "Civilian Director", allowedDiscordRoles = "" },
            { grade = "Civilian I", allowedDiscordRoles = "" },
            -- { grade = "Add your own by creating new lines", allowedDiscordRoles = "" },
        }
    },
    ["lspd"] = {
        mainPermissions = {
            everyoneCanUse = false,
            allowedDiscordRoles = {
                "1439128984066592828",
            }
        },
        departmentTitle = "LSPD",
        spawnLocations = {
        { x = 428.09,  y = -981.31, z = 30.71, h = 90.0,  title = "Mission Row PD" },
        { x = 642.16,  y = 1.12,     z = 82.79, h = 90.0,  title = "Vespucci PD" },
        { x = -1118.21, y = -844.25, z = 19.01, h = 138.0, title = "Rockford Hills PD" },
        { x = -449.12, y = 6007.23, z = 31.72, h = 45.0,  title = "Paleto Sheriff's Office" },
        { x = 364.82, y = -1592.89, z = 29.29, h = 50.0,  title = "Davis Station" },
        { x = -1090.44, y = -809.14, z = 19.28, h = 45.0, title = "Del Perro Station" },
        },
        departmentGrades = {
            { grade = "Chief of Police", allowedDiscordRoles = "" },
            { grade = "Police Officer", allowedDiscordRoles = "" },
            -- { grade = "Add your own by creating new lines", allowedDiscordRoles = "" },
        }
    },
    ["bcso"] = {
        mainPermissions = {
            everyoneCanUse = false,
            allowedDiscordRoles = {
                "1439128984066592828",
            }
        },
        departmentTitle = "BCSO",
        spawnLocations = {
        { x = 428.09,  y = -981.31, z = 30.71, h = 90.0,  title = "Mission Row PD" },
        { x = 642.16,  y = 1.12,     z = 82.79, h = 90.0,  title = "Vespucci PD" },
        { x = -1118.21, y = -844.25, z = 19.01, h = 138.0, title = "Rockford Hills PD" },
        { x = -449.12, y = 6007.23, z = 31.72, h = 45.0,  title = "Paleto Sheriff's Office" },
        { x = 364.82, y = -1592.89, z = 29.29, h = 50.0,  title = "Davis Station" },
        { x = -1090.44, y = -809.14, z = 19.28, h = 45.0, title = "Del Perro Station" },
        },
        departmentGrades = {
            { grade = "Sheriff", allowedDiscordRoles = "" },
            { grade = "Deputy I", allowedDiscordRoles = "" },
            -- { grade = "Add your own by creating new lines", allowedDiscordRoles = "" },
        }
    },
    ["sahp"] = {
        mainPermissions = {
            everyoneCanUse = false,
            allowedDiscordRoles = {
                "1439128984066592828",
            }
        },
        departmentTitle = "SAHP",
        spawnLocations = {
        { x = 428.09,  y = -981.31, z = 30.71, h = 90.0,  title = "Mission Row PD" },
        { x = 642.16,  y = 1.12,     z = 82.79, h = 90.0,  title = "Vespucci PD" },
        { x = -1118.21, y = -844.25, z = 19.01, h = 138.0, title = "Rockford Hills PD" },
        { x = -449.12, y = 6007.23, z = 31.72, h = 45.0,  title = "Paleto Sheriff's Office" },
        { x = 364.82, y = -1592.89, z = 29.29, h = 50.0,  title = "Davis Station" },
        { x = -1090.44, y = -809.14, z = 19.28, h = 45.0, title = "Del Perro Station" },
        },
        departmentGrades = {
            { grade = "Colonel", allowedDiscordRoles = "" },
            { grade = "Trooper I", allowedDiscordRoles = "" },
            -- { grade = "Add your own by creating new lines", allowedDiscordRoles = "" },
        }
    },
    ["safr"] = {
        mainPermissions = {
            everyoneCanUse = false,
            allowedDiscordRoles = {
                "1439128984066592828",
            }
        },
        departmentTitle = "SAFR",
        spawnLocations = {
        { x = 428.09,  y = -981.31, z = 30.71, h = 90.0,  title = "Mission Row PD" },
        { x = 642.16,  y = 1.12,     z = 82.79, h = 90.0,  title = "Vespucci PD" },
        { x = -1118.21, y = -844.25, z = 19.01, h = 138.0, title = "Rockford Hills PD" },
        { x = -449.12, y = 6007.23, z = 31.72, h = 45.0,  title = "Paleto Sheriff's Office" },
        { x = 364.82, y = -1592.89, z = 29.29, h = 50.0,  title = "Davis Station" },
        { x = -1090.44, y = -809.14, z = 19.28, h = 45.0, title = "Del Perro Station" },
        },
        departmentGrades = {
            { grade = "EMS", allowedDiscordRoles = "" },
            { grade = "PARAMEDIC", allowedDiscordRoles = "", },
            -- { grade = "Add your own by creating new lines", allowedDiscordRoles = "" },
        }
    },
    ["saco"] = {
        mainPermissions = {
            everyoneCanUse = false,
            allowedDiscordRoles = {
                "1439128984066592828",
            }
        },
        departmentTitle = "SACO",
        spawnLocations = {
        { x = 428.09,  y = -981.31, z = 30.71, h = 90.0,  title = "Mission Row PD" },
        { x = 642.16,  y = 1.12,     z = 82.79, h = 90.0,  title = "Vespucci PD" },
        { x = -1118.21, y = -844.25, z = 19.01, h = 138.0, title = "Rockford Hills PD" },
        { x = -449.12, y = 6007.23, z = 31.72, h = 45.0,  title = "Paleto Sheriff's Office" },
        { x = 364.82, y = -1592.89, z = 29.29, h = 50.0,  title = "Davis Station" },
        { x = -1090.44, y = -809.14, z = 19.28, h = 45.0, title = "Del Perro Station" },
        },
        departmentGrades = {
            { grade = "Dispatch Director", allowedDiscordRoles = "" },
            { grade = "Dispatch I", allowedDiscordRoles = "" },
            -- { grade = "Add your own by creating new lines", allowedDiscordRoles = "" },
        }
    }
}