⚔️ zMPvPRooms

The Ultimate High-Performance PvP Arena System for Modern Minecraft Servers
Extreme performance, limitless customization, and full compatibility with the most popular clan ecosystems.

---

📖 Overview

zMPvPRooms is an enterprise-grade PvP arena engine built to create and manage isolated combat environments with effortless ease.

Powered by a fully asynchronous architecture, it delivers seamless combat experiences with zero TPS loss—even under heavy server loads. Whether you run a casual hub or a competitive network, this plugin gives you stability, flexibility, and total control.

---

🎯 Match Modes at a Glance

Mode	Entry System	Format	Target Audience
Normal	WorldGuard Regions	1v1, 2v2, FFA, Teams	Casual & Ranked Arena Players
Clan	Challenge / Invite	Clan vs Clan	Competitive Guild Networks

---

⚔️ Game Modes Breakdown

🟦 Normal Mode

Perfect for open hubs and fast-paced skirmishes.

• Auto-Join Engine – step into a WorldGuard region and join instantly.
• Flexible Formats – supports 1v1 duels, open FFA, and balanced team battles.
• Victory Rewards – execute commands, grant items, or apply potion effects to winners.
• Full Match Control – configurable round timers and draw mechanics.

🛡️ Clan Mode

Built specifically for servers running structured guild ecosystems.

• Guild Matchmaking – challenge rival clans directly via an invitation-based workflow.
• Seamless Hooks – works out-of-the-box with UltimateClans, uClans, ByteClans, and ApexClan (auto-detected).

---

⚡ Key Features at a Glance

Area	Detail
🚀 Unmatched Performance	Asynchronous processing guarantees 20.0 TPS stability, regardless of concurrent match volume.
🛠️ 100% Configurable	Messages, GUIs, arena parameters, kits, rewards—everything is tweakable.
🔒 Anti-Abuse Built-In	Protection against combat logging, command abuse, and arena escaping.
🏆 Automated Reward System	Distribute economy funds, items, or temporary perks upon match completion.
📊 Global & Per-Arena Stats	SQLite with WAL mode, atomic updates, and async leaderboard refreshes.
🎨 Premium Feedback	Bossbars, actionbars, titles, sounds, and fireworks—fully customizable.
🧰 In-Game Editor	Create and edit arenas using a wand and a visual GUI—no reloads required.

---

🧩 Compatibility & Dependencies

Requirements

• Java 17+
• Minecraft 1.19 – 1.21+

Soft Dependencies (Recommended)

• PlaceholderAPI – for stats, leaderboards, and custom placeholders.
• WorldGuard – for arena borders and region detection.
• Vault – for economy integration and betting.

Clan Plugin Compatibility

The active provider is selected automatically from:

• UltimateClans
• uClans
• ByteClans
• ApexClan

---

🏗️ Quick Setup

1. Drop the zMPvPRooms.jar into your plugins folder.

2. Restart the server to generate the configuration files.

3. Create a WorldGuard region for your room. First, select the area you want to use and then run: /rg define <name> Example: /rg define room1

4. Set the global return spawn where players will be sent when they die: /zmrooms setspawn

5. Set the positions for your room:

   • /zmrooms pos1 <room> — Set the first position.
   • /zmrooms pos2 <room> — Set the second position.
   • /zmrooms setspectate <room> — Set the spectator position.

6. Your room is now configured and ready to use.

7. Use /zmrooms edit to open the visual editor and customize the room's settings and values.

---

📈 PlaceholderAPI – Stats & Leaderboards

The plugin registers multiple expansions: %zmrooms_...%, %rooms_...%, %zmpvp_...%, and %zmpvprooms_...%.

Personal Stats

Placeholder	Description
%zmrooms_kills%	Total kills
%zmrooms_deaths%	Total deaths
%zmrooms_wins%	Total wins
%zmrooms_kdr%	Global kill/death ratio
%zmrooms_streak%	Current win streak
%zmrooms_currentzone%	Current arena name or none

Leaderboards

• Global: %zmrooms_top_<column>_<rank>% → player name
  %zmrooms_top_<column>_value_<rank>% → numeric score
• Per-Arena: append the arena name at the end, e.g. %zmrooms_top_normal_wins_1_room1%

Valid columns: normal_wins, clan_wins, normal_kills, clan_kills, normal_deaths, clan_deaths.

---

📊 Usage Statistics

---

🖼️ Screenshots

Show off your arena in action, the GUI editor, match feedback, and reward system here.

---

💬 Need Help?

Join our community or open an issue on GitHub. We're here to help you take your PvP to the next level!