PvP zone

PvP Zone — Plugin for PvP Arenas with Rating & Duels

Version: 1.0.0
Core: Paper 1.21+
Java: 17+
Languages: English | Русский

---

📋 Description

PvP Zone is a plugin for Paper 1.21+ servers that adds PvP zones with a rating system, duels, and a bonus shop. Inside zones, players receive a pre-defined kit, and their inventory is restored upon exiting. The plugin supports two languages: English and Russian.

---

📦 Installation

---

🛠️ Initial Setup (Admin)

1️⃣ Creating a PvP Zone

The zone is now saved. By default, it's linked to the kit named default.

---

2️⃣ Creating & Assigning Kits to Zones

You have two convenient options:

🔵 Option A: One Global Kit for All Zones (Simpler)

1. Fill your inventory with the items and armor you want (sword, armor, food, etc.)
2. Run: /pvpkit
   • Your current inventory is saved as the default kit (plugins/PvpZone/kit.yml)
3. All zones automatically use the default kit
4. If you created your zone before saving the kit, make sure it's assigned: /pvpzone kit set arena default (replace arena with your zone name)

🟢 Option B: Different Kits for Different Zones

1. Create a zone (as in step 1), e.g.: /pvpzone create arena
2. Fill your inventory with items for this specific zone
3. Save the kit and assign it to the zone in one command: /pvpzone kit save arena my_kit — saves your inventory as my_kit and assigns it to zone arena Or simply: /pvpzone kit save arena — saves inventory under the zone's current kit name (default) and assigns it

🔧 Managing Kit Assignments

Kits are stored in:

• plugins/PvpZone/kit.yml (default kit)
• plugins/PvpZone/kits/<name>.yml (custom kits)

---

3️⃣ Additional Zone Commands

---

🌐 Language Support (English / Russian)

In config.yml, at the very top: language: "en" # English or language: "ru" # Russian (default). After changing, run /pvpzone reload or restart the server.

Translation files: plugins/PvpZone/lang/en.yml and plugins/PvpZone/lang/ru.yml. You can edit these files to customize messages!

---

📝 Complete Command List

---

🔑 Permissions

---

🎮 How to Play (For Players)

---

✅ Quick Checklist: Zone + Kit Setup

1️⃣ /pvpz1 (first corner) 2️⃣ /pvpz2 (second corner) 3️⃣ /pvpzone create arena (create zone) 4️⃣ Fill your inventory with desired items 5️⃣ /pvpkit (save as default kit) OR /pvpzone kit save arena my_kit (save custom kit for arena) 6️⃣ If needed: /pvpzone kit set arena default (assign kit)

Done! When players enter the zone, they'll automatically receive the assigned kit.

---

📁 Plugin Files

---

❓ FAQ

❓ Q: How do I switch between English and Russian?
A: In config.yml, set language: "en" or language: "ru", then run /pvpzone reload.

❓ Q: Can I edit the translation texts?
A: Yes! Edit lang/en.yml or lang/ru.yml directly.

❓ Q: How to add multiple zones with different kits?
A: Create zones with /pvpzone create <name> and assign kits with /pvpzone kit set <zone> <kit_name>.

❓ Q: Duel won't start?
A: Check that you specified an existing zone (or that at least one zone exists). Both players must be online and not in another duel.

---

📌 Requirements

• Server: Paper (or compatible API) 1.21+
• Java: 17+
• Dependencies (included in JAR): SQLite JDBC, BungeeCord Chat, Gson

---

💖 Support

Found a bug? Have a suggestion? Leave a comment on Modrinth or open an issue on our GitHub!

---

⚔️ PvP Zone — Fight, Earn, Upgrade! English 🇺🇸 | Русский 🇷🇺