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
- Pick a weapon in the list, for example the SMG.
- Set Respawn after (s), for example 5.
- Aim at the floor and left-click.
- Take the weapon. A new one appears after 5 seconds.
Place a health kit
- Type
item_healthkitin Class and set Type to Entity (ammo, health kits, anything else). - Left-click where the kit should be.
Change or pause a spawner
- Change the options in the panel, aim at the spawner and press reload. Its item is replaced.
- 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.