Doorlocking Configuration

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

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

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

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-notificaitons
    └── c7-scripts-framework-v3 (if installed)
    └── c7-scripts-doorlock

• 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 c7-scripts-framework-v3 (if installed)
ensure c7-scripts-notifications (start first)
ensure c7-scripts-doorlock

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

1

Configuring the Basics

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

Config.Command = 'doorlock'
Config.SelectDistance = 6.0
Config.InteractDistance = 2.2
Config.AutoDetectDoubleDoorRadius = 2.5
Config.StatusDrawDistance = 12.0
Config.ShowDoorlockText = true -- Toggle 3D status text under the sprite ("Locked"/"Unlocked")

2

Configuring Discord Integration

You must change the following lines:

Config.enableDiscord = false -- If set to 'false', discord permissions will not be used.
Config.discordBotToken = "YOUR_BOT_TOKEN" -- Replace with your Bot Token
Config.discordAppId = "YOUR_APP_ID" -- Replace with your Bot's Client ID
Config.discordGuildId = "YOUR_GUILD_ID" -- Replace with your Guild/Server ID

3

Configuring Doorlock Admin Access

You must change the following lines:

Config.DoorlockAccess = {
  enabled = true, -- If false, anyone can access /doorlock and manage doors.

  licenses = {}, -- FiveM license identifiers, e.g. { "license:1234abcd..." }
  discordIds = {}, -- Discord user IDs (WITHOUT the "discord:" prefix), e.g. { "123456789012345678" }
  acePerms = {}, -- Ace permissions, e.g. { "c7.doorlock" }

  -- C7 Framework V3 checks (only applies if the framework resource is started)
  c7fw = {
    departments = {}, -- Departments to allow, e.g. { "LSPD", "BCSO" }
    characterIds = {}, -- Character IDs to allow, e.g. { "RX-153471" }

  }
}

4

Configuring Discord Webhoks

You must change the following lines:

Config.Webhooks = {
  doorCreated  = "YOUR_WEBHOOK",
  doorEdited   = "YOUR_WEBHOOK",
  doorDeleted  = "YOUR_WEBHOOK",
}

5

Configuring Doorlock Defaults

You must change the following lines:

Config.Defaults = {
  locked = true,
  secret = false,
  keepOpen = false,
  autoLock = false,
  autoLockSeconds = 10,
  lockSound = 'door_bolt',
  unlockSound = 'door_unlock',
  distance = 2.0,
}

6

Configuring Doorlock Sounds

You must change the following lines:

Config.SoundSettings = {
  enabled = true,
  door_sound_volume = 0.35,
  keypad_sound_volume = 0.35,

  -- Door Sounds
  --
  -- type = 'lock' -> This will only appear in the "Lock Sound" dropdown.
  -- type = 'unlock' -> This will only appear in the "Unlock Sound" dropdown.
  -- file = 'name' -> The file name that appears in /nui/sounds/[name].ogg (You do not need to inclde the .ogg)

  doorSounds = {
    lock1   = { type = 'lock',   file = 'lock1',   name = 'Lock Sound #1' },
    unlock1 = { type = 'unlock', file = 'unlock1', name = 'Unlock Sound #1' },
  },

  -- Keypad Sounds
  keypadSounds = {
    keypad_click   = { type = 'keypad', file = 'keypad_click' },    -- When you press a digit on the keypad (1, 2, 3, 4, 5, 6, 7, 8, 9, 0).
    keypad_enter   = { type = 'keypad', file = 'keypad' },          -- When you press the 'enter' key on the keypad.
    keypad_cancel  = { type = 'keypad', file = 'keypad' },          -- When you press the 'cancel' key on the keypad.
    keypad_delete  = { type = 'keypad', file = 'keypad_click' },    -- When you press the 'delete' key on the keypad.
    keypad_success = { type = 'keypad', file = 'keypad_success' },  -- When the code is correct and the door unlocks.
    keypad_error   = { type = 'keypad', file = 'keypad_error' },    -- When the code is incorrect.
  }
}

You can add your own custom sounds into /nui/sounds/

This must be a .ogg file

05. In-Game Commands & Keybinds

• /doorlock - This will open the Doorlock UI

• E will unlock and lock a door.