PvP zone

⚔️ PvP Zone — Plugin for PvP Arenas with Rating & Duels

Languages: 1.0.0 Languages: Paper 1.21+ Languages: 17+ Languages: English 🇺🇸 | Русский 🇷🇺

---

📋 Description

two languages 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 | |---------|-------------| | 📊 Bilingual | Earn points for kills and duel victories | | 🛒 Bilingual | Spend points on temporary buffs | | 🔥 Bilingual | The top-rated player leaves fiery footsteps | | 🌍 Bilingual | Switch between English and Russian in config |

---

📦 Installation

| Step | Action | |------|--------| | 1 | 🖥️ Install PvP Zone (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 before 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 | |--------|---------------------| | 🚪 Disable leader effect | Kit auto-equipped, your inventory saved and restored on exit | | ⚔️ Disable leader effect | Earn rating and shop points | | 🤺 Disable leader effect | `/pvp <nickname>` or `/pvp <nickname> <zone>` | | ✅ Disable leader effect | `/pvpaccept` | | ❌ Disable leader effect | `/pvpdeny` | | 🛒 Disable leader effect | `/pvpshop` — buy health, speed, jump, damage buffs | | 📊 Disable leader effect | `/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

- 🖥️ Dependencies Paper (or compatible API) 1.21+ - ☕ Dependencies 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 🇺🇸 | Русский 🇷🇺*