![BattleTracker by BattlePlugins](https://cdn.modrinth.com/data/cached_images/6b0c616135d870313182c64c3958f84f1fc8cec6.png) **A standalone plugin that tracks PVP & PVE statistics along with a suite of additional combat features to enhance server gameplay.** BattleTracker tracks player statistics for both PVP and PVE combat. It also comes with a full suite of customizable features, such as death messages, combat logging, damage indicators and more. It also serves as the companion to [BattleArena](https://modrinth.com/plugin/battlearena), and handles keeping track of arena and competition statistics. This makes BattleTracker an essential plugin for any PVP or PVE server. ## Features ### PVP and PVE Records 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. ![PVP PVE Records](https://cdn.modrinth.com/data/cached_images/a3b4468dec92e3fa2531f71af109f6942141408e.png) ### 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.

### Damage Recap 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. ![Damage Recap](https://cdn.modrinth.com/data/cached_images/4b22a886a0a012ed8c1e43c0543e4b2cb8e2e3d1.png) ### 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.

### 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.

## Additional Features BattleTracker also includes the following features: - **Killstreak Messages** - When a player kills a number of players before dying, a message will be broadcasted in chat notifying others of their killstreak - **Rampage Messages** - When a player kills multiple players consecutively in a very short duration, a message will be broadcasted notifying other players that this player is on a rampage - Fully configurable in-game messages - MySQL & SQLite database support ## Additional Plugins BattleTracker also serves as a companion to [BattleArena](https://modrinth.com/plugin/battlearena), which lets you track all arena-related data such as wins, losses or draws. BattleArena requires BattleTracker in order to process and save this information. ### Plugin Hooks BattleTracker hooks into the following plugins for additional support: - [PlaceholderAPI](https://docs.battleplugins.org/books/user-guide-UMJ/page/placeholder-api) ## User Guide Most all of the configurable features in BattleTracker will be in YML files located in **plugins/BattleTracker/features**. Trackers can be configured in their respective YML file located in **plugins/BattleTracker/trackers**. The full user guide for BattleTracker can be found at the [User Guide](https://docs.battleplugins.org/books/user-guide-UMJ) on the BattleDocs. ## Permissions | Permission | Description | |-----------------------------------------|----------------------| | battletracker.command.top | Permission for the / top command. | | battletracker.command.rank | Permission for the / rank command. | | battletracker.command.versus | Permission for the / versus command. | | battletracker.command.recap | Permission for the / recap command. | | battletracker.combatlog.bypass | Whether a player will bypass the combat log (if enabled). Requires that allow-permission-bypass is enabled in the Combat Log config. | ## Links - Website: https://www.battleplugins.org - Discord: [BattlePlugins Discord](https://discord.com/invite/J3Hjjb8) - Donate: [BattlePlugins Patreon](https://patreon.com/battleplugins) ## Important Mentions Special thanks to alkarin_v for writing the original [BattleTracker](https://github.com/alkarinv/BattleTracker/) plugin back in 2011. While very little of the original code survives today, this laid the foundation of what would eventually become the BattlePlugins suite and the innovations that followed.