FAQ

Does it work standalone or do I need Nexus Multicharacter?

Both. It runs perfectly fine on its own as a spawn picker. If you also use Nexus Multicharacter and set Config.UseSpawnSelector = true in the multichar config, character selection will route through the spawn selector automatically.

Framework auto-detection isn’t picking up my framework

Config.Framework = 'auto' works for most setups, but if your framework is loaded oddly or you’re running a fork, it can miss. Force it explicitly:

Config.Framework = 'qbx' -- auto | qb | qbx | esx

How do I add a new spawn location?

Add an entry to Config.SpawnLocations. The minimum required fields are id, name, and position:

Config.SpawnLocations = {
    -- existing entries...
    {
        id       = 'beach_spawn',
        name     = 'Vespucci Beach',
        subtitle = 'Spawn at the beach',
        position = vector3(-1635.0, -1015.0, 13.0),
    },
}

subtitle, image, icon, and jobs are all optional.

How do I restrict a spawn point to a specific job?

Use the jobs field. You have two options:

Any of these jobs can use it:

jobs = { 'police', 'sheriff' }

Job with a minimum grade required:

jobs = { police = 0, sheriff = 2 }

Players whose job doesn’t match won’t see the spawn point in their menu.

My housing or property option isn’t showing up

Three things to check:

• Config.UseHousing.enable is set to true.
• Config.UseHousing.Housing_script matches the resource you actually have installed.
• The player owns a property in that housing script. If they don’t own one, the option is hidden.

My housing script isn’t on the supported list

You can wire up any housing resource by editing server/sv_customize.lua. The integration logic for the built-in housing scripts lives there. Copy one of the existing handlers as a starting point.

How do I hide all preset spawns and only use the last-location option?

Set Config.UseOnlyLastLocation = true. The preset entries in Config.SpawnLocations are hidden and the player only sees the Last Location option.

How do I change the UI colors?

Open shared/theme.lua and edit the values. Hex codes for solid colors, rgba() for the glass panels:

Theme = {
    accent      = '#2389FD',  -- Primary accent (selected state, button glow)
    textPrimary = '#FFFFFF',
    textMuted   = '#AFAFAF',
    -- ...
}

The full list of theme keys is documented on the Config page.

Can I translate it to another language?

Yes. Open shared/locales.lua, copy the Locales['en'] = { ... } block, rename it (for example Locales['de']), and translate the values. Then in shared/config.lua set Config.Locale = 'de'.

Can I rename the resource folder?

Yes. Rename the folder to whatever you want, then update the ensure line in your server.cfg to match.

Need help with something else?

Hop into our Discord  and we’ll help you out.