Configuration Guide

Reference for the current oxide-landscapingjob config surface.

Config File Map

Core Settings

shared/config.lua

Config.Debug = false
Config.usePhone = true
Config.shiftSummary = 'text'
Config.menuStyle = 'nui'
Config.MaxSlotsPerLocation = 3

Crew Settings

shared/config/job.lua

Notes:

• Crew invites are ID-based in the current UI flow.
• The server still enforces inviteRange when validating the invite.

Payment Settings

shared/config/job.lua

payoutAccount is where net shift pay is deposited. fineAccount is where the van-destruction fine is withdrawn from. Both accept any account name your o-link money provider supports ('bank', 'cash', 'dirty', etc.).

Level Definitions

shared/config/job.lua

The "Title Key" column is a translation key — the text players actually see comes from locales/en.json, so you can rename the ranks there without touching the config.

Yard Tiers and Timer

shared/config/job.lua

Tier thresholds:

Tier multipliers are defined in shared/init.lua:

• small: 1.0
• medium: 1.5
• large: 2.0

Timer settings:

Every yard gets a time limit of baseTime seconds plus timePerPatch seconds per grass patch. Finishing after the timer runs out doesn't fail the yard — the pay for it is just multiplied by expiredPenalty (0.85 = a 15% pay cut).

Complaint Settings

shared/config/job.lua

Players collect complaints for destroying company vehicles or dying on shift. Reaching maxComplaints suspends them from the job for timeoutMinutes minutes (and resets the count). Each completed yard removes decayPerYard complaints, so steady workers stay clean.

Vehicle Settings

shared/config/vehicles.lua

Company Vehicle

livery selects a livery index for replacement van models that ship multiple liveries (-1 keeps the model default). extras is an optional { [extraId] = enabled } map for forcing extras on/off on custom models.

Config.Rumpo.mowerAttach controls the cosmetic mower position on the van.

Mower

When allowFinishYardOnBreakdown = true, the current yard can be resumed after repair. The breakdown still counts toward complaint handling.

livery / extras work the same as on the van and are useful only if the stock mower model is replaced.

Mower Damage Particles

Config.Mower.damage.smoke and Config.Mower.damage.hitEffect describe the particle effects shown when the mower takes damage or hits an obstacle. Each entry contains:

• dict — particle dictionary (default 'core')
• name — particle effect name
• offset — vector3 relative to the mower
• scale — float

Blade Settings

Blade Particles

Config.Mower.blades.particle defines the grass-cutting effects:

• dict — particle dictionary (default 'core')
• burstName — non-looped burst played per patch cut
• loopedName — looped effect while blades are down and the mower is moving
• scale — float
• offset — vector3 relative to the mower

Blade Audio

xsound-backed audio settings:

• toggle = 'lower_mechanical_whirr.ogg'
• mowerLoop = 'lawn_mower_engine_loop.ogg'
• engineFail = 'engine_fail.ogg'
• toggleVolume = 0.2
• loopVolume = 0.3
• engineFailVolume = 0.4
• distance = 30

Mowing and Obstacles

shared/config/mowing.lua

Grass Props

Config.GrassProps contains the valid patch models used by the shipped yards and the yard editor.

Obstacle Props

Config.ObstacleProps contains the valid obstacle models used by the shipped yards and the yard editor.

Obstacle Settings

highlight.key is the default binding for the +landscaping_highlight keybind (rebindable from the FiveM keybinds menu). Holding it during an active yard with remaining obstacles outlines them in highlight.color; otherwise it shows yard waypoints.

Mowing Detection

fadeSteps is the number of alpha steps used when a cut patch fades out. fadeStepInterval is the delay in milliseconds between each step. mowerCheckInterval is the polling interval in milliseconds for mower-to-patch proximity checks.

Animations

Configured actions:

• unload mower
• load mower
• repair mower
• pick up obstacle

Animation labels are locale keys, not hardcoded strings.

Visual Settings

shared/config/visuals.lua

NPC

Office Blip

Set Config.Blip.enabled = false to hide office blips on the map entirely.

Yard Blip

Yard Marker

Floating Waypoints

Yard Editor

Locations and Menu Camera

shared/config/locations.lua

Each office entry includes:

• name
• coords
• heading
• vehicleSpawn
• optional menuCamera

menuCamera is used only by the NUI menu flow and contains:

• coords
• heading
• fov

Yards contain:

• name
• coords
• patches
• optional obstacles

Uniforms

shared/config/outfits.lua

The file also defines:

• Config.LandscapingOutfitMale
• Config.LandscapingOutfitFemale

These outfits are applied through olink.clothing.

Tutorials

shared/config/tutorials.lua

Config.Tutorials defines the one-time onboarding hints shown the first time a player encounters a given situation. Each entry is keyed by an event id and contains:

• icon — Font Awesome class
• title — locale key
• body — locale key
• duration — optional seconds (default applied by the tutorial module)
• position — optional screen position (top-right, top-left, bottom-right, bottom-left, center-top, center, center-bottom)

Shipped events: first_clockin, first_mower_unload, first_blades_lowered, first_obstacle, first_yard_complete, first_timer_expired, first_vehicle_damage, first_mower_damaged, first_level_up, first_crew.

Players can toggle tutorials on/off with /landscapingtutorials and re-show all tutorials with /landscapingtutorialreset.

To remove an event entirely, delete its entry from Config.Tutorials.

Notes on Builder Exports

The in-game yard builder writes its output to exported_locations.lua in the resource folder. The game does not read that file directly — the live yards always come from shared/config/locations.lua.

After exporting, copy the contents of exported_locations.lua into shared/config/locations.lua and restart the resource. See YARD-BUILDING.md for the full walkthrough.

Next Steps

• FEATURES.md
• ADMIN.md
• YARD-BUILDING.md
• TROUBLESHOOTING.md