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