⚔️ 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.

| Feature | Description |
|---------|-------------|
| 📊 Rating System | Earn points for kills and duel victories |
| 🛒 Bonus Shop | Spend points on temporary buffs |
| 🔥 Leader Effect | The top-rated player leaves fiery footsteps |
| 🌍 Bilingual | Switch between English and Russian in config |

📦 Installation

| Step | Action |
|------|--------|
| 1 | 🖥️ Install Paper (or compatible fork) for Minecraft 1.21+ |
| 2 | 📥 Download the latest PvP Zone from Modrinth |
| 3 | 📂 Place the JAR file into your server's plugins folder |
| 4 | 🔄 Restart your server |
| 5 | ⚙️ In plugins/PvpZone/config.yml, set your language: language: "en" or language: "ru" |

🛠️ Initial Setup (Admin)

1️⃣ Creating a PvP Zone

| Step | Command | Description |
|------|---------|-------------|
| 1 | /pvpz1 | Set first corner of the zone |
| 2 | /pvpz2 | Set second corner (diagonally opposite) |
| 3 | /pvpzone create <name> | Create the zone (e.g., /pvpzone create arena) |

✅ 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

| Command | Description |
|---------|-------------|
| /pvpzone kit set <zone> <kit_name> | Assign an existing kit to a zone |
| /pvpzone kit save <zone> [kit_name] | Save inventory as a kit and assign to zone |
| /pvpzone kit info <zone> | Show which kit is assigned to a zone |

📁 Kits are stored in:

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

3️⃣ Additional Zone Commands

| Command | Description |
|---------|-------------|
| /pvpzone list | List all zones |
| /pvpzone info <name> | Zone information (size, world, kit, bonuses) |
| /pvpzone bonuses <name> on\|off | Enable/disable bonuses in zone |
| /pvpzone reload | Reload config, zones, and language settings |

🌐 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

| Command | Description | Permission |
|---------|-------------|------------|
| /pvpz1 | Set first zone point | pvpzone.admin |
| /pvpz2 | Set second zone point | pvpzone.admin |
| /pvpkit <name> | saves the current inventory as a kit with the specified name.| pvpzone.admin |
| /pvpzone list | List all zones | — |
| /pvpzone create <name> | Create a zone from points | pvpzone.admin |
| /pvpzone delete <name> | Delete a zone | pvpzone.admin |
| /pvpzone info <name> | Zone information (including kit) | — |
| /pvpsetkit <zone> <kit> | assigns the selected kit to the specified zone.| pvpzone.admin
| /pvpzone kit info <zone> | Show which kit a zone uses | pvpzone.admin |
| /pvpzone bonuses <zone> on\|off | Toggle bonuses in zone | pvpzone.admin |
| /pvpzone reload | Reload plugin and language | pvpzone.admin |
| /pvptop [page] | Top players by rating | — |
| /pvpshop | Open bonus shop | pvpzone.shop |
| /pvp <player> [zone] | Challenge a player to a duel | — |
| /pvpaccept | Accept a duel request | — |
| /pvpdeny | Decline a duel request | — |
| /pvpfix | Reset PvP state and restore inventory | — |
| /pvpeffect | Toggle leader effect (fiery footsteps) | — |

🔑 Permissions

| Permission | Description |
|------------|-------------|
| pvpzone.use | Use PvP zones (default: everyone) |
| pvpzone.shop | Access /pvpshop (default: everyone) |
| pvpzone.admin | Admin: create zones, kits, set points, reload (default: OP) |
| pvpzone.* | All plugin permissions |

🎮 How to Play (For Players)

| Action | Command/Description |
|--------|---------------------|
| 🚪 Enter a PvP zone | Kit auto-equipped, your inventory saved and restored on exit |
| ⚔️ Kill enemies in zone | Earn rating and shop points |
| 🤺 Challenge someone | /pvp <nickname> or /pvp <nickname> <zone> |
| ✅ Accept duel | /pvpaccept |
| ❌ Decline duel | /pvpdeny |
| 🛒 Spend points | /pvpshop — buy health, speed, jump, damage buffs |
| 📊 Check leaderboard | /pvptop |
| 🔥 Disable leader effect | /pvpeffect (if you're #1 and don't want fiery footsteps) |

✅ 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

| File | Description |
|------|-------------|
| config.yml | Main configuration (language, zones, bonuses) |
| lang/en.yml | English translations |
| lang/ru.yml | Russian translations |
| kit.yml | Default kit storage |
| kits/ | Custom kits folder |
| leader_effect_disabled.yml | Players who disabled leader effect |
| pvpzone.db | SQLite database (players, rating, points, bonuses) |

❓ 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 🇺🇸 | Русский 🇷🇺