Match History

ArenaPvP automatically records all completed arena matches and lets players browse their recent match history through an interactive UI.

How It Works

1. Play matches — Every completed arena match (FFA, Team, Deathmatch, Capture the Orb) is automatically saved.
2. Open the Match History UI — Use /arena history (aliases: /arena hist, /arena matches).
3. Browse your matches — The UI shows your recent matches sorted by date (most recent first), paginated 8 matches per page.
4. View match details — Click the detail button on any match to see the full breakdown: players, kills, deaths, assists, and timeline events.

Match List View

The list view displays a table with the following columns for each match:

Column	Description
Date	When the match ended (format: dd/MM/yy HH:mm)
Category	Arena category (e.g. 1v1 FFA, 2v2 Team)
Arena	Template (map) name used for the match
Result	Your result: Win (green), Loss (red), or Draw (yellow)
KDA	Your Kills / Deaths / Assists
Duration	Total match duration (format: m:ss)
Action	Button to open the detailed match view

Match Detail View

Clicking on a match opens a detailed view with:

• Match metadata — Date, category, arena, result, duration
• Player stats table — All participants with their individual kills, deaths, and assists
• Timeline — Chronological list of match events (kills, deaths, captures, etc.)

Data Storage

Match history is stored as JSON files organized by arena category:

mods/arenapvp/data/history/
  2-FFA.json
  4-T.json
  4-TDM.json
  ...

Each category file stores matches in FIFO (First In, First Out) order. When the limit is reached, the oldest matches are automatically removed to make room for new ones.

info

The storage limit is per category, not per player. A single category file contains all matches played by all players in that category.

Configuration

Match history behavior is controlled by two settings in config.json:

Key	Type	Default	Description
MatchHistoryEnabled	boolean	true	Enable or disable match history recording. When false, no new matches are saved.
MatchHistoryLimit	integer	100	Maximum number of matches stored per category (FIFO). Oldest matches are removed when the limit is exceeded.

{
  "MatchHistoryEnabled": true,
  "MatchHistoryLimit": 100
}

tip

Increase MatchHistoryLimit if you want to keep a longer history. For example, setting it to 500 stores up to 500 matches per category.

warning

Setting MatchHistoryLimit to 0 or a negative value does not disable the limit — it defaults to 100. To stop recording history entirely, set MatchHistoryEnabled to false.

Permissions

Permission	Description
arenapvp.history	Required to use /arena history and view match history

Commands

Command	Aliases	Description
/arena history	hist, matches	Open the match history UI

Assist System

ArenaPvP tracks assists using a configurable time window. If a player damages an enemy shortly before that enemy is killed by someone else, the damager receives an assist credit.

Key	Type	Default	Description
AssistWindowSeconds	integer	10	Time window (in seconds) to credit an assist after dealing damage