Tutorial / Settings
Player Access
Pick which toolbox tools and panels non-admin players may use, for all players or for one rank such as VIP.
What it does
Player Access lets non-admin players use toolbox tools and panels. You tick an entry for all non-admin players, or for one rank. A player can use something when it is ticked for all players or for their rank.
Admins can always use everything, so admin and superadmin are not in the rank list. Panels are ticked separately from tools, so giving a tool never opens an admin panel.
With rank immunity on (Server Settings), players can never target admins with these tools.
What a tool does for a player (v3.6.11.3)
A tool given to a player is the same tool with restrictions; the orange line under each tool in the panel says which.
- Building, property and appearance tools work on the player's own things only (their props, doors, NPCs and saved records; a buddy's with the built-in prop protection, or what FPP or another CPPI addon lets them touch). Never on other players' things, the map's own entities, or permanent and server-owned things, whether prop protection is on or off. Options that make server-owned or hidden things (server cameras, keypads, signs, doors...) stay for admins.
- Player tools (Cheats, Fun, Functions) work on the player themselves. With Players given tools may use the player tools on other players near them ticked (
kgxat_grant_others), they also work on other players within the reach set in Settings > Limits ("Reach of player tools on other players", 1000 units), never on anyone ranked above the player. - Server setup tools cannot be given to players: Map Gate, Remove Map Props, Mode Spots, Permanent Entities, Property, Spawn Points, the Keys tool, Item Spawner, NPC Spawner, AI Paths, Patrol & Guard (and the superadmin generators and vault). They are greyed out.
- "Go there" in the tool lists is for admins, and nothing a player does with a tool hands out free money, weapons or items beyond what the gamemode allows. The ticks are saved on the server in
data/kgx_admin_toolbox/access.jsonand apply on every map. By default nothing is ticked.
Where to find it
Q menu > KGX's Admin Toolbox > Settings > Player Access.
Only superadmins can change player access. Everyone else sees the checkboxes greyed out, with the line "Only superadmins can change player access." The server also refuses changes from anyone who is not a superadmin. With a server owner set (v3.6.12, kgxat_owner add <SteamID> in the server console), only owners can change player access; see Settings > Permission Report.
The panel
| Option | What it does |
|---|---|
| Applies to | Which group the ticks below are for: All non-admin players, or Rank: <name> for one rank. Switching it shows that group's ticks. |
| Refresh rank list | Fills Applies to again. |
| Tool and panel checkboxes | One per toolbox tool and per access panel, grouped under headings: Cheats, Fun, Functions, Building, World, Properties, Utilities. Panels end in "(panel)" and are listed under Utilities. Each tick is saved as soon as you click it. |
| Allow everything (for the selection above) | Ticks every tool and panel for the selected group, after a Yes / No question. |
| Untick everything (for the selection above) | Unticks every tool and panel for the selected group. |
The rank list holds "user", the ranks your admin mod and the toolbox know, ranks that already have ticks, and the ranks of players online.
Panels you can open to players
| Checkbox |
|---|
| Player Manager (panel) |
| Server Tools (incl. time scale / gravity) (panel) |
| Announcements (panel) |
| Action Log (panel) |
| Admin Vision (panel) |
| Entities (status, counts, bulk remove) (panel) |
| Auto Messages (panel) |
| Rules (edit) (panel) |
| Reports (read and resolve) (panel) |
| Maps (change / restart map) (panel) |
| Event Countdown (panel) |
| Bans (view, add, unban) (panel) |
| Chat Filter (panel) |
| Events (teams, arena, rounds) (panel) |
| Voting (panel) |
| Economy (money of every player, stores list) (panel) |
| Storage (containers list, loot tables) (panel) |
| Damage Log (panel) |
| Sit Room (panel) |
| Admin Notes (panel) |
| Day/Night & Weather (panel) |
Tools that unlock more
Some tool ticks hand out more than the tool. The panel shows this as an orange line under the checkbox, and as its tooltip.
| Tool | Also unlocks |
|---|---|
| Property | evict, remove, rename and price EVERY property; reset all doors |
| Store Maker | their own stores, and update every store on the map from its preset |
| Keys | Admin Keys, open/close/lock every map door, change door owners |
| Money Printer | printer debug window: break, repair, remove ANY printer, set the main printer |
| Money Generator | add, fill, empty and remove every money source |
| Jail | jail locations' settings, pick where players are jailed |
| Warp Points | create, rename, delete warps and go to any warp |
| Teleporters | the teleporter list: go to any teleporter |
| Unbreakable | make every map door (un)breakable |
| Physgun Block | block or unblock every physics prop of the map at once |
| Test Dummy | spawn and control Test Dummies (real player slots) |
| Spectate | spectate any player they may target |
| Map Gate | edit map gates, which can change the map for everyone |
| Create Storage | their own containers; read the loot tables |
| Talking NPC | their own talking NPCs; load presets |
| Logic | their own logic nodes only (up to their logic limit); wired to their own doors, nodes and spawners |
How to use it
Let every player use one tool
- Open Q menu > KGX's Admin Toolbox > Settings > Player Access as a superadmin.
- Leave Applies to on All non-admin players.
- Tick the tool, for example God Mode. It is saved at once.
- As a non-admin, God Mode now works; other tools and panels are still refused.
Give a rank extra tools
- In Applies to, pick Rank: <name>, for example
Rank: vip. If the rank is missing, press Refresh rank list. - Tick the tools and panels that rank should have.
- Players of that rank can use them; players of other ranks cannot (unless ticked for all players).
Take everything away from a group
- Pick the group in Applies to.
- Press Untick everything (for the selection above).
Tips and limits
- Players given a tool here are "limited players": Settings > Limits applies to them, along with the value caps and the tool cooldown (Server Settings).
- A tool hidden from a player in Settings > Tool Visibility cannot be used, even when it is ticked here.
- A license can also give tools: Settings > Licenses (Tool License). Its holders use those tools like a Player Access tick.
- Allow everything also ticks the tools in the table above. Read the orange lines first.
- A rank with nothing ticked is removed from the saved file.
- Reset everything / wipe map data... in Server Settings can untick everything for players and ranks.