Skip to content

Arena Files

P3rlE edited this page Oct 9, 2026 · 2 revisions

Arena Files

Every map needs an .arena file in scripts/. It tells the menu what the map is called, who made it, and which game modes it supports. The Create Server menu only lists maps whose type matches the selected mode.

Example

scripts/q3r_country01.arena:

{
//MAP FILE NAME
map "q3r_country01"

//IN-GAME MAP NAME
longname "Roll On Down The Line"

//AUTHOR OF THE MAP
author "Stecki"

//GAME TYPE SUPPORTS
type "q3r_racing q3r_team_racing q3r_elimination"

//ELIMINATION READY
elimination "1"

//CUSTOM BOTS
bots "Bee Dean Minori Zack Tanya"

//PLAYER STARTS
starts "9"

//LAPS
laps "3"

//LAPTIME
laptime "55 sec"

//CHECKPOINTS
checkpoints "20"

//OBSERVER SPOTS
observerspots "12"

//WEAPONS
weapons "0"

//POWERUPS
powerups "8"

//REVERSABLE
reversable "0"

//TRACK LENGTHS
tracklengths "2"

//BOT SUPPORTS
botsupport "Very Good!"

//TEAMS
teams "All"
}

Game mode keywords for type

List all supported modes, separated by spaces.

Keyword Mode
q3r_racing Racing
q3r_racing_dm Racing DM
q3r_sprint Sprint (A-to-B)
q3r_ghost Ghost Race 🧪 (lap and sprint tracks are included automatically)
q3r_single Single Player
q3r_elimination Elimination
q3r_derby Demolition Derby
q3r_lcs Last Car Standing
q3r_dm Deathmatch
q3r_team_dm Team Deathmatch
q3r_team_racing Team Racing
q3r_team_racing_dm Team Racing DM
q3r_ctf Capture the Flag
q3r_ctf4 Four-team CTF
q3r_dom Domination
q3r_koth King of the Hill
q3r_autoball Autoball 🧪 (needs a ball and two goals, see Game Mode Entities)

⚠️ King of the Hill: only add q3r_koth once the map really contains a trigger_koth_hill. Maps without a valid hill are rejected at match start.

Other keys

Key Purpose
map BSP file name without .bsp
longname Display name in the menu
author Author(s)
bots Bots that are added on this map (space-separated names)
elimination "1" is a marker for tools and rotation scripts. The menu itself goes by q3r_elimination in type.
laps, laptime, checkpoints, starts, observerspots, weapons, powerups, reversable, tracklengths, botsupport, teams Information shown in the menu

ℹ️ The info keys are descriptive only. The real lap count, reversibility and track lengths come from the map itself (rally_startfinish and the worldspawn keys). Keep both in sync.

Clone this wiki locally