PvP zone
PvP Zone lets you create custom arenas! Set your own rating rewards and leader effects. Players get a kit, earn points, buy buffs, and duel others. Easy setup, smooth PvP — build your zone and dominate!
⚔️ 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)
- 🧰 Fill your inventory with the items and armor you want (sword, armor, food, etc.)
- 💾 Run:
/pvpkit- Your current inventory is saved as the default kit (
plugins/PvpZone/kit.yml)
- Your current inventory is saved as the default kit (
- 🌍 All zones automatically use the
defaultkit - If you created your zone before saving the kit, make sure it's assigned:
/pvpzone kit set arena default(replacearenawith your zone name)
🟢 Option B: Different Kits for Different Zones
- 🗺️ Create a zone (as in step 1), e.g.:
/pvpzone create arena - 🎒 Fill your inventory with items for this specific zone
- 💾 Save the kit and assign it to the zone in one command:
/pvpzone kit save arena my_kit— saves your inventory asmy_kitand assigns it to zonearenaOr 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 🇺🇸 | Русский 🇷🇺
