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.

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