ArenaPvP

ArenaPVP v1.0.2

What's New

Leaderboard Placeholders - Added PlaceholderAPI support for TOP 10 kills and deaths: - %arenapvp_top_kills_<1-10>_name% / _val% - %arenapvp_top_deaths_<1-10>_name% / _val% - Replaces legacy Skript-based %practice_top_*% placeholders for holograms, scoreboards, and DeluxeMenus leaderboards. Action Bar HUD - Persistent action bar showing live PvP stats (kills, deaths, KDR, streak, rank). - On kill, displays the money earned for a few seconds alongside stats. - Configurable per world, refresh interval, and display duration. - New permission: arenapvp.actionbar (default: true). Rank Placeholder - %arenapvp_rank% returns the player's current tier (e.g. Iron 1, Gold 2, Netherite 3). - Ready for TAB, scoreboards, chat, and any PlaceholderAPI integration. Economy - Default kill reward set to $25 (matching common Skript setups). - Death penalty disabled by default (0.0). - New option economy.chat-message-on-kill — disable chat messages when using the action bar for kill rewards.

Improvements

- Top leaderboard size unified under placeholders.top-list-size (default: 10). - Kill reward messages localized in messages.yml (Spanish-friendly defaults). - Empty leaderboard slots return --- for names and 0 for values.

PlaceholderAPI (full list)

| Placeholder | Description | |-------------|-------------| | %arenapvp_kills% | Player kills | | %arenapvp_deaths% | Player deaths | | %arenapvp_kdr% | Kill/death ratio | | %arenapvp_streak% | Current kill streak | | %arenapvp_best_streak% | Best kill streak | | %arenapvp_rank% | Current rank tier (e.g. Iron 1) | | %arenapvp_top_kills_<n>_name% | TOP n player name | | %arenapvp_top_kills_<n>_val% | TOP n kill count | | %arenapvp_top_deaths_<n>_name% | TOP n player name | | %arenapvp_top_deaths_<n>_val% | TOP n death count | | %arenapvp_top_streak_<n>_name% | TOP n streak player | | %arenapvp_top_streak_<n>_val% | TOP n best streak |

Requirements

- Paper 26.1.2 (Minecraft 26.1.2) - Java 25 - Soft dependencies: Vault, PlaceholderAPI, Essentials (optional), Multiverse-Core (optional), LuckPerms (optional)

Upgrade Notes

- Stats are stored in ArenaPVP's SQLite database — not vanilla Minecraft statistics. Leaderboards will populate as players earn kills/deaths through the plugin. - If migrating from Skript economy scripts, remove duplicate kill-reward handlers to avoid double payouts. - After updating, run /arenapvp reload and reload PlaceholderAPI-dependent plugins (TAB, FancyHolograms, DeluxeMenus).