> For the complete documentation index, see [llms.txt](https://project-07.gitbook.io/project_07-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://project-07.gitbook.io/project_07-docs/scripts/project07-namechecker-v3/configuration.md).

# Configuration

Config Files

{% code title="Config.lua" overflow="wrap" lineNumbers="true" %}

```lua
Project07 = {}

-- new player behavior
Project07.NewPlayers = false -- dont change This

Project07.MinFirstLen = 2
Project07.MinLastLen  = 2
Project07.AllowHyphenAndApostrophe = true
Project07.AllowNumbersForName = false  -- New: Disallow numbers in names for stricter RP
Project07.MaxNameLength = 25   -- New: Limit total name length

-- Server image URL
Project07.ServerImgUrl = "https://r2.fivemanage.com/PWi17378BkBNKjYIfYp1R/project07new.png"

-- New: UI image URL for lock screen
Project07.UiImgUrl = "https://r2.fivemanage.com/PWi17378BkBNKjYIfYp1R/project07.png"

-- Server branding
Project07.Discordinvite = "https://discord.gg/lasthorizonlk"
Project07.RuleBook = ""
Project07.WebsiteLink = "http://lasthorizon2025.online/"

Project07.BypassIdentifiersForAdmins = {
    -- "license:1234567890abcdef",
    -- "discord:123456789012345678"
}

-- license column format
Project07.UseBothLicenseFormats = true -- Didnt False This Option

-- New: Enable Discord webhook logging for kicks
Project07.EnableLogging = true
Project07.WebhookUrl = "https://discord.com/api/webhooks/1497362479179628684/pQ19B1rGEZcvVb66M6buRmZCvQA23J3JP3pgnuaEvypHJe5hf_cfvEcu-5hY3RKiWrRe"  -- Set your Discord webhook here

--==============================
-- ADMIN / PERMISSIONS
--==============================
-- ACE permission required to use admin commands (whitelist etc).
-- Grant with: add_ace group.admin project07.admin allow   (or to a specific identifier)
Project07.AdminAce = "project07.admin"

--==============================
-- IN-GAME CHARACTER NAME LOCK
--==============================
-- This runs AFTER the player has loaded a character in your multicharacter
Project07.EnableCharacterLock = true

-- If true, automatically hooks into ESX ('esx:playerLoaded') and
-- QBCore/Qbox ('QBCore:Server:PlayerLoaded') player-loaded events so you
-- don't have to manually trigger the lock check. If you have a custom
-- framework, set this to false and trigger the lock check manually with:
Project07.AutoDetectFramework = true

-- How long (seconds) a mismatched player is frozen with the lock screen
-- before being force-disconnected. There is no "unlock" without reconnecting,
-- because a FiveM display name can only change after restarting FiveM.
Project07.CharacterLockKickAfter = 45

Project07.CharacterLockWarningText =
    "Your FiveM name does not match this character's IC name."

--==============================
-- WHITELIST COMMAND
--==============================
-- Command name for admins to whitelist a connected player (bypasses
-- both the connect-time check and the in-game character lock).
-- Usage in-game: /wlnamechecker [server id]
Project07.WhitelistCommand = "wlnamechecker"

--==============================
-- BLACKLIST NAMES SYSTEM
--==============================
Project07.EnableBlacklist = true  -- Blacklist system on/off 

--  Blacklisted words
Project07.BlacklistedNames = {
    "admin",
    "moderator",
    "owner",
    "staff",
    "support",
    "helper",
    "god",
    "allah",
    "jesus",
    "buddha",
    "fuck",
    "shit",
    "bitch",
    "nigga",
    "nigger",
    "cunt",
    "pussy",
    "dick",
    "cock",
    "ass",
    "bastard",
    "whore",
    "slut",
    "hitler",
    "nazi",
    "terrorist",
 -- Add more blacklisted words as needed
}

-- Exact match blacklist 
Project07.ExactBlacklistedNames = {
    "John Doe",
    "Jane Doe",
    "Test User",
    "Player",
    -- Add more exact blacklisted names as needed
}

```

{% endcode %}
