Tutorial / Tools > World

Item Spawner

Place markers that keep a weapon, ammo, health kit or any entity in place and bring it back after it is picked up.

What it does

An item spawner keeps one item on a spot. When someone picks it up, or it is removed, a new one appears after the respawn time.

The item can be any weapon from the spawn menu (or any weapon_ class) or a spawnable entity such as ammo or a health kit (or any item_ class). Toolbox entities, NPCs and props cannot be used; they have their own tools.

Item spawners are saved per map and come back after a restart or map cleanup.

Where to find it

Q menu > KGX's Admin Toolbox > World > Item Spawner.

Admins can use the tool, and players who are given it in Settings > Player Access. Players can only remove, update or switch their own spawners. Players are limited by kgxat_limit_itemspawners (Settings > Limits).

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 Place an item spawner where you aim
Right click Remove the aimed item spawner
Reload Update the aimed item spawner with the current settings
E + Reload Turn the aimed item spawner on or off

Right click and reload act on the nearest spawner within 96 units of where you aim.

The panel

The top line shows the current item, for example "Item: weapon weapon_smg1".

Option What it does Default
Search weapons and entities... Filters the list below by name, class or category.
Item list (Item, Type, Category) Weapons first, then entities. Click a row to pick it.
Class Type a class by hand, such as item_healthkit, item_battery, item_ammo_smg1 or weapon_ar2. weapon_smg1
Type Weapon or Entity (ammo, health kits, anything else). Weapon
Respawn after (s) Seconds until a taken item comes back, 1-600. 30
Hold the item still (frozen) until picked up Freezes the item in place. On
Reset to defaults Puts the options above back to their defaults.
Item spawners on this map

A list of every item spawner with the columns #, Item (name and respawn time, "[OFF]" when off) and Distance. Double-click a row to go there. Right-click a row for:

  • Go there
  • Rename...
  • Turn on / Turn off
  • Spawn the item now
  • Remove its item: the item comes back after Spawn the item now or a restart.
  • Copy position
  • Remove

Refresh reloads the list. Remove all item spawners on this map... removes every spawner after a confirmation. It cannot be undone.

How to use it

Place a weapon that respawns
  1. Pick a weapon in the list, for example the SMG.
  2. Set Respawn after (s), for example 5.
  3. Aim at the floor and left-click.
  4. Take the weapon. A new one appears after 5 seconds.
Place a health kit
  1. Type item_healthkit in Class and set Type to Entity (ammo, health kits, anything else).
  2. Left-click where the kit should be.
Change or pause a spawner
  1. Change the options in the panel, aim at the spawner and press reload. Its item is replaced.
  2. To pause it, hold E and press reload. Do it again to turn it back on.

Settings and commands

Setting What it does Default Range
kgxat_itemspawners Item spawners spawn their items (Settings > Gameplay, Item spawners give out items (World > Item Spawner)). 1 0-1
kgxat_limit_itemspawners Max item spawners for non-admin players (0 = not allowed). 2 0-64

Tips and limits

  • A weapon counts as taken once a player holds it. Other items count as taken when they are gone.
  • The first item appears about 1 second after the spawner is placed.
  • If an item cannot be created, the spawner tries again after at least 30 seconds.
  • Spawners are saved in itemspawners_<map>.json, one file per map.
  • Generate Loot can also place item spawners in bulk; those count toward the 64 per map that Generate Loot allows.
  • Logic nodes can turn item spawners on or off or spawn the item now.

Back to Tools

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