Skip to content
GrindhouseDocs

Arena builder

Build your own gunfight arena, on the map in your browser or in game with .build: your spawn, the bots and what each one does, stages, how it's won. Save it, play it, share it on the Community hub.

On the mapLibrary → Arenas → New arena
In game.build [name], then .ab commands
Limits5 stages, 10 bots a stage, 20 in all
SavedPer map, 50 arenas a map
PlanPro

An arena is one fight you design: where you start and which way you face, your side and your gun, a difficulty, how it's won, and one to five stages of bots. Each bot has a spot, a view, a gun and one thing it does: hold an angle, hunt you, roam a path or peek. Both editors make the same arena, so you can lay one out on the map and fine-tune it in game, or the other way round. Play it as Custom arenas.

On the map

The arena builder in your browser needs no server: you place everything on the map's radar and save it to your Library.

The arena builder on Mirage: the radar filling the page with your spawn as an orange marker and its view, numbered red bots with their facing knobs, a peek bot joined to its diamond, a roam bot's dashed path, the tools Spawn, Add bot, Undo and Redo along the map's bottom, the stage chips above it, and the side panel with the arena's name, side, gun, how it's won, difficulty and its bots by stage
The arena builder: the map with its tools, the arena (or the bot you picked) on the right.
  1. Open it

    New arena in Library → Arenas (or on Play → Custom arenas) opens a new arena on that map. Edit on the map in an arena's ⋯ menu opens it.

  2. Your spawn

    Click the map where you start. The orange marker is you, the wedge is where you look: drag the marker to move it and its knob to turn, or press Spawn in the tools along the bottom of the map and click somewhere else. Its height comes from the map's floors.

  3. Add bots

    Add bot in the map's tools, then click where it stands: a bot that holds its angle, facing your spawn. Drag the red disc to move it and its white knob to where it looks. Esc cancels (on a phone or tablet, tap Add bot again).

  4. Say what each bot does

    Click a bot (on the map or in the list) and pick Hold, Hunt, Roam or Peek. A peek bot gets a dashed diamond: drag it to where the bot peeks out to. A roam bot needs a path: click the map to add its points (Add points / Done), drag them, double-click one to take it out.

  5. More stages

    + Stage adds the next stage: its bots come once the stage before is cleared. The chips above the map switch between them, each with its number of bots (Stage 1 with a 4 has four); the other stages' bots show faintly.

  6. Save, then Play

    Save keeps it in your Library; then the button reads Play and starts your server with it. Edit in game opens it in the in-game builder.

The arena

With no bot picked, the panel is the arena's:

Name
The panel's title: click it to type. 48 characters at most. Never named: "Arena 3".
Side and Gun
Your side, CT or T (the bots are the other side), and your gun. A run only counts with that gun.
Win when
Kill all, Beat the clock or Survive, with 5 to 300 seconds for the last two. See How it's won.
Difficulty
Easy, Normal, Hard or Expert: the bots' reaction time, aim, jiggles and bursts, for everyone who plays it.
Full health between stages
On by default: full health and a full magazine when the next stage starts.
Bots
Every bot, by stage when there are several, with what it does and its gun. Click one to edit it.

A bot

The arena builder with Bot 2 picked: Peek picked from Hold, Hunt, Roam and Peek, its gun, the peek style Jiggle, Every 2.5 s and Stays out 1.2 s
A peek bot: its style, how often it peeks and how long it stays out.
What it does
Hold: holds this angle and shoots when it sees you. Hunt: comes after you along the map. Roam: walks its path back and forth. Peek: peeks out from cover again and again.
Gun
Any of the dashboard's guns; a hunter can have just a knife.
Peek
Wide, Jiggle or Shoulder, Every 0.5 to 20 seconds (3) and Stays out 0.3 to 10 seconds (1.5). It waits in cover on its spot and looks from where it peeks out to.
Roam
Path with its points (32 at most), Clear path, Speed (Run or Walk), and Loop back to the start: round the path back to its spot instead of there and back.
Hunt
Speed: Run or Walk.
Hold
Crouch: holds the angle crouched.
More
Starts after (seconds after Go!, not for holders), Armor, Health, Aim up (degrees; negative looks down) and, where the spot has several floors, Floor: Ground, Box +48 and so on.

The bot's ⋯ menu has Duplicate, Move to stage … and Delete.

What to fix

The arena builder with unsaved changes back from before, and the things to fix: a peek bot with no spot to peek out to, a roam bot with no path
The top of the panel lists what stops the arena from saving; click one to go to its bot.

At the top of the panel, one row each, the arena builder says what's missing and how to fix it: "Give the arena a spawn: where you start.", "Add at least one bot.", "Bot 4 peeks, so it needs a spot to peek out to: drag from it to where it peeks.", "Bot 2 roams, so its path needs at least one point." and the limits (10 bots a stage, 20 in all, 5 stages).

The map

  • Drag the map to move it; the wheel (or two fingers on a phone) zooms. +, − and the fit button are in its top right corner.
  • The tools along its bottom: Spawn, Add bot, Undo and Redo. The one that's on is lit white.
  • Nuke, Train and Vertigo have two levels: Upper and Lower switch the radar, and what you place goes on that level. Points on the other level show faintly.
  • A map with no radar picture shows its floors as a height map: lighter is higher.

Keys

KeyWhat it does
DeleteDeletes the bot you picked.
Ctrl + Z / Ctrl + YUndo / redo (50 steps).
Ctrl + SSave.
EscStops adding a bot or a path, then lets go of the bot.
Arrow keysNudge the bot (or your spawn) 8 units; with Shift 32.
Q / ETurn it 5° left / right.

Unsaved changes

Leaving the arena builder with unsaved changes stops you with "Unsaved changes." and Save / Leave without saving. Your work in progress is also kept in your browser: open the arena again and "Your unsaved changes are back." Undo and redo are in the map's tools (and Ctrl + Z / Ctrl + Y). The ⋯ menu has Duplicate, Publish to Community…, Discard changes and Delete arena. An arena you added from the Community hub can be changed and played, but not duplicated or published: it's still the author's. On one of those, Delete arena is Remove from library, which asks Remove from your library? and takes it off your list of added items too, as in the Library.

Edit in game saves your changes first, then opens the arena in the in-game builder. If something stops it from saving, it says what instead.

In game

The in-game builder makes the same arena by standing where things go. It runs like any mode on your server.

  1. Start it

    .build starts a new arena where you stand (.build A site hold names it), .build 2 edits your second arena on this map. You're put on the arena's side.

  2. Your spawn

    Stand where you start, look ahead: .ab spawn.

  3. Bots

    Stand where a bot goes, look where it looks: .ab bot hold (or hunt, roam, peek). Crouch for a crouching holder.

  4. Peeks and paths

    A peek bot: stand where it peeks out to, .ab to. A roam bot: .ab path, walk its path, .ab path again.

  5. Stages and the win

    .ab stage new starts the next stage. .ab win kill, .ab win time 20 or .ab win survive 30.

  6. Save and try it

    .ab save Name keeps it ("It's in your Library now."). .ab test plays your unsaved version, nothing recorded; .ab edit goes back to building, and .ab save keeps it from there too.

The stage's bots stand frozen on their spots, facing their angle. Beams mark your spawn (a green post), the bots (red posts with orange lines where they look; the selected one white), peek lines (orange), roam paths (blue) and the other stages' bots (thin grey). The HUD says where you are: BUILDER · S1/2 · 4 bots over Bot 3 · peek jiggle, ● path · 6 points while you record, else unsaved or saved. Saving, testing and the first play of your own arena say in grey what may play badly: a point off the floor, cover you can see from your spawn, a peek spot out of sight, a roam leg through a wall, a hunter with no way to you.

.ab from turns the gunfight arena you stand on (or .ab from 3, the map's third) into a draft: its spot becomes your spawn, its lanes peek bots. It takes the place of the arena you were building; .ab undo brings that one back, unsaved changes and all. .bots, .botarmor, .difficulty and .freeze don't work in the builder (it places its own bots); .noclip, .savepos and .goto do. .arenabuilder is the long form of .ab.

CommandWhat it does
.custom [n|name]Plays this map's custom arenas, yours and the ones you added from the Community hub, from the first; with a number or a name, that arena. Not rated: each run counts in your training sessions.
Example: .custom 2
.build [name|n]Opens the arena builder with a new arena where you stand (optionally named), or with .build 2 your second arena on this map. Unsaved changes to the arena you were building are dropped.
Example: .build A site hold
.ab spawnYour spawn: where you stand, facing the way you look. Every run starts there.
.ab bot <hold|hunt|roam|peek>A bot on the stage you're editing, where you stand, looking where you look (crouch for a crouching holder). It becomes the selected bot. 10 a stage, 20 in all.
Example: .ab bot peek
.ab sel [n]Selects bot n, or the bot of this stage you aim at.
Example: .ab sel 3
.ab holdThe selected bot holds its angle and shoots once it has seen you for its reaction time.
.ab huntThe selected bot comes after you along the map from Go! (or after its delay). Hunters may carry just a knife.
.ab roamThe selected bot walks a path back and forth (or round a loop), stopping to shoot when it sees you. Record the path with .ab path.
.ab peek [wide|jiggle|shoulder]The selected bot peeks out from cover again and again: wide (out and a step past, then back), jiggle (out and A-D strafing) or shoulder (a shoulder first, then the real peek). Give it a spot with .ab to.
Example: .ab peek jiggle
.ab toA peeking bot's spot to peek out to: stand there. Its spot is the cover it waits in.
.ab pathStarts recording the selected roam bot's path as you walk (a point every 48 units, on the ground); .ab path again stops.
.ab loopThe selected roam bot walks round its path back to its spot instead of there and back.
.ab every <seconds>A peeking bot's time between peeks, 0.5 to 20 seconds (3 by default).
Example: .ab every 2
.ab out <seconds>How long a peeking bot stays out, 0.3 to 10 seconds (1.5 by default).
Example: .ab out 1
.ab delay <seconds>Seconds after Go! before a hunter, roamer or peeker starts, 0 to 30.
Example: .ab delay 2
.ab gun <weapon>The selected bot's gun, for example ak47, awp, deagle; knife for hunters only.
Example: .ab gun awp
.ab crouchA holding bot holds crouched, or stands again.
.ab walkA hunter or roamer walks (shift) instead of running, or runs again.
.ab faceThe selected bot looks at the point you aim at.
.ab moveThe selected bot's spot is where you stand.
.ab del [n]Deletes bot n, or the selected bot; the others are numbered again.
.ab undoUndoes the last change (50 steps back).
.ab stage <n|new>Edits stage n, or adds the next stage (5 at most). A stage's bots come once the stage before is cleared.
Example: .ab stage new
.ab win <kill|time s|survive s>How the arena is won: kill every bot, kill every bot within the seconds, or still be alive when they run out (5 to 300 seconds).
Example: .ab win survive 30
.ab level <easy|normal|hard|expert>The bots' difficulty: their reaction time, aim, jiggles and bursts. Fixed by the author: custom arenas aren't rated.
.ab weapon <weapon>Your gun in the arena. A run only counts with it.
Example: .ab weapon m4a1
.ab side <ct|t>Your side; the bots are the other one.
.ab name <text>The arena's name, 48 characters at most.
Example: .ab name A site hold
.ab save [name]Saves the arena (optionally renaming it). It shows up in your Library under Arenas, and the builder says in grey what may play badly. Works outside the builder too: during .ab test or after .ab quit.
.ab testPlays your unsaved version as a custom arena. Nothing is recorded; .ab edit goes back to editing, .ab save keeps it.
.ab editBack to the builder with your unsaved version, after .ab test or .ab quit.
.ab listYour arenas on this map (.build n edits one).
.ab infoThe arena you're building: its stages, bots and how it's won.
.ab from [n]A draft from a gunfight arena: the one you stand on, or arena n of this map. Its spot becomes your spawn and its lanes peek bots; .ab undo brings back the arena you had.
.ab quitLeaves the builder. Unsaved changes stay until the next .build.

In your Library

The Library on the Arenas tab: three arenas on Mirage with their bots, stages, how they're won, difficulty and best, one published with 14 adds and one from kz_lynx with a new version out
Library → Arenas: one row per arena on the gunfight map.

Each row shows its bots and stages, how it's won, its difficulty and your best, with Play. Its ⋯ menu has Edit on the map, Edit in game, Rename, Duplicate, publishing and Delete. See Library: Arenas.

Publish an arena

  1. Publish

    Publish to the Community hub… in an arena's ⋯ menu (or Publish on the Community page, then Arena) opens the publish dialog with it picked. One arena an item.

  2. Name and tag it

    The title is 48 characters at most: it becomes the arena's name for everyone who adds it. Tags: T side, CT side, Hold, Retake, Entry, Clutch, Rifle, AWP, Pistol, Stages, Short, Hard.

  3. Update it

    Changed it? Update contents in its ⋯ menu publishes the new version, and everyone who added it gets an Update.

Your own arenas show Published, 14 adds on their row. Arenas you added show "by" their author; see Community: Arenas.

Note: On your cloud server

An arena you save here plays on your running server right away. One you save in game with .ab save shows up in your Library within about 15 seconds.