Spawn Selector

Koja Spawn Selector: a live 3D map of San Andreas to pick where players spawn, with job locks, last location, property providers, a cinematic flight and a developer API on koja-lib.

Koja Spawn Selector

Koja Spawn Selector lets players choose where they wake up on a live 3D map of San Andreas — terrain, buildings and all — and then flies the camera from the sky down to their character. It is built on koja-lib, uses the same look as Koja Appearance and gives other scripts a full API to add their own locations.

This section covers version 1.0.0 of the resource.

What you get

Area	What is in it
3D map	Radar tiles with level of detail, terrain from the in-game heightmap and extruded buildings. Drag to move, right drag to rotate, scroll to zoom at the cursor
Locations	Last location, arrival points for new characters, properties, job and gang spawns, city spawns — grouped and filterable from the top toolbar
Locks	Jobs with a minimum grade, on-duty only, gangs, ACE permissions and your own checks. Locked spots stay visible with a "Police only" badge, or can be hidden
Last location	Saved every minute, on logout and on disconnect, shown with "17 minutes ago"
Camera flight	A top-down shot over the spot, a descent to the street and a hand-over to the gameplay camera, with a letterbox caption
Integrations	ESX `esx:playerLoaded`, a drop-in replacement for `qb-spawn` (with `qb-apartments` starter apartments), `qb-houses` owned houses, Koja Multicharacter
Developer API	Client and server exports, per-player providers, access checks, categories, events and `import.lua`
Languages	10 languages: cs, de, en, es, fr, it, nl, pl, pt-BR, tr

Quick facts

Frameworks: ESX, QBCore and QBox, through koja-lib.
Requires: koja-lib and oxmysql.
Security: locks are checked on the server, and the server checks the chosen location again before the player spawns. The UI never decides access.
Database: one table, koja_spawnselector, created on start.
UI: shipped prebuilt in web/dist. You only need Node and pnpm to change it.

Start here

Install it
Installation — dependencies, server.cfg order and what to remove.
Configure it
Configuration — every option in shared/config.lua and the spawn definition.
Learn what it does
Features — the map, locks, last location, camera flight and integrations.
Use it from your own code
Developer API — add houses, motels, jail or anything else as a spawn location.