C7FW Identification System

This guide explains how to correctly install and configure C7FW Identification on your FiveM server. Follow each step carefully to ensure the script loads and functions as intended.

01. Installing the Resource

1

Download the latest release of C7 Identification;

This folder should contain the folder: c7-scripts-identification

2

Extract the .zip file's

3

Place the folder into your server's resource directory

Your resources folder should look like the following:

resources/
└── [c7-scripts]
    └── c7-scripts-framework-v3
    └── c7-scripts-identification

• 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-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-identification/shared/config.lua

1

Configuring the Basics

To change the basics of this script, you need to change the following configuration lines:

-- If true, when blips are enabled, you will see your own blip on the map/minimap.
Config.FrameworkResource = "c7-scripts-framework-v3" -- Framework required.

Config.UseC7_FrameworkPhoto = true -- Use the Character Image from C7 Framework?
Config.PhotoFallback = "assets/placeholder.svg" -- If an image can't be found, default to this.

Config.Notifications = "C7-Notifications" -- Do not change, dependency.
Config.NotificationDurationMs = 5000 -- How long should notifications stay for.

Config.CommandName = "id" -- Command to view your own ID card.
Config.CommandDescription = "Show your identification card" -- Command description.
Config.TypesCommandName = "idtypes" -- Command to view what ID's are available.
Config.ShowIdRadius = 2.0 -- How close does the player have to be to receieve your card?

Config.Position = "top-right" -- top-right, top-left, bottom-right, bottom-left
Config.ShowDurationMs = 0 -- 0 = stays open until closed
Config.CloseKeyLabel = "G" -- label shown in the UI
Config.CloseControl = 47 -- INPUT_DETONATE (G)
Config.CloseDebounceMs = 250 -- prevents instant close from stale key releases

2

Configuring the ID Cards

You must change the following lines:

Config.DefaultCitizenship = "San Andreas" -- What should the player's default citizenship be?
Config.CharacterIDName = "SSN"  -- What should be said under the ID name? Default: SSN
Config.ShowDepartment = false -- Should the player's department be shown on the ID?
Config.DepartmentLabel = "Occupation" -- What should it say for the player's department?
Config.State = "San Andreas" -- What should the state say?

Config.ShowFooter = true -- Should the footer be shown?
Config.FooterText = "www.sadmv.com" -- What should be on the left side of the footer?
Config.FooterRightText = "Valid Identification Card" -- What should be on the right side of the footer?

-- Card definitions
-- Usage: /id [type] (or) /showid [type]
-- Where [type] matches either the key (e.g. drivers_license) OR the `name` field (e.g. Drivers)
-- If [type] is omitted, the card with `default = true` is used.
-- If none are marked default, the first enabled card is used.

Config.IdentificationCards = {
  drivers_license = {
    enabled = true, -- Should this card be enabled?
    default = true, -- Should this card be the default? (i.e. typing /id (or) /showid without a type will bring this card up.)
    item = "driver_license", -- If 'UseC7_Inventory = true', what is the item name?
    ox_target = true, -- Do you want to enable this card with ox_target? (Third eye -> Identification -> [CARD])
    name = "Drivers", -- What is the license type?
    title = "Department of Motor Vehicles", -- What is the title of this card?
    sub_title = "Driver's License", -- What should be below the title?
    header_color = "#31425C", -- In HEX, what colour should the header be?
    background_type = "Image", -- Choose between: 'Image' or 'Color'
    background_color = "#BDD2E5", -- In HEX, what colour should the background be?
    background_image = "assets/holo.jpg", -- What should the background image be? This will overwrite any footer colours.
    footer_color = "#BDD2E5", -- In HEX, what colour should the footer be?
    seal_image = "assets/dmv.png", -- Seal/logo shown on this card
    default_expiry = "November 20th, 2026", -- When does this card expire?
  },

  weapons_license = {
    enabled = true,
    default = false,
    item = "weapons_license",
    ox_target = true,
    name = "Weapons",
    title = "Department of Weapons",
    sub_title = "Weapon's License",
    header_color = "#2b2f3a",
    background_type = "Color", -- Choose between: 'Image' or 'Color'
    background_color = "#d9e0e8",
    background_image = "assets/dmv.png", -- What should the background image be? This will overwrite any footer colours.
    footer_color = "#d9e0e8",
    seal_image = "assets/seal.png", -- Seal/logo shown on this card
    default_expiry = "November 20th, 2026",
  },

  -- Create more of your own, like this:

  -- hunting_license = {
  --   enabled = true,
  --   default = false,
  --   item = "hunting_license",
  --   ox_target = true,
  --   name = "Hunting",
  --   title = "Department of Wildlife",
  --   sub_title = "Hunting License",
  --   header_color = "#2b2f3a",
  --   background_color = "#d9e0e8",
  --   footer_color = "#d9e0e8",
  --   default_expiry = "November 20th, 2026",
  -- },
}

3

Configuring the Law Enforcement Badges

You must change the following lines:

--============================================================
-- Law Enforcement Badges
--============================================================
-- Departments that are allowed to use the badge system.
Config.LawEnforcementDepartments = {
  "LSPD",
  "BCSO",
  "SAHP"
}

-- Badge definitions
-- Usage:
--   /setgrade [input]
--   /badge
--   /showbadge (or) /showbadge [type]
--
-- [type] matches either the key (e.g. lspd) OR the `title` field (e.g. LSPD)
-- If [type] is omitted, the badge is resolved by your character department.
Config.LawEnforcementBadges = {

  lspd = {
    enabled = true,
    department = "LSPD",
    item = "lspd_badge",
    ox_target = true,
    name = "STATE OF SAN ANDREAS",
    title = "LSPD",
    badgeBackgroundColor = "#142c5c",
    badgeImage = "assets/lspdbadge.png", -- Replaces the logo next to the title
    showQR = true,
    showVerificationBadge = true,
    verificationBadgeImage = "assets/verified.png",
    showSeal = true,
    seal_image = "assets/seal.png",
  },

}

04. In-Game Commands

• /id [type](optional) (Show yourself your own ID)

  • i.e. /id (or) /id Drivers

• /idtypes (A list of ID types)

• /showid [type] (Show an ID to someone nearby)

  • i.e. /showid (or) /showid Weapons

• Or you can use ox_target.