Tutorial / Settings
Gameplay
Pick the server mode (Sandbox, Build / PvP or RP) and set the RP rules, movement, poop by a timer, citizens, Build/PvP, anti prop-kill and death screen.
What it does
Gameplay is where you choose how the whole server plays. The Server mode box switches between Sandbox, Build / PvP and RP. The rest of the page sets the rules that go with each mode.
It also holds movement speeds, players pooping by themselves on a timer (and what E on a poop does), the citizen rank and spawn weapons, anti prop-kill, the death screen and kill cam, and the on/off switches for item spawners and vehicle pads.
While DarkRP runs, RP mode uses DarkRP's own jobs, doors and rules instead of the toolbox's.
Where to find it
Q menu > KGX's Admin Toolbox > Settings > Gameplay.
Anyone can open the page, but only superadmins can change the settings. The controls are greyed out for everyone else. The last checkbox, Show my Build/PvP mode, is a personal setting every player can change.
Players switch between Build and PvP with the chat commands !build, !pvp and !mode. Anyone can see the current server mode with !servermode.
The panel
Checkboxes and the three drop-down boxes apply as soon as you change them. Sliders only apply when you click Apply the numbers above near the bottom of the page.
Server mode
| Option | What it does | Default |
|---|---|---|
| Server mode | Sandbox (no modes): plain sandbox with no Build/PvP, jobs or property. Build / PvP: players pick Build or PvP mode. RP (jobs, property, RP rules): jobs (F4), property and the RP rules below. | Build / PvP |
RP mode
| Option | What it does | Default |
|---|---|---|
| Only admins can noclip | In RP mode, only toolbox admins can noclip. Players already flying are put back on their feet. | On |
| Players can only spawn props (no weapons, entities, NPCs or vehicles from the spawn menu) | In RP mode, players can only spawn props. Keys, Pockets and Hands can still be taken. Admins can spawn anything. | On |
| Jobs (Settings > Jobs, F4) | Turns the toolbox job system on in RP mode. | On |
| Job equip (taking a job) | How a player taking a job (or given one) gets its gear. Dissolve: they die dissolving and respawn where they stood (or at the job's spawn). Instant death: the same, the body falls. Instant loadout (Loadout / RP): they respawn in place without dying. Off: the job's weapons are given at once, no respawn. The death takes nothing: no money, backpack or pocket drop, no death count, death screen, kill cam, kill feed or damage log entry. Weapons bought before come back. | Dissolve |
| Property can be bought and rented (World > Property) | Turns property buying and renting on in RP mode. | On |
| Most properties per player | How many properties one player may own or rent. | 2 (1-20) |
| Buying or renting property needs a Property License (sold at stores: item type Property License) | Players need a Property License to buy or rent. | On |
| Players carrying Keys can use the Door Maker on their own props | Key holders can turn their own props into doors with the Door Maker. | On |
Movement (every player; 0 = the gamemode's own)
| Option | What it does | Default |
|---|---|---|
| Walk speed (Sandbox 200) | Walk speed of every player. | 0 (0-1000) |
| Run speed (Sandbox 400) | Run speed of every player. | 0 (0-2000) |
| Slow walk speed, Alt (Sandbox 100) | Slow walk (Alt) speed of every player. | 0 (0-1000) |
Set after every spawn and at once when changed, for every player whose speed nothing else changed meanwhile. Player Loadouts and game mode roles set their own speeds; buffs, boosts and handcuffs change it for a while. Back to 0: the gamemode's own speed from the next spawn. Press Apply the numbers above.
Poop
| Option | What it does | Default |
|---|---|---|
| Players poop by themselves now and then (timer) | Every player (or only Hobo jobs, below) drops a poop behind them at a random time between the two times below. | Off |
| Who poops by themselves | Every player, or only those who may use Poop (Hobo jobs and admins while Police & Crime limits Poop to hobos). | Every player |
| Shortest time between two poops (seconds) | 300 (10-7200) | |
| Longest time between two poops (seconds) | 600 (10-7200) | |
| Warn the player 5 seconds before (a rumble) | A sound and "Your stomach rumbles... you need to go." | On |
| Seconds a poop stays on the ground | Every poop (by the timer, dropped or thrown). Was always 60 before v3.6.12.1. | 60 (5-3600) |
| Most poops on the ground on the map (oldest goes first) | A cap for the whole map. | 40 (1-500) |
| E on a poop | Everyone chooses (Eat it / Pick it up / Pick it up and hold it / Leave it), only those who may use Poop choose (everyone else eats it), or Eat it (no choice, as before). | Everyone chooses |
| Most poop carried by players with the Poop weapon (job) | Players whose job (or an admin) gave them the Poop weapon carry up to this many picked-up poops. Everyone else carries one at a time. | 3 (1-20) |
Nobody pooping is skipped while dead, in a vehicle or seat, noclipping, spectating, ragdolled or in a black box jail; they go when that ends.
A poop on the ground cannot be thrown: E does not carry it, Pockets do not take it, the gravity gun does not pick it up or punt it, and only toolbox admins move it with the physics gun. Pick it up puts it in the Poop weapon (given if the player has none) without switching to it; Pick it up and hold it also switches to it. Then left click throws it and right click drops it. A Poop weapon that only came from picking poop up is gone with the last poop. Players with their own Poop weapon throw their picked-up poop first (no wait), then their own as before.
Press Apply the numbers above after changing the sliders. Who may use the Poop weapon, its wait and being sick: Settings > Police & Crime.
Citizens
| Option | What it does | Default |
|---|---|---|
| Citizens | Off, In RP mode or In every mode. New players with the rank user get the citizen rank and the citizen weapons. |
In RP mode |
| Citizen rank text box + Apply | The rank new players get. With ULX or SAM it is created if missing (inheriting from user). An admin rank is refused. | citizen |
| Citizens spawn with text box + Apply | Weapon classes, comma separated. In RP mode everyone without a job gets these. | kgxat_hands |
Build / PvP mode
| Option | What it does | Default |
|---|---|---|
| New players start in Build mode | Players join in Build mode instead of PvP mode. | Off |
| Build mode players may noclip, PvP players may not (admins always may) | Ties noclip to Build mode. | On |
| Seconds between switches | Cooldown between a player's own switches. | 10 (0-300) |
| Seconds after a fight before Build mode is allowed | Stops players escaping a fight by switching to Build. | 15 (0-120) |
Anti prop-kill
| Option | What it does | Default |
|---|---|---|
| Anti prop-kill on | Master switch for the two options below and the speed cap. | On |
| Props held with the physgun pass through players (solid again once nobody is inside) | Held props do not collide with players. | On |
| Props cannot crush players | Thrown or pushed props deal no crush damage to players. | On |
| Fastest throw for non-admins (0 = no limit) | Speed cap on physgun throws. | 0 (0-5000) |
Deaths: death screen and kill cam
| Option | What it does | Default |
|---|---|---|
| Death screen: killer, weapon, distance, headshot, the killer's health left, the damage you took | Shows players how they died. | On |
| The death screen names the killer (off: weapon and distance only) | Hides the killer's name when off. | On |
| Kill cam | Off, Killer's view (live), Replay of the last seconds, or Killer's view, then the replay. | Killer's view, then the replay |
| Kill cam in RP mode too (it shows where the killer is) | The kill cam is off in RP mode unless this is ticked. | Off |
| Seconds of the killer's live view | Length of the live view. | 4 (1-10) |
| Seconds the replay goes back | Length of the replay. | 5 (2-8) |
World
| Option | What it does | Default |
|---|---|---|
| Item spawners give out items (World > Item Spawner) | Turns all item spawners on or off. | On |
| Vehicle pads give out vehicles (Economy > Vehicle Pad) | Turns all vehicle pads on or off. | On |
| Apply the numbers above | Sends every slider on the page to the server. |
Your own HUD
| Option | What it does | Default |
|---|---|---|
| Show my Build/PvP mode | Shows BUILD MODE or PVP MODE on your HUD. Client setting kgxat_build_hud. |
On |
How to use it
Run an RP server
- Open Settings > Gameplay as a superadmin.
- Set Server mode to RP (jobs, property, RP rules). Every player is told the new mode.
- Tick or untick Only admins can noclip and Players can only spawn props to taste.
- Set Citizens to In RP mode, then type the weapons citizens get in Citizens spawn with and click Apply.
- Set up jobs in Settings > Jobs and property in World > Property.
Run a Build / PvP server
- Set Server mode to Build / PvP. Everyone is put back into the default mode.
- Tick New players start in Build mode if builders should be the default.
- Move Seconds between switches and Seconds after a fight before Build mode is allowed, then click Apply the numbers above.
- Tell players to type
!buildor!pvp. Builders get a blue BUILD tag above their head.
Put a player in Build or PvP mode yourself
- Open the player's menu in the Player Manager.
- Click Put in Build mode or Put in PvP mode. No cooldown applies.
Settings and commands
| Setting or command | What it does | Default | Range |
|---|---|---|---|
kgxat_playmode |
0 = Sandbox, 1 = Build / PvP, 2 = RP | 1 | 0-2 |
kgxat_rp_noclip |
Only admins noclip in RP mode | 1 | 0-1 |
kgxat_rp_props_only |
Players spawn only props in RP mode | 1 | 0-1 |
kgxat_jobs |
Jobs in RP mode | 1 | 0-1 |
kgxat_job_equip |
Taking a job: 3 = dissolve, 2 = instant death, 1 = instant loadout, 0 = off | 3 | 0-3 |
kgxat_walk_speed |
Walk speed of every player (0 = gamemode) | 0 | 0-1000 |
kgxat_run_speed |
Run speed of every player (0 = gamemode) | 0 | 0-2000 |
kgxat_slowwalk_speed |
Slow walk speed of every player (0 = gamemode) | 0 | 0-1000 |
kgxat_auto_poop |
Players poop by themselves on a timer | 0 | 0-1 |
kgxat_auto_poop_who |
0 = every player, 1 = only those who may use Poop | 0 | 0-1 |
kgxat_auto_poop_min, kgxat_auto_poop_max |
Shortest / longest seconds between two poops | 300 / 600 | 10-7200 |
kgxat_auto_poop_warn |
Warn 5 seconds before | 1 | 0-1 |
kgxat_poop_life |
Seconds a poop stays on the ground | 60 | 5-3600 |
kgxat_poop_ground_max |
Most poops on the map | 40 | 1-500 |
kgxat_poop_pickup |
E on a poop: 0 = eat it, 1 = everyone chooses, 2 = only those who may use Poop choose | 1 | 0-2 |
kgxat_poop_carry |
Most picked-up poop for players with their own Poop weapon | 3 | 1-20 |
kgxat_property |
Property in RP mode | 1 | 0-1 |
kgxat_property_max |
Properties per player | 2 | 1-20 |
kgxat_property_license |
Property needs a license | 1 | 0-1 |
kgxat_keys_doormaker |
Key holders may use the Door Maker | 1 | 0-1 |
kgxat_citizens |
0 = off, 1 = RP mode, 2 = always | 1 | 0-2 |
kgxat_citizen_rank |
Citizen rank name | citizen |
text |
kgxat_citizen_weapons |
Citizen spawn weapons | kgxat_hands |
text |
kgxat_build_default |
Start in Build mode | 0 | 0-1 |
kgxat_build_noclip |
Builders may noclip | 1 | 0-1 |
kgxat_build_cooldown |
Seconds between switches | 10 | 0-300 |
kgxat_build_combat |
Seconds after a fight | 15 | 0-120 |
kgxat_apk, kgxat_apk_ghost, kgxat_apk_nodamage |
Anti prop-kill switches | 1 | 0-1 |
kgxat_apk_maxspeed |
Throw speed cap | 0 | 0-5000 |
kgxat_deathscreen, kgxat_deathscreen_killer |
Death screen switches | 1 | 0-1 |
kgxat_killcam |
0 off, 1 live, 2 replay, 3 both | 3 | 0-3 |
kgxat_killcam_rp |
Kill cam in RP mode | 0 | 0-1 |
kgxat_killcam_time |
Live view seconds | 4 | 1-10 |
kgxat_killcam_replay |
Replay seconds | 5 | 2-8 |
kgxat_itemspawners, kgxat_vehiclepads |
World switches | 1 | 0-1 |
!build, !pvp, !mode |
Players: switch to Build, to PvP, or toggle | ||
kgxat_build [0/1] |
Console version of the above (no number = toggle) | ||
!servermode |
Shows the current server mode |
Tips and limits
- Build mode players cannot hurt players and cannot be hurt by players, their props or their vehicles. NPCs and the world still hurt them.
- Players cannot switch to Build mode while jailed or during a Game Modes match.
- Leaving Build mode ends a player's noclip (admins keep theirs).
- The citizen rank and weapons text boxes only accept letters, numbers,
_,-(and commas, spaces and dots for weapons). - Admins and other ranks are not changed by the Citizens setting. Outside RP mode, a Settings > Player Loadouts entry for the citizen rank wins over the citizen weapons.
- During a kill cam, E changes the view (killer, victim, overview). Respawning ends it. Admins can replay any of the last 60 kills from Utilities > Damage Log (right-click a kill).
- Typed slider values stay unsent until you click Apply the numbers above.