Tutorial / Tools > World

Generate Map Props

Props all over the map (nav mesh): junk, crates, street things, debris...

What it does

Generate Map Props scatters props over an area, or the whole map, in one run. It picks walkable spots from the map's nav mesh around where you aim. Each prop stands on the ground and is turned at random.

You choose a prop set or your own model list. Props can be frozen, permanent, saved by GMod persistence or unbreakable. You see the spots first, then confirm.

Every run is listed in the panel and can be removed again, also after a restart.

Where to find it

Q menu > KGX's Admin Toolbox > World > Generate Map Props.

Superadmins only. Other players get "Only superadmins can generate." The map needs a nav mesh: make one in the AI > AI Paths panel, or with nav_generate.

Admins only (v3.6.11.3): this tool sets up the server, so it cannot be given to players; it is greyed out in Settings > Player Access.

Controls

Key What it does
Left click Preview spots around where you aim
Right click Make the previewed props
Reload Remove the last run (the newest props run on this map)

The panel

Option What it does Default
Props Junk and trash, Crates and barrels, Street (bins, cones, barriers, benches), Debris and rocks, Office and home or My own list (below). Junk and trash
My own list (models, comma separated) Your models, used when Props is My own list. Empty
Scan map props (pick one the map uses) Lists models the map uses. Pick several to add them to My own list and switch Props to it.
Frozen (off: they can be pushed around) Freeze each prop. On
Permanent (Permanent Props: back after every restart and cleanup) Make them permanent props. Off
GMod persistence (sbox_persist; saved by the game itself) Mark them persistent. Off
Unbreakable They cannot be broken. Off
Where
Option What it does Default
Around where you aim, radius (0 = the whole map) Search radius, 0-20000. 2000
How many Spots to find, 1 up to kgxat_gen_max. 30
At least this far apart Minimum distance between spots, 32-2000. 150
At least this far from spawn points 0-3000. 400
Inside / outside Both, Inside only (a roof above) or Outside only (open sky). Both
Not inside zones (World > Zones) Skip spots inside zones. On

Cancel the preview clears the marked spots without making anything.

Runs

A list of every run on this map with the columns When, What and # (how many were made). Right-click a run and pick Remove what this run made. Remove everything ever generated (both tools) removes all props, containers and item spawners that Generate Map Props and Generate Loot made on this map. Refresh reloads the list. Below it you see the nav mesh state: loaded, generating or none.

Safety (superadmins)
Option What it does Default
Most things one run makes (kgxat_gen_max) Cap per run, 1-2000. Click Apply the number above to save it. 300
Back up the data files before each run (data/kgx_admin_toolbox/backups/) (kgxat_gen_backup) Copies the map's permanent props file before a run. On

How to use it

Scatter junk around a street
  1. Set Props to Junk and trash.
  2. Set the radius to 1500 and How many to 30.
  3. Aim at the street and left-click. The spots are marked and nothing is made yet.
  4. Right-click to make the props. They are made a few at a time.
Make props that survive restarts
  1. Tick Permanent and, if you want, Unbreakable.
  2. Left-click to preview, then right-click to make them.
  3. After a restart or cleanup they are back. Remove them from the Runs list when you no longer want them.
Use the map's own models
  1. Click Scan map props (pick one the map uses).
  2. Select several models and click Use the selected. They are added to My own list, and Props switches to it.
  3. Preview and make as usual.

Settings and commands

Setting What it does Default Range
kgxat_gen_max Most things one Generate Loot / Generate Map Props run makes. 300 1-2000
kgxat_gen_backup Back up the data files before generating. 1 0-1

Tips and limits

  • Props that are not permanent are owned by you and gone after a restart. Undo does not remove them; use reload or the Runs list.
  • Models this server does not have are skipped. At most 64 models of a list are used.
  • Keep My own list short. Tool settings over about 250 characters can be cut short by the game.
  • A preview expires after 5 minutes. Right click without a preview says "Make a preview first (left click)."
  • Spots are never on or near players, spawn points or jails, and only where the prop fits.
  • If the area is small, crowded or the spacing is large, fewer spots are found and you are told how many.
  • Only one run can work at a time. The run list keeps the 100 newest runs per map.

Back to Tools

Type to search every tool, panel, setting, FAQ answer and release.