GFX Spawn Selector

An interactive spawn location selector for FiveM. Players choose their spawn point from a list of configurable locations displayed alongside a live GTA V map rendered via DUI on an in-world whiteboard prop. The character is placed in a scenic interior room with a scripted camera while the NUI map and location menu are shown. Hovering a location pans the map; clicking "Spawn Here" teleports the player. Supports both QBCore and ESX frameworks.

Info

Dependencies

The script's built-in utils layer auto-detects the active framework, inventory, skin script, and SQL resource. No manual framework setting is needed.

Installation

1. Copy Files

Place the gfx-spawnselector folder into your server's resources directory.

2. Stream Assets

The script uses a custom whiteboard model (gfx_whiteboard). Ensure the model and its texture dictionary (gfx_whiteboard_text) are streamed. If the resource includes a stream/ folder, it is handled automatically; otherwise verify the model asset is available on your server.

3. server.cfg

ensure gfx-spawnselector

Ensure your framework resource (es_extended or qb-core) starts before gfx-spawnselector.

4. Configure

Edit config/client_config.lua and config/server_config.lua to match your server setup (see Configuration section below).

Configuration

client_config.lua

Theme

Scene Setup

Spawn Locations

Each spawn location entry:

The description field for each location is automatically populated at runtime using the GTA V street name at the given coordinates.

Example:

Config.SpawnLocations = {
    {
        name = "Legion Square",
        coords = vector3(213.94, -920.4, 30.69),
        heading = 320.0,
        blipSprite = 1,
        blipColor = 2,
        preview = {
            coords = vector3(213.94, -920.4, 50.69),
            rotation = vector3(-30.0, 0.0, 160.0)
        }
    },
    -- Add more locations here
}

server_config.lua

locale.lua

Exports

No exports are created by this script.

Note: The client utils file contains several DUI helper functions (getDui, changeDuiUrl, releaseDui, sendDuiMessage, getDuiHandle) but their export registrations are commented out and not active.

Events

No public API events are exposed by this script for external use.

All registered events are internal (framework initialization callbacks, NUI communication, and resource cleanup).

Commands

There is also a /boiler command inherited from the boilerplate template that toggles the NUI frame visibility. This is a development leftover and not intended for production use.

Features

Interactive Map Display

• DUI-based Leaflet map rendered on an in-world whiteboard prop using GTA V Atlas-style map tiles
• Location markers placed on the map for each configured spawn point
• Map panning -- hovering over a location in the sidebar smoothly pans the map to that point

Selection Scene

• Interior room setup -- the player is teleported to a configured interior position during selection
• Scripted camera -- a fixed camera frames the character and whiteboard for a cinematic selection view
• Character animation -- the player ped plays an idle guard animation while the selector is open
• Preview cameras -- each spawn location has configurable preview camera coordinates for location previews with smooth camera interpolation

Spawn Location Menu

• Sidebar UI with location name, auto-generated street description, optional icon, and a "Spawn Here" button
• Hover effects -- non-hovered locations dim to 60% opacity for visual focus
• Configurable locations -- add, remove, or modify spawn points entirely through config

Framework Support

• Auto-detection of ESX or QBCore at startup
• Notification integration with framework-native notifications (or custom override via config)
• Player avatar retrieval via Steam profile or Discord API (server-side)

Technical

• DUI pooling system -- reuses DUI browser instances by size for efficiency
• Clean resource stop -- destroys cameras, DUI objects, whiteboard props, and clears ped tasks on resource stop
• Locale system -- built-in translation support with _L() function

Troubleshooting

Source

• GitHub: https://github.com/gfx-fivem/gfx-spawnselector
• Organization: GFX-Fivem