Lumo Spawn

Spawn selector with a live map, last location, property spawns and an in-game editor.

Version 1.0.3 · Frameworks QBCore · Qbox · ESX · standalone

Installation · Config files · Exports & events · Changelog

Bundle

Sold together with Multicharacter as the Character & Spawn bundle.

Spawn selector with a live map, last-location and property spawns, and an in-game spawn point editor.

QBCore · Qbox · ESX · Standalone (detected automatically) · by Lumo · https://lumo-server.tebex.io/

Version 1.0.0 · one folder, no lumo-bridge or any other Lumo resource needed

---

Features

• Map-based spawn picker over your own locations, with a camera fly-in
• Last location spawn
• Owned house / apartment spawn with qb-apartments, qb-houses, qs-housing, ps-housing, lumo-housing (buttons hide when none is installed)
• /spawneditor: add, move, rename and delete spawn points in-game, saved to the database and live for everyone at once
• Works with any character script: lumo-multicharacter, qb-multicharacter, Qbox's built-in selection, esx_multicharacter flows that fire the stock event
• Standalone mode: no framework? It opens when the player joins and remembers where each player logged off
• Drop-in replacement: keeps every qb-spawn: event name and declares provide 'qb-spawn'
• 0.00 ms idle

Requirements

Resource	Needed?
oxmysql	Required
qb-core / qbx_core / es_extended	Optional, detected automatically (standalone works too)
A character script	Optional. lumo-multicharacter recommended; standalone works without one
Housing / apartments	Optional
ox_lib	Optional (notifications in standalone)

Installation (short version)

1. Put the lumo-spawn folder in your resources folder.

2. Remove the spawn selector you are replacing:

   Framework	What to do
   QBCore	Stop qb-spawn (move it out of [qb])
   Qbox	Move qbx_spawn out of [qbx]. Keeping Qbox's own character selection? Also install the [compat]/qbx_spawn marker
   ESX	Nothing to remove
   Standalone	Nothing to remove

3. In server.cfg, ensure it after oxmysql and your framework, and before your character script:

   ensure oxmysql
   ensure qb-core            # or qbx_core / es_extended / nothing
   ensure lumo-spawn
   ensure lumo-multicharacter  # or your character script

4. Start the server. The spawn_locations table is created and filled from the config automatically. Console:

   [lumo-spawn] ready — framework: qb

Full step-by-step guide for every framework: Installation.

Commands

Command	Who	What
/spawneditor	Admin (god, admin)	Open the spawn point editor

Admin = the framework's group, or the ACE group group.admin in standalone.

Configuration

shared/config.lua:

Option	What it does
QB.Spawns	Your spawn points (seeds the database on first start)
QB.SpawnAccess	Show/hide the apartments, houses and last-location buttons
Config.SpawnEditor	Editor on/off, command name, admin groups, table name
Config.CustomPermission	function(source) → true/false to decide editor access yourself
Config.CustomNotify	function(source, message, type) for your own notifications
Config.House	Housing script style ("qb", or "custom" for ps-housing)
Config.Standalone	Open on join and default ped when no character script runs
Config.SyncLumoUI	Share theme settings with Lumo HUD if installed (not required)

bridge/config.lua — framework layer: force a framework, standalone settings, custom core hooks. Most servers never touch it.

For developers

Listens for the stock events, so any character script can hand over:

TriggerClientEvent('qb-spawn:client:setupSpawns', src, playerData, isNew, apartments)
TriggerClientEvent('qb-spawn:client:openUI', src, true)

Standalone events and exports: Standalone.

Troubleshooting (top 4)

• Spawn menu never opens — on Qbox with Qbox's own character selection, the [compat]/qbx_spawn marker must be installed and started.
• framework: standalone on a framework server — ensure your core before this script.
• Edits disappear after restart — Config.SpawnEditor.UseDatabase must be true and the database user must be able to write.
• Houses button never appears — it only shows when you own a property and a supported housing script runs.

More in Support.

Docs

• Installation, every framework
• Standalone mode, exports and events
• Frameworks and custom cores
• Troubleshooting and support
• Changelog

Build the interface (open-source edition)

cd lumo-spawn/nui
npm ci
npm run build

Store, updates and other releases: https://lumo-server.tebex.io/