HomeJavaModsPvPKit - Arena Manager
PvPKit - Arena Manager
[​IMG]
⚔️ PvPKit ARENA ⚔️

The ultimate high-performance solution for KitPvP arenas!

________________________________________________________

WHAT IS PVPKIT ARENA?

It is a complete combat system designed to offer a fast, fluid, and stable experience. It allows managing multiple arenas based on cuboid regions, incorporates random kit selection, and real-time statistics tracking.

Unlike other plugins, PvPKit features an advanced respawn system that always prioritizes the arena lobby over beds or world spawns, ensuring the action never stops.

________________________________________________________

MAIN FEATURES

Multi-Platform Support (Java & Bedrock)
Fully compatible with Geyser and Floodgate. Bedrock players (mobile, console) can see the Scoreboard and use GUI menus without compatibility errors.

Event-Based Command Automation
Fully customizable rewards or penalties. Execute console commands automatically when a player kills an opponent or dies. Ideal for giving money, ranks, or custom messages!

Multi-Language System (ES / EN)
Native support for English and Spanish. The translation system is 100% customizable.
(Note: If you need the plugin in another language, you can ask me to translate the entire file!)

Visual Creation Wizard with Particles
Configure your arenas step-by-step with interactive tools and real-time particle border visualization.

[​IMG]

GUI-Based Kit System
Create, edit, and manage kits for each arena directly from an intuitive menu. Supports full armor sets and items with metadata.

[​IMG]

Random Kit Distribution
Keep combat dynamic and varied by automatically assigning a random kit upon joining an arena. The system delivers complete gear instantly.

[​IMG]

Support for Join Signs
Allows players to join the action with a single click using personalized signs. Administrators can create automatic signs with professional formatting.

[​IMG]

Combat Tag & Smart Borders
Prevents players from escaping combat or leaving the PvP zone. Includes an automatic knockback system if they try to leave the boundaries.

[​IMG]

Dynamic Scoreboard & Visual Health
Professional sidebar with real-time stats. Opponent health is visible in the player list (Tab) and below their names.

[​IMG]

Smart Health Visibility (Spectator Mode)
Advanced logic for health bars: Players in the lobby can see the hearts of those fighting, but players inside the arena won't be distracted by the health of people in the lobby.

[​IMG]

________________________________________________________

DOCUMENTATION & WIKI

[ VISIT THE OFFICIAL WIKI ]
________________________________________________________​

Spoiler: STEP-BY-STEP INSTALLATION
1. Download the PvPKit.jar file and place it in your /plugins/ folder.
2. Start the server to generate the base configuration files.
3. Go to /plugins/PvPKit/lang/ and ensure you have the messages_en.yml file.
4. In config.yml, set
Code (Text):
lang: en
to activate your language.
5. Use
Code (Text):
/pvpkitadmin reload
to apply changes.

Spoiler: ️ ARENA CREATION (WIZARD)
Use the command /pvpkitadmin create <name> to start the visual assistant:
  1. Step 1 (Zone): Use the Golden Axe to define the combat area.
  2. Step 2 (Lobby): Use the Beacon to set the exit point.
  3. Step 3 (Spawns): Use the Armor Stand to add spawn points.
  4. Step 4 (Kits): Use the Chest to open the equipment editor.
  5. Step 5 (Finish): Use the Lime Dye to save the arena.

Spoiler: PLACEHOLDERS (API)
The plugin requires PlaceholderAPI for these variables. Ideal for external scoreboards or holograms.

Individual Stats
%pvpkit_kills% :: Player's total kills.
%pvpkit_deaths% :: Player's total deaths.

Global Top (Kills/Deaths)
%pvpkit_top_global_kills_name_<pos>% :: Name of the player at position <pos>.
%pvpkit_top_global_kills_score_<pos>% :: Score of the player at position <pos>.

️ Arena Specific Tops
%pvpkit_top_arena_<ArenaName>kills_name<pos>% :: Top killer's name in a specific arena.
%pvpkit_top_arena_<ArenaName>kills_score<pos>% :: Top killer's score in a specific arena.

Spoiler: ️ COMMANDS AND PERMISSIONS
Player Commands (Permission: pvpkit.use):
/pvpkit join <arena> - Join an active arena.
/pvpkit leave - Exit the arena (Blocked while in combat).

Admin Commands (Permission: pvpkit.admin):
/pvpkitadmin list - View all arenas and their status.
/pvpkitadmin create <name> - Start the creation wizard.
/pvpkitadmin kit <arena> - Manage kits via GUI.
/pvpkitadmin delete <arena> - Delete an arena permanently.
/pvpkitadmin reload - Reload the configuration.

Spoiler: ⚙️ DEFAULT CONFIGURATION (CONFIG.YML)
Code (Text):

# ==========================================
#      MAIN CONFIGURATION - PVPKIT
# ==========================================

# Plugin language.
lang: en

# Combat System Configuration
combat-tag:
  enabled: true
  time-seconds: 10
  kill-on-quit: true # If disconnected in combat, the player dies.

# Arena Configuration
arena:
  prevent-build: true
  prevent-break: true
  prevent-drop: true
  kill-heal: 6.0

# --- EVENTS SECTION ---
# Optional commands to execute on winning (kill) or losing (death).
# You can use %player% for the player's name.
events:
  on-kill:
    enabled: false
    commands:
      - "eco give %player% 10"
      - "msg %player% &aYou have earned 10 coins for your kill!"
  on-death:
    enabled: false
    commands:
      - "eco take %player% 5"
      - "msg %player% &cYou have lost 5 coins for dying."

# Arenas and kits are saved here automatically.
arenas: {}
 

________________________________________________________

VERIFICATION AND UPDATES

The plugin features a professional Update Checker system that notifies both the console and administrators about new versions available.

⚠️ TECHNICAL SUPPORT
Do you need help with the configuration or did you find a bug?
VIEW WIKI | [ JOIN THE SUPPORT DISCORD ]

Developed with ❤️ by Liancitodev

Commands

Plugin details

Read from the plugin's own plugin.yml.

Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

PvPKit - Arena Manager is a free Minecraft Java mod. Compatible with Minecraft 1.20.6, 1.21. Downloaded 81 times (via Spigot). Download it and open it directly in the game.

Explore more