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
- Open Settings > Armory, check the items (or Put the default items back...) and press SAVE ARMORY.
- In Utilities > Game Modes, edit a mode: Loadouts = Armory (classes only) or Both (server loadouts and classes). Save the mode.
- Players play matches to earn credits, press F4 in the hub (or K on the loadout screen) and build a class.
- On the loadout screen their classes show with CUSTOM next to your preset loadouts.
Sell a weapon pack only in one mode
- Add the weapons as items with With credits (for good) and a price.
- Type the mode's id in Only in these modes.
- 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 inarmory_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.