Replays

Frontier can record replays of every ranked match automatically. When a match ends, a replay file is saved to disk with a complete log of the battle — every move, switch, and turn.

Configuration

Replay recording is controlled in the replay block of config/frontier/config.conf:

replay {
    enabled = true
    directory = "replays"
}

Field	Type	Default	Description
enabled	Boolean	true	Whether to record match replays.
directory	String	"replays"	Directory where replay files are stored, relative to the server root.

Replays are enabled by default. Set enabled = false to turn them off.

Where Replays Are Stored

Replay files are written to the directory specified in directory. With the default setting, that’s <server_root>/replays/.

Each replay file is named with enough context to identify the match — players involved, ladder, and timestamp. This makes it straightforward to find a specific match later.

Tip

If disk space is a concern on a busy server, point directory to a dedicated volume or set up a cron job to archive old replays periodically. Replay files are lightweight, but they do add up over hundreds of matches.

Replay File Format

Each replay file contains a structured log of the entire battle:

• Match metadata — player names, ladder, format, arena, timestamp.
• Turn-by-turn actions — every move selection, switch, item use, and forced action.
• Battle events — damage, status effects, weather changes, faints, and field conditions.
• Result — winner, loser, and how the match ended (KO, forfeit, timer).

The format captures everything needed to reconstruct the full battle sequence.

Use Cases

Dispute resolution — A player claims their opponent exploited a bug or disconnected at a suspicious time. Pull the replay, review exactly what happened, and make a fair ruling.

Content creation — Replay files give content creators raw match data to work with for highlight reels, analysis videos, or tournament recaps.

Training and improvement — Players (or coaches) can review past matches to spot misplays, study opponent patterns, and refine strategies.

Tournament records — Keep a permanent archive of tournament bracket matches for standings verification and historical reference.

Note

Replays are recorded server-side. Players don’t need to do anything — if replays are enabled, every ranked match is captured automatically.

Disabling Replays

If you don’t need replay recording:

replay {
    enabled = false
}

No replay files will be created. Existing files in the replay directory aren’t affected.