Features

Documentation for all the features that BattleTracker includes.

PVP and PVE Trackers

One of the core features of BattleTracker is its robust tracking system for PVP and PVE statistics. BattleTracker tracks a variety of statistics including kills, deaths, killstreaks, and more. These statistics are saved in MySQL or SQLite, allowing them to be shared across Minecraft servers, or accessed by web applications. 

Configuration

By default, BattleTracker has support for both PVP and PVE tracking. These configurations can be found in the plugins/BattleTracker/trackers/pvp.yml and plugins/BattleTracker/trackers/pve.yml YML files respectively.

Recaps

By default, each tracker supports recaps, which recaps information about when a player took damage. This also includes information such as a player's inventory or armor at the time of the recap.

Options:

Tracked Statistics

Which statistics are tracked by a tracker. The options available are pvp, pve and world. By default, BattleTracker splits this into two trackers, with PVP tracking exclusively PVP data, and PVE tracking both PVE and world data.

Calculator

Which calculator is used to rank players in leaderboards. By default, this is elo. As of BattleTracker 4.0.0, only elo is supported.

Killstreaks

Whether the killstreak feature is enabled. A killstreak occurs when a player kills a certain number of players in a row without dying.

Options:

Rampage

Whether the rampage feature is enabled. A rampage occurs when a player kills a certain number of players in a short amount of time.

Options:

Death Messages

BattleTracker provides customizable death messages that can be displayed to players when they are killed in PVP or PVE combat. These are easily configurable for each tracker type, and can be customized to fit the theme of your server.

Configuration

Player

Player death messages are death messages that occur when a player dies due to another player. 

By default, these come pre-configured in the pvp.yml, and are configured in conjunction with the item type that is used to kill the player. Additionally, Minecraft Item Tags are also able to be used, allowing you to configure death messages for similar types of items, denoted by a pound/hashtag (#) symbol (i.e. #axes for all axes, #pickaxes for all pickaxes, etc.)

Variables:

World

World death messages are death messages that occur when a player dies due to a world event, such as suffocating in sand, burning in lava, or anything that does not involve a death by an entity or player.

By default, these come pre-configured in the pve.yml, and can be set for any Damage Cause.

Variables:

Entity

Entity death messages are death messages that occur when a player is killed by an entity. This does not include players, or world events.

By default, these come pre-configured in the pve.yml, and can be set for any Minecraft Entity, using it's official identifier.

Variables:

Damage Recaps

BattleTracker also includes a damage recap feature that displays a summary of the damage dealt and received by a player during combat. This can be summarized in multiple ways, such as which item dealt the most damage, a breakdown of players that dealt damage, or all the types of damage a player received.

By default, BattleTracker allows for recapping damage based on players, entities, items and cause. The image below demonstrates how this is shown to players:

Configuration

Configuration for damage recaps can be found in the PVP and PVE Tracker configuration page.

Combat Logging

BattleTracker includes a configurable combat logging feature that places players "in combat" when they attack another player. If they log out, they will be killed and their attacker will receive credit for the kill.

Configuration

The combat logging configuration can be found in the plugins/BattleTracker/features/combat-log.yml YML file. 

Options:

Damage Indicators

Inside BattleTracker, there is also toggleable damage indicators, which show to a player how much damage they inflicted on another player or entity.

Configuration

The combat logging configuration can be found in the plugins/BattleTracker/features/damage-indicators.yml YML file. 

Options: