Mission s

File: shared/config.lua → Config.Missions

An array of mission definitions. Each entry describes a complete job location with its tasks, rewards, and metadata.

Mission fields

Key	Type	Description
id	string	Unique mission identifier.
label	string	Display name shown in the UI.
location	table	Location metadata and spawn point.
rewards	table	Money and XP awarded on completion.
information	table	UI metadata (description, tags, image, etc).
maintasks	table	Primary tasks (must be completed).
minitasks	table	Secondary bonus tasks.

---

location

Key	Type	Description
road	string	Street / area name.
city	string	City name.
coords	vec3	Primary world coordinates.

rewards

Key	Type	Description
money	number	Cash reward.
xp	number	Experience points reward.

information

Key	Type	Description
description	string	Short description shown in the mission list.
duration	string	Estimated duration label (e.g. '15m').
level	number	Minimum level required.
image	string	Path to the background image.
tags	table	Array of tag strings (e.g. {'Easy', 'Regular'}).

---

Task types

maintasks

Primary tasks that define the core activity of a mission.

cuttinggrass

Key	Type	Description
enabled	boolean	Whether the task is active.
label	string	Task display name.
mowerModel	string	Prop model for the lawnmower.
zones	table	Array of vec3 grass zone positions.

minitasks

Optional secondary tasks that provide bonus rewards.

cuttinghedge

Key	Type	Description
enabled	boolean	Whether the task is active.
label	string	Task display name.
hedgeModel	string	Prop model for the hedge.
zones	table	Array of vec3 hedge positions.

plantflowers

Key	Type	Description
enabled	boolean	Whether the task is active.
label	string	Task display name.
flowerModel	string	Prop model for the flower.
zones	table	Array of vec3 flower positions.

garbage

Key	Type	Description
enabled	boolean	Whether the task is active.
label	string	Task display name.
garbageModel	string	Prop model for the garbage bag.
zones	table	Array of vec3 garbage spawn points.
dumpster	table	Dumpster object (see below).

dumpster

Key	Type	Description
coords	vec4	Position and heading.
model	string	Prop model for the dumpster.

---

Full example

Config.Missions = {
    {
        id = 'mirrorpark_1',
        label = 'Mission Park',
        location = {
            road = 'Mirror Park',
            city = 'Los Santos',
            coords = vec3(1270.99, -648.16, 67.94),
        },
        rewards = { money = 450, xp = 150 },
        information = {
            description = 'Mow the lawns around Mirror Park.',
            duration = '15m',
            level = 1,
            image = './images/bg1.webp',
            tags = { 'Easy', 'Regular' },
        },
        maintasks = {
            cuttinggrass = {
                enabled = true,
                label = 'Mow the lawn',
                mowerModel = 'prop_lawnmower_01',
                zones = { vec3(...), vec3(...) }
            },
        },
        minitasks = {
            cuttinghedge = {
                enabled = true,
                label = 'Trim the hedges',
                hedgeModel = 'prop_bush_neat_08',
                zones = { vec3(...), vec3(...) }
            },
            plantflowers = {
                enabled = true,
                label = 'Plant and water flowers',
                flowerModel = 'prop_flower_01',
                zones = { vec3(...) }
            },
            garbage = {
                enabled = true,
                label = 'Collect garbage',
                garbageModel = 'prop_ld_rub_binbag_01',
                zones = { vec3(...) },
                dumpster = {
                    coords = vec4(1252.65, -667.51, 67.62, 116.35),
                    model = 'prop_cs_dumpster_01a'
                },
            }
        }
    },
}

---

Missions System

File: shared/config.lua → Config.MissionSystem

Controls how missions are distributed among players on the server.

Fields

Key	Type	Default	Description
Mode	string	'buckets'	Mission distribution mode (see below).
BaseBucketId	number	5000	Starting routing bucket ID used for virtual worlds.

Modes

'global_lock'

First come, first served. When a player starts a mission, that mission is locked on the map and unavailable to others until completed or abandoned.

'buckets'

Every player (or party) enters their own routing bucket (virtual world). Multiple players can run the same mission simultaneously without interfering with each other.

Example

Config.MissionSystem = {
    Mode = 'buckets',
    BaseBucketId = 5000
}