Yard Building Guide

Practical guide for creating and exporting landscaping offices and yards with the built-in builder.

What the Builder Does

The builder lets admins:

• create office locations
• set vehicle spawn points
• create yards
• place grass patches
• place obstacles
• review the current builder session
• export merged Lua data

Your builder work lives in a temporary "session" on the server. It is lost when the resource restarts, so always run /mowerexport before restarting — that writes everything to the exported_locations.lua file.

Create an Office

1. Start the Office

Stand where you want the manager NPC and run:

/mowerlocation My Office Name

This stores:

• office name
• NPC position
• NPC heading

2. Set the Vehicle Spawn

Stand where the van should spawn and run:

/mowervehicle

This stores:

• vehicleSpawn

The office is then saved into the current builder session.

Create a Yard

1. Start the Yard

Stand near the center of the work area and run:

/moweryard My Yard Name

This starts the yard and opens the visual editor.

2. Place Patches

Use patch mode to place grass props that the mower will cut.

3. Place Obstacles

Switch to obstacle mode and place props the player must remove on foot.

4. Save the Yard

Press Enter in the editor or use:

/mowerfinishyard

The yard must have at least one patch to save.

Visual Editor Controls

Placement Mode

Precision Mode

Session Management

Review Session Data

/mowerlist

This prints current session contents, including yard counts and calculated tiers.

Import Live Data Into the Session

/mowerimport

This loads the offices and yards currently live on the server into your session, so you can review them, remove them, or build alongside them.

Remove a Yard From the Session

/mowerremoveyard Exact Yard Name

Use the exact saved yard name.

Cancel Current Work

/mowercancel

This clears active office or yard setup state for the calling admin.

Export Workflow

Export

Run:

/mowerexport

What it does:

1. saves your in-progress office, if you have one
2. saves your in-progress yard, if it has at least one patch
3. merges in the offices and yards already live on the server, so nothing existing gets lost
4. writes everything to a file called exported_locations.lua in the resource folder
5. confirms in chat how many offices and yards were exported

Making Your Yards Live

Exporting does not change the live game by itself. The game keeps using whatever is in shared/config/locations.lua until you update it:

1. Open exported_locations.lua (in the oxide-landscapingjob folder on your server).
2. Copy its contents over the matching tables in shared/config/locations.lua.
3. Restart the resource. Your new yards are now live.

Practical Workflow

1. Create a new office with /mowerlocation and /mowervehicle.
2. Create one or more yards with /moweryard.
3. Save each yard.
4. Run /mowerlist to confirm counts and names.
5. Run /mowerexport.
6. Copy the contents of exported_locations.lua into shared/config/locations.lua.
7. Restart the resource so the new offices and yards go live.

Design Tips

• Keep vehicle spawns clear of traffic and parked vehicles.
• Use enough patches to make the yard readable, but avoid needless clutter.
• Mix patch models and headings so the yard does not look grid-placed.
• Place obstacles where players can reasonably reach them on foot.
• Test van access, mower unloading, and obstacle pickup before treating the yard as finished.
• Keep naming consistent because export deduplication uses exact names.

Next Steps

• ADMIN.md
• CONFIGURATION.md
• TROUBLESHOOTING.md