Configuration

Configuration options and settings

Configuration

The Legacy Scoreboard can be customized through the config.lua file. Below are all available configuration options.

Basic Settings

Option Type Default Description
Version string '1.0.0' Script version identifier
Locale string 'en' Language locale (currently only English)
Debug boolean true Enable debug logging

Display Configuration

Option Type Default Description
LogoText string 'LRP' Short tag rendered in the header logo tile
ServerName string 'Limitless Roleplay' Full server name displayed in header
Patch string 'v1.0.0' Server patch/build version sub-line

Role Capacity Settings

Defines the maximum capacity for each job role displayed in on-duty cards:

Role Type Default Description
leo number 12 Law Enforcement capacity
ems number 8 Emergency Medical Services capacity
mech number 6 Mechanic capacity
cab number 4 Taxi/Cab capacity
gov number 4 Government capacity
news number 3 News/Press capacity

Job Role Mapping

Maps framework job names to role buckets:

lua
Config.JobRoles = {
    leo  = { 'police', 'sheriff', 'lspd', 'sasp' },
    ems  = { 'ambulance', 'ems', 'doctor' },
    mech = { 'mechanic', 'cardealer' },
    cab  = { 'taxi' },
    gov  = { 'mayor', 'judge', 'lawyer', 'gov' },
    news = { 'reporter', 'journalist', 'press', 'news' },
}

Restart Configuration

Option Type Default Description
RestartIntervalMinutes number 360 Minutes between scheduled restarts (6 hours)
NextRestartEpoch number/nil nil Override with specific restart time (os.time() format)

Refresh Settings

Option Type Default Description
RefreshIntervalMs number 3000 Live refresh interval while scoreboard is open (milliseconds)

Sparkline Configuration

Option Type Default Description
SparklineSamples number 36 Number of player count samples to store
SparklineSampleSeconds number 60 Seconds between each sample

Permission Groups

Option Type Default Description
AdminGroups table { 'god', 'admin' } ACE groups that count as admin (crown icon)
DonatorAceGroups table {} ACE groups for donators (star icon)
StreamerAceGroups table {} ACE groups for streamers (camera icon)

Footer links displayed in the scoreboard:

lua
Config.QuickLinks = {
    discord = 'discord.gg/limitless',
    rules   = 'limitlessrp.gg/rules',
    donate  = 'store.limitlessrp.gg',
    forum   = 'forums.limitlessrp.gg',
}

Example Configuration

lua
Config = {}

Config.Version = '1.0.0'
Config.Locale = 'en'
Config.Debug = false

-- Your server branding
Config.LogoText = 'YourRP'
Config.ServerName = 'Your Roleplay Server'
Config.Patch = 'v2.1.0'

-- Adjust role capacities for your server
Config.RoleCapacity = {
    leo  = 15,  -- More police slots
    ems  = 10,  -- More EMS slots
    mech = 8,   -- More mechanic slots
    cab  = 6,   -- More taxi slots
    gov  = 6,   -- More government slots
    news = 4,   -- More news slots
}

-- 4-hour restart cycle
Config.RestartIntervalMinutes = 240

-- Faster refresh for busy servers
Config.RefreshIntervalMs = 2000

-- Your community links
Config.QuickLinks = {
    discord = 'discord.gg/yourserver',
    rules   = 'yourserver.com/rules',
    donate  = 'store.yourserver.com',
    forum   = 'forum.yourserver.com',
}

Always backup your configuration before making changes. Invalid configurations can cause the script to fail.