Tutorial / Settings

Armory

Weapons and perks players build custom classes from, unlocked for free, by level or with match credits earned in Game Modes matches.

What it does

The Armory is the equipment players build their own classes from, like Create-a-Class in Call of Duty. A class has a Primary, Secondary, Melee, Lethal and Tactical weapon and up to three perks. Game modes with Loadouts set to Players pick a loadout or one of their custom classes offer these classes on the loadout screen next to the admin's preset loadouts.

Every Armory item is free, unlocks at a level (Match stats) or is unlocked for good with match credits. Players earn match credits by playing matches that count (the same rule as Match stats): for finishing, for winning and per kill. What a player unlocked, their credits and their classes are kept per SteamID on every map.

Where to find it

Q menu > KGX's Admin Toolbox > Settings > Armory.

Players with Armory access (Settings > Player Access) see the credit settings and can give or take credits; only superadmins edit the items. Players open the Armory (the Create a Class screen) with:

  • !armory (also !classes) in chat,
  • F4 in the hub (between matches, World > Mode Spots hub) when a mode offers custom classes,
  • CREATE A CLASS (K) on a match's loadout screen,
  • the F3 hub's Loadouts tab (CREATE A CLASS / ARMORY),
  • a Talking NPC choice Open the Armory,
  • the console command kgxat_armory.

The panel

Match credits
Setting What it does Default
Credits a new player starts with kgxat_arena_credits_start 100
Credits for a match that counts kgxat_arena_credits_match 20
Extra credits for winning it kgxat_arena_credits_win 30
Credits per kill (25 kills at most) kgxat_arena_credits_kill; bots do not count 2
Custom classes per player kgxat_arena_classes, 1-10 5
Level needed for custom classes kgxat_arena_custom_level; 1 = everyone 1
Players list Players online and their credits. Pick one, set Amount, then Give credits to the selected player or Take credits from the selected player.

A match counts when it ends by its rules (not ended by an admin) with at least kgxat_stats_min_players players, like for Match stats. Players get credits when they played at least one round; the win bonus needs half of the rounds, as for Match stats. After it, every player gets a notice like "+52 match credits (300)". Players who never earned or spent any show the start amount and are not saved.

Items (superadmins)
Option What it does
Items list Item, Slot (or Perk), Unlock (Free, Level N, N credits), Modes (all, or the mode ids). Click one to edit it.
Kind Weapon or Perk.
Weapon class / Search weapons The weapon; double-click a weapon in the list to use it (its slot is guessed from the weapon).
Weapon slot Primary, Secondary, Melee, Lethal or Tactical.
Perk One of the perks below, or Buff at each spawn: <buff> (World > Create Buffs).
Name Shown name; empty = the weapon's or perk's own.
Unlock Free, At a level (with Level), With credits (for good) (with Price).
Only in these modes Mode ids, comma separated (tdm, ffa); empty = every mode. In other modes a class just leaves that item out.
Reserve ammo 0 = what the class gives.
Stat bars Damage, Fire rate, Range, Accuracy, Mobility, Control (0-100) shown on the loadout screen; 0 = read from the weapon. Useful for weapon packs whose numbers the toolbox cannot read.
Add a weapon item / Add a perk item / Remove the selected item Edit the list.
SAVE ARMORY Saves the items and sends them to everyone.
Put the default items back... HL2 weapons and every perk, some free, some by level, some for credits.
Perks
Perk What it does
Lightweight Move 10% faster.
Vitality 25 more maximum health.
Armor Plate Spawn with 50 more armor.
High Jump Jump 25% higher.
Flak Jacket Take 35% less damage from explosions.
Scavenger Each kill refills a magazine of the weapon in hand.
Fast Healing Heal 3 health a second after 4 seconds without damage.
Dead Silence Your footsteps make no sound.
Bandolier Twice the reserve ammo.
Buff at each spawn Any buff from World > Create Buffs (food, drink, status effect) applied at each spawn.

Perks only work in matches, while the class is used; they end when the match ends.

The Create a Class screen (players)

  • Left: your class slots (EMPTY SLOT = create one) and ARMORY (EVERYTHING). Top right: your credits and level.
  • Right: the class's name and its slots; the Primary card shows the weapon's stat bars. Click a slot to pick an item, right-click to empty it. v3.6.18.1: next to the slots, your character (your Q menu > Player Model with its skin, bodygroups and color) holds the class's primary weapon and turns slowly; drag it to turn it.
  • Picking: every item for that slot with its icon and OWNED / FREE / LEVEL N / N CREDITS; hover shows the stat bars or the perk. Click an owned item to put it in the slot; click a credits item to unlock it (asks first).
  • SAVE CLASS, DELETE CLASS, CLOSE / BACK (F3; while picking an item F3 goes back to the class first).

How to use it

Let players build their own classes
  1. Open Settings > Armory, check the items (or Put the default items back...) and press SAVE ARMORY.
  2. In Utilities > Game Modes, edit a mode: Loadouts = Armory (classes only) or Both (server loadouts and classes). Save the mode.
  3. Players play matches to earn credits, press F4 in the hub (or K on the loadout screen) and build a class.
  4. On the loadout screen their classes show with CUSTOM next to your preset loadouts.
Sell a weapon pack only in one mode
  1. Add the weapons as items with With credits (for good) and a price.
  2. Type the mode's id in Only in these modes.
  3. Set its stat bars if the loadout screen shows "No stats for this item."

Settings and commands

Command Who What it does
kgxat_armory, !armory, !classes Everyone Opens the Armory (Create a Class).
kgxat_credits <name or SteamID> [amount] Armory access, server console Shows a player's credits, or gives (negative takes) credits.

Tips and limits

  • Up to 200 items. Items are saved in data/kgx_admin_toolbox/armory.json; credits, unlocks and classes in armory_players.json.
  • An item keeps its id when you edit its name, price or unlock, so unlocks stay. Changing its weapon, perk or kind makes it a new item: what players bought of the old one does not pass to it. SAVE ARMORY refuses items that are not valid (no weapon class, a class with spaces) and names them.
  • Each perk can be in a class once, even if two items give the same perk. Perks never stack when a class is picked again. Removing an item empties that slot in players' classes; a class with no weapon left for a mode is not offered there.
  • The level is the Match stats level (Utilities > Game Modes > Match stats).
  • Classes never cost match money; paid loadouts (match money) are only the admin's preset loadouts.

Back to Settings

Type to search every tool, panel, setting, FAQ answer and release.