Setup and Installation Guide

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.

1. Requirements

Before installing this script, ensure your server meets the following:

• Latest recommended FiveM artifacts

• C7-Notifications installed (for popup support) - you can download this for free on our tebex shop.

2. Download the resource from your CFX.re Portal

1

Download the latest release of the C7 VMS2

This folder should contain:

• c7-scripts-vms2

2

Download the latest release of C7 Notifications

You can download this for free on our tebex shop.

3

Extract the .zip file's

4

Place the folders into your server's resource directory

Your resources folder should look like the following:

resources/
└── [c7-scripts]
    └── c7-scripts-framework-v3 (if installed)
    └── c7-scripts-vms2
    └── c7-scripts-notifications (required/dependency)

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

3. Add 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-vms2 (start third)

4. Configuring VMS2

c7-scripts-vms2 (config.lua):

Open c7-scripts-vms2/config/config.lua and adjust the settings:

Core Settings

• Framework configuration (Standalone/C7FW)

• Dicord Integrations

• Department Configuration

• Vehicle Configuration

• Language Configuration

• Discord Webhook URLs

C7 Framework V3 Integration

You must have the following configuration options for C7 Framework V3 to operate with this script:

config.frameworkType = "C7FW" -- Must be set to C7FW
config.useDiscordPermissions = false -- Must be 'false'

config.departments = {
    C7FW = { 
        departments = { "LSPD", "BCSO", "SAHP" },   -- Your C7 Framework Departments
    },
}

config.cars = {....    
    permittedDepartments = { 'SAHP', 'LSPD' }, -- C7 Framework Permissions Example (comment out if using Discord)

Standalone with Discord Integration

You must have the following configuration options for C7 VMS2 to operate with Discord:

config.frameworkType = "Standalone" -- Must be set to Standalone
config.useDiscordPermissions = true -- Must be 'false'
config.discordServerID = "SERVER_ID"  -- The Server ID to your Discord Server
config.discordBotToken = "BOT_TOKEN" -- Replace with your Discord Bot Token

config.departments = {
    discord = { 
        lspd_access = "ROLE_ID",    -- This will give this role the "lspd_access" department.
        bcso_access = "ROLE_ID",    -- This will give this role the "bcso_access" department.
        sahp_access = "ROLE_ID"     -- This will give this role the "sahp_access" department.
    },
}

config.cars = {....    
    permittedDepartments = { 'lspd_access ', 'bcso_access ' }, -- Discord Permissions Example (uncomment if using Discord)

5. Starting VMS2

Restart your server or run:

refresh
ensure c7-scripts-notifications (start first)
ensure c7-scripts-framework-v3 (start second)
ensure c7-scripts-vms2 (start third)

6. In-Game Commands

• /vms2 - Opens the menu.

7. Verify the Installation

To confirm the framework is working:

1. Connect to the server

2. Type /vms2 in the chat.

3. Check departments appear as you configured.

4. Check sub-sections appear as you configured.

5. Check vehicles appear as you configured.

6. Check vehicles spawn properly.

7. Check vehicles are tracked properly.

9. Common Issues

Webhooks are not sending

• Check webhook URLs

• Ensure they are valid Discord webhook endpoints

• Confirm the server can reach external URLs