Koja Scripts

Spawn Selector

Koja Spawn Selector: a live 3D map of San Andreas to pick where players spawn, with live preview, anti combat log, job locks, housing, an in-game editor, events, stats 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, the server's time and weather — 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 locations, lock them and react to spawns.

This section covers version 1.0.0 of the resource.

What you get

AreaWhat is in it
3D mapRadar tiles with level of detail, terrain, extruded buildings, day / night, rain and snow, road route from the last location, game blips
Live previewThe card shows the selected spot live from a camera circling it, or the photo taken in the editor
LocationsLast location, arrival points, properties, job and gang spawns, city spawns and timed events — grouped, searchable, with favourites
LocksJobs with a minimum grade, on duty, gangs, ACE permissions and your own checks. Locked spots stay visible with a "Police only" badge
Anti combat logCombat logouts and relogs are recorded, shown to nearby players, logged to Discord and lock the last location. Death forces the hospital, jail forces the prison
VehiclesSpawn in the driver seat of a car — from config, the editor or a garage provider
Admin toolsIn-game location editor with map picking and photos, timed events, spawn statistics
Camera flightA top-down shot, a descent to the street and a hand-over to the gameplay camera, with a letterbox caption
IntegrationsESX, a drop-in replacement for qb-spawn, 6 housing scripts, jail and ambulance flags, Koja Multicharacter
Developer APIClient and server exports, providers, access checks, restrictions, last location rules, events and import.lua
Languages10 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. screenshot-basic only for editor photos.
  • Security: locks, restrictions and the chosen location are checked on the server. The UI never decides access, and a restricted player cannot cancel.
  • Database: four koja_spawnselector* tables, created on start.
  • UI: shipped prebuilt in web/dist. You only need Node and pnpm to change it.

Start here

  1. Install it

    Installation — dependencies, server.cfg order and what to remove.
  2. Configure it

    Configuration — every option in shared/config.lua and the spawn definition.
  3. Learn what it does

    Features — the map, live preview, locks, vehicles and integrations.
  4. Stop combat logging

    Anti combat log & restrictions — death, jail, relogs and forced spawns.
  5. Use it from your own code

    Developer API — houses, garages, motels or anything else as a spawn location.

In this section