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

First public release of ArenaPVP for Paper 26.1.2 (Minecraft 26.1.2). Requirements Paper 26.1.2 Java 25 What's included Multiple arenas — /arenapvp setarena <name>, warp via GUI or /arenapvp warp <name> (Multiverse-Core friendly) Kits — local SQLite kits + optional Essentials sync; GUI or /arenapvp kit <name> Stats & ranks — kills, deaths, KDR, streaks; Iron → Netherite tiers Economy — Vault rewards on kill, penalty on death (configurable) PlaceholderAPI — kills, deaths, KDR, streak, rank, top streak leaderboard LuckPerms — granular permission nodes for every command Update checker — notifies ops when a newer GitHub release is available Soft dependencies (optional) Vault, PlaceholderAPI, Essentials, Multiverse-Core, LuckPerms