# ⚔️ 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 ` | 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 ` | Assign an existing kit to a zone | | `/pvpzone kit save [kit_name]` | Save inventory as a kit and assign to zone | | `/pvpzone kit info ` | Show which kit is assigned to a zone | 📁 **Kits are stored in:** - `plugins/PvpZone/kit.yml` (default kit) - `plugins/PvpZone/kits/.yml` (custom kits) --- ### 3️⃣ Additional Zone Commands | Command | Description | |---------|-------------| | `/pvpzone list` | List all zones | | `/pvpzone info ` | Zone information (size, world, kit, bonuses) | | `/pvpzone bonuses 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 ` | saves the current inventory as a kit with the specified name.| `pvpzone.admin` | | `/pvpzone list` | List all zones | — | | `/pvpzone create ` | Create a zone from points | `pvpzone.admin` | | `/pvpzone delete ` | Delete a zone | `pvpzone.admin` | | `/pvpzone info ` | Zone information (including kit) | — | | `/pvpsetkit ` | assigns the selected kit to the specified zone.| `pvpzone.admin` | `/pvpzone kit info ` | Show which kit a zone uses | `pvpzone.admin` | | `/pvpzone bonuses 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 [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 ` or `/pvp ` | | ✅ **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 ` and assign kits with `/pvpzone kit set `. **❓ 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 🇺🇸 | Русский 🇷🇺*

KonskoeDyplo