Tutorial / Tools > Properties
Decals
Blood, scorch marks, paint splats, graffiti and any decal material; size and color.
What it does
Decals sprays a decal where you aim. You can use a game decal (Blood, Scorch, paint splats, impacts and more) or any material under materials/decals, such as graffiti, cracks or signs.
Decal materials take the size and color you set. Game decals keep their own look. You can scatter several decals with one click, or hold the mouse button to spray a stream.
Every player sees the decals. Admins can keep them for the map, so they come back after a cleanup and show for players who join later.
Where to find it
Q menu > KGX's Admin Toolbox > Properties > Decals.
Admin only by default. Superadmins can give it to players or ranks in Settings > Player Access. Players given the tool can only place decals while kgxat_decals_players is on.
Given to a player (v3.6.11.3): On the world and their own things; not kept.
Controls
| Key | What it does |
|---|---|
| Left click | Place the decal (hold for a stream when "Hold to spray" is on) |
| Right click | Pick a decal |
| Reload | Admins: remove kept decals near the aim (everyone's decals are redrawn) |
The HUD under the crosshair shows the current decal.
Options
| Option | What it does | Default | Range |
|---|---|---|---|
| Decal (name, or m:<material>) | The decal to place: a game decal name, or m: and a material path |
Blood | - |
| Pick a decal... | Opens the decal picker (same as right-click) | - | - |
| Width | Width of a decal material | 1 | 0.05-16 |
| Height | Height of a decal material | 1 | 0.05-16 |
| Color mixer | Color and alpha of a decal material | 255 255 255 255 | alpha 10-255 |
| How many at once (scatter) | Decals placed per click | 1 | 1-30 |
| Scatter spread | How far scattered decals land from the aim point | 32 | 0-512 |
| Hold to spray (a stream while left click is held) | Keeps placing decals while you hold left click | Off | - |
| Keep for this map (admins: back after a cleanup and for players who join) | Saves the decals you place (admins only) | Off | - |
| Reset to defaults | Puts every option back to the defaults | - | - |
Server settings in the panel
Admins see three server settings in the tool panel. Only superadmins can change them. The checkbox applies at once; the sliders need Apply.
| Option | Setting | Default | Range |
|---|---|---|---|
| Players given this tool may place decals | kgxat_decals_players |
1 | 0-1 |
| Players: decals per second | kgxat_decals_rate |
4 | 1-30 |
| Most decals kept for one map | kgxat_decals_kept_max |
500 | 10-3000 |
The decal picker
Right-click, or click Pick a decal..., to open the Pick a decal window. Game decals are listed first, then the materials found under materials/decals, grouped by folder in the Kind column.
Type in the search box (blood, scorch, paint, graffiti...) to filter the list. Selecting a material shows a preview. Double-click a row, or select it and click Use selected (or double-click).
How to use it
Splatter blood
- Right-click and pick Blood.
- Set How many at once to 5 and Scatter spread to 64.
- Aim at a wall or floor and left-click.
Spray colored graffiti
- Right-click, search for a graffiti material and double-click it.
- Pick a color and set Width and Height, for example 3.
- Tick Hold to spray if you want a stream, then left-click.
Decorate the map for good (admins)
- Tick Keep for this map.
- Place your decals.
- They come back after a map cleanup and appear for players who join.
Remove kept decals
- Aim near the decals you want gone and press reload.
- Kept decals near the aim point are deleted. Everyone's decals are cleared and the remaining kept ones are redrawn.
Settings and commands
| Command | What it does |
|---|---|
kgxat_decals_clear |
Clears decals for everyone; kept ones are drawn again (admins) |
kgxat_decals_clear all |
Clears every decal and forgets the kept ones too (admins) |
Kept decals are saved in data/kgx_admin_toolbox/decals_<map>.json.
Tips and limits
- Players are limited to 5 decals per click and a size of 4. Their decals are never kept.
- Admins can place up to 30 per click with a size up to 16.
- While holding to spray, admins place a decal every 0.05 s and players every 0.25 s.
- When the kept list is full, the oldest decals are dropped first.
- Decals disappear for a player who clears decals on their side (
r_cleardecals).