PvP zone
作者:rebot | 分类:模组
Minecraft 版本: 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11
平台: bukkit paper purpur
标签: game-mechanics minigame social
⚔️ 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 ?? | Русский ??
请登录后举报
暂无评论,抢个沙发吧~