Tutorial / Tools > Functions
Keys
Lock and unlock any door, and set who owns a door and who has keys.
What it does
Keys is the admin side of the toolbox key system. It locks and unlocks any door, including map doors, and the vehicles players spawned. It can also freeze a door so it cannot open or close, or force a door open or closed even when locked.
For Door Maker doors, it opens the owner and key menu. There you set the owner and give or take keys. For property doors, it opens the property window.
The panel also holds the Keys settings, buttons to open or close every door at once, and saved lock states for all map doors.
Where to find it
Q menu > KGX's Admin Toolbox > Functions > Keys.
Admin only by default. Superadmins can give it to players or ranks in Settings > Player Access. The Settings (superadmins) checkboxes in the panel can only be changed by superadmins. Only superadmins lock or unlock server property.
Players carry the Keys weapon, and admins also Admin Keys (spawn menu: Weapons > ATB). Utilities > Player Manager: right-click a player for Give Keys, Give Admin Keys and Take their keys.
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 | Lock, freeze or open the aimed door, by mode (doors and vehicles) |
| Right click | Unlock, unfreeze or close the aimed door, by mode |
| Reload | Next mode: Lock / Unlock, Freeze / Unfreeze, Open / Close |
| E + Reload | Owner and key menu (Door Maker doors) or property window |
The HUD shows the current mode and the aimed door's status, with FROZEN when the door is frozen.
The panel
Mode
| Option | What it does | Default |
|---|---|---|
| Tool mode (reload cycles it) | Lock / Unlock, Freeze / Unfreeze (the door cannot open or close) or Open / Close (even when locked or frozen) | Lock / Unlock |
Settings (superadmins)
| Option | What it does | Default |
|---|---|---|
| Players spawn with Keys (off while DarkRP runs, which has its own) | Hands out Keys on spawn | On |
| Admins also spawn with Admin Keys | Admins also get Admin Keys | On |
| Keys knock on doors they do not fit | Knock instead of nothing | On |
| Keys lock and unlock the player's own vehicles (not seats or chairs) | Keys work on vehicles | On |
| Freeze every door: nobody opens or closes doors (the buttons below still work) | Freezes all doors | Off |
Open / close doors now (locked ones too; locks stay)
Three pairs of buttons: Open every door / Close every door, Open doors that are not bought / Close doors that are not bought, and Open bought doors only / Close bought doors only.
All map doors (saved for this map)
A status line shows the current mode and how many single doors are saved.
| Button | What it does |
|---|---|
| Lock every map door (not bought) | Locks all map doors and saves it for this map |
| Unlock every map door (not bought) | Unlocks all map doors and saves it |
| Put back the map's own locks | Returns to the map's own lock states |
Get keys
| Button | What it does |
|---|---|
| Give me Keys | Gives you the Keys weapon |
| Give me Admin Keys | Gives you Admin Keys (admins) |
| Give everyone the keys they should have | Hands out keys to every player |
The owner and key menu
E + Reload on a Door Maker door opens a window titled with the door's owner.
- Lock the door / Unlock the door.
- A keys list. Right-click a name > Take the key back.
- Give a key to... picks a player.
- Give the door up (no owner), shown to the owner.
- Admin: Make someone the owner... and No owner (clears keys and lock).
How to use it
Lock a map door
- Aim at the door. Make sure the HUD shows Lock / Unlock.
- Left-click to lock, right-click to unlock. The single door's state is saved for this map.
Stop a door from moving
- Press Reload until the mode is Freeze / Unfreeze.
- Left-click the door. It stays as it is. Right-click to unfreeze.
Change who owns a Door Maker door
- Aim at the door and press E + Reload.
- Click Make someone the owner... and pick a player.
- Use Give a key to... for anyone else who should open it.
Settings and commands
| Setting or command | What it does | Default / range |
|---|---|---|
kgxat_keys |
Players spawn with Keys | 1, 0 or 1 |
kgxat_keys_admin |
Admins also spawn with Admin Keys | 1, 0 or 1 |
kgxat_keys_knock |
Keys knock on doors they do not fit | 1, 0 or 1 |
kgxat_keys_vehicles |
Keys lock the player's own vehicles | 1, 0 or 1 |
kgxat_doors_frozen |
Every door is frozen | 0, 0 or 1 |
kgxat_doors open|close all|unbought|bought |
Open or close doors now | - |
kgxat_mapdoors lock|unlock|default |
Saved lock mode for all map doors | - |
kgxat_givekeys [admin|all] |
Give yourself Keys, Admin Keys, or everyone their keys | - |
Tips and limits
- Lock / Unlock works on map doors, property doors, Door Maker doors and vehicles (not seats). Freeze and Open / Close work on doors only.
- A single map door locked with this tool or Admin Keys is saved and wins over the all-doors setting. The three map door buttons clear those.
- Map door locks are put back after cleanups and restarts. Doors of a bought property are left alone. Lockpicked doors are not saved.
- A locked Door Maker door opens with E only for its owner, key holders and admins. Buttons and keypads still open it.
func_dooralso covers some lifts and gates. A locked one does not move.- Keys cannot be dropped or put in storage.