Configuration

Configuration

This guide covers all configuration options available in Prodigy Chat. All settings are located in config.lua.

General Configuration

Basic Settings

Config.moneySymbol = "$"                    -- Currency symbol used throughout the chat system
Config.welcomeMessage = false               -- Enable welcome message on player connect
Config.serverName = "Server Name"           -- Server name displayed in welcome message
Config.maxCharactersPerMessage = 250        -- Maximum characters allowed per chat message

Job Advertisement Configuration

Config.jobAdWhitelistedJobs = {
    "police", "ambulance", "mechanic", "taxi", 
    "realestateagent", "cardealer", "banker", 
    "lawyer", "reporter"
}
Config.adCooldowns = 100                    -- Cooldown in seconds between /ad and /jobad messages
Config.adPrice = 100                        -- Set to 0 to disable charge

Permission Groups Configuration

Prodigy Chat uses ESX's group system for permissions. Groups are stored in the users table's group column.

Config.allowedGroups = {
    admin = { "owner", "management", "leadadmin", "developer", "admin" },
    staff = { "owner", "management", "leadadmin", "developer", "gameadmin", "tester", "admin" },
    moderator = { "owner", "management", "leadadmin", "developer", "gameadmin", "tester", "mod", "admin" }
}

Group Descriptions

• management: Management, full access to all commands

• developer: Developers, full access to all commands

• leadadmin: Lead Admins, can use /la, /aooc, /announce, /changeplayername

• gameadmin: Game Admins, can use /adminduty, /admins, /sc, /a, /setmodel, /clearmap

• tester: Beta testers, can use /help, /report, /tickets, /testers

Feature Toggles

Misc Features

Config.autoAdminDuty = true                 -- Automatically put admins on duty when they join
Config.lostItems = true                     -- Enable lost items tracking
Config.misclick = true                      -- Enable /mc misclick restore command
Config.weather = true                       -- Enable /weather command
Config.weatherUseEasytime = true            -- Use cd_easytime resource for real weather data
Config.autowalk = true                      -- Enable autowalk command /walk on|off
Config.hair = true                          -- Enable hair toggle command /hair
Config.useOxlibNotify = true                -- Use ox_lib notifications or chat message if false
Config.textRoleplayDefault = true           -- Enable text roleplay mode by default for new players
Config.phonetext = true                     -- LB phone ONLY: Enable phone text commands (/p, /ps, /phonesay, /ptalk, /pflirt)

Admin Commands

Config.admincmds = false                     -- Enable admin commands (/tpm, /goto, /bring, /kill, /freeze, /warn, /reviveall)
Config.warnMax = 3                          -- Maximum warns before player gets kicked

Clothing System Configuration

The clothing system allows players to toggle clothing items on/off for roleplay scenarios.

Config.clothing = {
    enabled = true,
    shirt = {
        Male = { Shirt = 15, Torso = 15 },
        Female = { Shirt = 15, Torso = 0 }
    },
    undershirt = {
        Male = 15,
        Female = 15
    },
    arms = {
        Male = 219,
        Female = 0
    },
    bra = {
        On = 14,
        Off = 15
    },
    pants = {
        Male = 61,
        Female = 15
    },
    panties = {
        On = 14,
        Off = 15
    },
    shoes = {
        Male = 34,
        Female = 35
    },
    chain = {
        Male = 0,
        Female = 0
    },
    decals = {
        Male = 0,
        Female = 0
    },
    vest = {
        Male = 0,
        Female = 0
    },
    bags = {
        Male = 0,
        Female = 0
    },
    mask = {
        Male = 0,
        Female = 0
    }
}

Available Clothing Commands: /shirt, /bra, /pants, /panties, /shoes, /chain, /decals, /vest, /bag, /mask, /hat, /glasses, /earrings, /watch, /bracelet

Damage Tracking System

The damage tracking system monitors and displays damage taken by players.

Config.damages = true                       -- Enable damages tracking system
Config.damagesMaxLines = 8                  -- Maximum damage entries to display (6-8 recommended)
Config.damagesAllowClear = true             -- Allow /cdamages command to clear damage history

Damage Configuration

-- Weapons to ignore in damage tracking
Config.damagesIgnore = {
    'WEAPON_UNARMED',
    'WEAPON_FISTS',
    'WEAPON_RUN_OVER_BY_CAR',
    'WEAPON_RAMMED_BY_CAR',
}

-- Melee weapons list
Config.damagesMeleeWeapons = {
    'WEAPON_KNIFE',
    'WEAPON_HAMMER',
    'WEAPON_BAT',
    -- ... (see config.lua for full list)
}

-- Body parts mapping (bone indices to body part names)
Config.damagesBodyParts = {
    [11816] = {["part"] = "Pelvis", ["boneIndex"] = 11816},
    [58271] = {["part"] = "Left Thigh", ["boneIndex"] = 58271},
    -- ... (see config.lua for full list)
}

-- Weapon name mapping
Config.damagesWeapons = {
    [tostring(GetHashKey('WEAPON_PISTOL'))] = 'Pistol',
    [tostring(GetHashKey('WEAPON_KNIFE'))] = 'Knife',
    -- ... (see config.lua for full list)
}

Auto Grammar Configuration

Automatic grammar correction for common mistakes.

Config.autogrammarCommonMistakes = {
    ["teh"] = "the",
    ["adn"] = "and",
    ["taht"] = "that",
    ["wht"] = "what",
    ["ur"] = "your",
    ["u"] = "you",
    ["r"] = "are",
    ["btw"] = "by the way",
    ["lol"] = "laughing out loud",
    ["omg"] = "oh my god"
}

Configuration Best Practices

1. Start with defaults: Begin with default settings and adjust as needed

2. Test changes: Test configuration changes on a test server first

3. Backup config: Always backup your config.lua before making changes

4. Document customizations: Keep notes on why you changed specific settings

5. Group permissions: Carefully configure permission groups to match your server structure

Common Configuration Scenarios

Disable Admin Commands

Config.admincmds = false

Enable Phone Commands

Config.phonetext = true
-- Requires LB Phone resource

Customize Permission Groups

Config.allowedGroups = {
    admin = { "owner", "admin", "superadmin" },
    staff = { "owner", "admin", "superadmin", "moderator" },
    moderator = { "owner", "admin", "superadmin", "moderator", "helper" }
}

Disable Clothing System

Config.clothing = {
    enabled = false,
    -- ... rest of config
}

Adjust Damage Tracking

Config.damages = true
Config.damagesMaxLines = 6                  -- Show fewer entries
Config.damagesAllowClear = false            -- Prevent clearing damage history