Configuration

wasabi_spawn is configured through shared, client, and server config files.

config/shared/config.lua

Shared settings used by the spawn bridge and common runtime.

local config = {
    debug = false,

    -- If true, use qb-apartments for new-character apartment selection like default qb-spawn.
    qbApartments = true,

    -- House script for returning-player spawn options: 'qb-houses', 'custom', or false to disable house spawns.
    houseScript = 'qb-houses',
}

Modules.register('config', config, true)

config/client/config.lua

Client-facing UI, animation, last-position, and default spawn settings.

local config = {
    -- UI accent color.
    uiColor = '#29b181',

    -- If true, plays a synchronized cinematic scene when the player spawns.
    -- Skipped automatically for new-character customization flow.
    spawnAnimation = true,

    -- When true, a "Last Location" option is prepended for returning players.
    -- Ignored for new characters. When false, only configured spawns are shown.
    allowLastPosition = true,

    defaultSpawns = {
        {
            id = 'police',
            title = 'Police Station',
            subtitle = 'Mission Row',
            description = 'The police station in Mission Row is the headquarters of the Los Santos Police Department. It is home to a team of officers who work to protect and serve the residents of Los Santos. The station is equipped with facilities and equipment to help officers carry out their duties efficiently.',
            coords = vector4(428.78, -985.59, 30.71, 5.56),
            cameraCoords = vector4(409.9, -984.15, 34.24, 268.18),
            showAtFirstSpawn = true,
        },

        {
            id = 'hospital',
            title = 'Pillbox Hospital',
            subtitle = 'Little Seoul',
            description = 'The hospital in Mission Row is a state-of-the-art medical facility that provides a wide range of healthcare services to the residents of Los Santos. It is staffed by a team of highly trained doctors, nurses, and support staff who are dedicated to providing the highest quality care to their patients.',
            coords = vector4(296.23, -591.55, 43.28, 71.21),
            cameraCoords = vector4(265.62, -568.98, 50.35, 248.67),
            showAtFirstSpawn = true,
        },

        {
            id = 'forest',
            title = 'Paleto Bay Forest',
            subtitle = 'Paleto Bay',
            description = 'The forest in Paleto Bay, located in the northern part of San Andreas, is a dense and scenic woodland filled with towering pine trees, winding trails, and diverse wildlife. It offers breathtaking views of the mountains and ocean, making it a perfect spot for hiking, camping, and adventures.',
            coords = vector4(-710.17, 5791.05, 17.46, 69.25),
            cameraCoords = vector4(-722.21, 5875.39, 28.8, 203.69),
            showAtFirstSpawn = true,
        },
    },
}

Modules.register('config', config, true)

Spawn fields

Field	Description
id	Unique spawn ID.
title	Main label displayed in the selector.
subtitle	Secondary location label.
description	Longer location description shown in the UI.
coords	Player spawn position as vector4(x, y, z, heading).
cameraCoords	Optional camera preview position as vector4. Without it, preview uses spawn coords at eye height.
showAtFirstSpawn	Set false to hide the location from new-character first spawn.

config/server/config.lua

Server-side update check setting.

local config = {
    checkForUpdates = true,
}

Modules.register('config', config, true)