Setup and Installation Guide

This guide explains how to correctly install and configure C7 Simple Chat 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

• Chat: The default FiveM Chat Script

2. Download the resource from your CFX.re Portal

1

Download the latest release of the C7 Simple Chat

This folder should contain:

• c7-scripts-chat

2

Extract the .zip file's

3

Place the folders into your server's resource directory

Your resources folder should look like the following:

resources/
└── [c7-scripts]
    └── c7-scripts-chat

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 c7-scripts-chat

4. Configuring Simple Chat

c7-scripts-chat (config.lua):

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

Core Settings

• Framework configuration (Standalone/C7FW)

• Discord Integrations

• General Settings

• Nearest Postal Settings

• Chat Commands

• Discord Webhook URLs

C7 Framework V3 Integration

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

---------------------------------------------------------
-- FRAMEWORK CONFIGURATION
---------------------------------------------------------

Config.Framework = "C7FW" -- Choose between: "C7FW" or "Standalone"

Config.UseFrameworkID = false -- Show the Character ID in the message.              !! (C7FW Only) !!
Config.ShowDepartment = true -- Show the Character's Department in the message.     !! (C7FW Only) !!
Config.ShowCallsign  = true -- Show the Character's Callsign in the message.        !! (C7FW Only) !!

Standalone Integration

You must have the following configuration options for C7 Simple Chat to operate with Standalone:

---------------------------------------------------------
-- FRAMEWORK CONFIGURATION
---------------------------------------------------------

Config.Framework = "Standalone" -- Choose between: "C7FW" or "Standalone"

Config.UseFrameworkID = false -- Show the Character ID in the message.              !! (C7FW Only) !!
Config.ShowDepartment = true -- Show the Character's Department in the message.     !! (C7FW Only) !!
Config.ShowCallsign  = true -- Show the Character's Callsign in the message.        !! (C7FW Only) !!Config.MessageTypes = {...

5. Starting Simple Chat

Restart your server or run:

refresh
ensure c7-scripts-chat

6. In-Game Commands

• /me [message] (Proximity) - sends a me message.

• /mer [message] (Proximity + 3D) - sends a 3D /me.

• /gme [message] (Global) - sends a global me message.

• /do [message] (Proximity) - sends a do message.

• /ooc [message] (Proximity) - sends an out of character message.

• /gooc [message] (Global) - sends an out of character message.

• /cctv [message] (Global) - sends a CCTV message.

• /med [message] (Proximity + 3D) - sends a medical message.

• /darkweb [message] (Global) - sends a dark web message.

• /ad [message] (Global) - sends an advertisement message.

• /w (or) /whisper [message] - sends a whispered 3D message, does not appear in chat.

• /nd911 [message] (Global) - sends a 911 message for no dispatch.

• /nda911 [message] (Global) - sends an anonymous 911 message for no dispatch.

• /nd311 [message] (Global) - sends a 311 message for no dispatch.

• /nda311 [message] (Global) - sends an anonymous 311 message for no dispatch.

7. Verify the Installation

To confirm the framework is working:

1. Connect to the server

2. Type any command from the above list in the chat.

3. Check messages appear as you configured.

9. Common Issues

Webhooks are not sending

• Check webhook URLs

• Ensure they are valid Discord webhook endpoints

• Confirm the server can reach external URLs