⚔️ PvP Zone — 用于带有评分系统和决斗的 PvP 竞技场的插件
版本: 1.0.0
核心: Paper 1.21+
Java: 17+
语言: English ?? | Русский ??
? 描述
PvP Zone 是一款适用于 Paper 1.21+ 服务器的插件,它添加了带有评分系统、决斗和奖励商店的 PvP 区域。在区域内,玩家将获得预定义的装备包,退出时恢复其背包内容。该插件支持两种语言:英语和俄语。
| 功能 |
描述 |
| ? 评分系统 |
通过击杀和决斗胜利获得积分 |
| ? 奖励商店 |
使用积分兑换临时增益效果 |
| ? 领袖特效 |
排名第一的玩家会留下火焰足迹 |
| ? 双语支持 |
可在配置文件中切换英语和俄语 |
? 安装
| 步骤 |
操作 |
| 1 |
?️ 为 Minecraft 1.21+ 安装 Paper(或兼容分支) |
| 2 |
? 从 Modrinth 下载最新的 PvP Zone |
| 3 |
? 将 JAR 文件放入服务器的 plugins 文件夹中 |
| 4 |
? 重启服务器 |
| 5 |
⚙️ 在 plugins/PvpZone/config.yml 中设置你的语言:language: "en" 或 language: "ru" |
?️ 初始设置(管理员)
1️⃣ 创建 PvP 区域
| 步骤 |
命令 |
说明 |
| 1 |
/pvpz1 |
设置区域的一个角点 |
| 2 |
/pvpz2 |
设置对角线方向的另一个角点 |
| 3 |
/pvpzone create <name> |
创建该区域(例如:/pvpzone create arena) |
✅ 区域已保存。默认情况下,它关联到名为 default 的套件。
2️⃣ 创建并将套件分配给区域
你有两种便捷选项:
? 选项 A:所有区域共用一个全局套件(更简单)
- ? 将你的背包装满你想要的物品和盔甲(剑、盔甲、食物等)
- ? 运行:
/pvpkit
- 你当前的背包内容将被保存为 默认 套件(位于
plugins/PvpZone/kit.yml)
- ? 所有区域都将自动使用
default 套件
- 如果你在保存套件之前已经创建了区域,请确保为其分配了套件:
/pvpzone kit set arena default(将 arena 替换为你的区域名称)
? 选项 B:不同区域使用不同的套件
- ?️ 创建一个区域(如步骤 1 所示),例如:
/pvpzone create arena
- ? 为该特定区域准备背包中的物品
- ? 在一个命令中保存套件并将其分配给区域:
/pvpzone kit save arena my_kit —— 将你的背包保存为 my_kit 并分配给区域 arena;或者只需执行:/pvpzone kit save arena —— 以区域的当前套件名称(默认为 default)保存背包内容并进行分配
? 管理套件分配
| 命令 |
描述 |
/pvpzone kit set <zone> <kit_name> |
将已有的装备包分配给一个区域 |
/pvpzone kit save <zone> [kit_name] |
保存当前物品栏为装备包,并将其分配给区域 |
/pvpzone kit info <zone> |
显示已分配给该区域的装备包信息 |
? 存档位置:
plugins/PvpZone/kit.yml(默认套装)
plugins/PvpZone/kits/<name>.yml(自定义套装)
3️⃣ 附加区域命令
| 命令 |
说明 |
/pvpzone list |
列出所有区域 |
/pvpzone info <name> |
区域信息(大小、世界、套装、增益) |
/pvpzone bonuses <name> on|off |
启用或禁用区域内的增益效果 |
/pvpzone reload |
重载配置、区域及语言设置 |
? 语言支持(英语 / 俄语)
在 config.yml 文件最顶部:language: "en" # 英语 或 language: "ru" # 俄语(默认)。修改后,请运行 /pvpzone reload 或重启服务器。
? 翻译文件路径: plugins/PvpZone/lang/en.yml 和 plugins/PvpZone/lang/ru.yml。您可以编辑这些文件来自定义消息内容!
? 完整命令列表
| 命令 |
说明 |
权限 |
/pvpz1 |
设置第一个区域点 |
pvpzone.admin |
/pvpz2 |
设置第二个区域点 |
pvpzone.admin |
/pvpkit <name> |
将当前物品栏保存为指定名称的套装 |
pvpzone.admin |
/pvpzone list |
列出所有区域 |
— |
/pvpzone create <name> |
基于坐标点创建区域 |
pvpzone.admin |
/pvpzone delete <name> |
删除一个区域 |
pvpzone.admin |
/pvpzone info <name> |
查看区域信息(包括使用的套装) |
— |
/pvpsetkit <zone> <kit> |
为指定区域分配选定的套装 |
pvpzone.admin |
/pvpzone kit info <zone> |
显示某区域正在使用的套装 |
pvpzone.admin |
/pvpzone bonuses <zone> on|off |
切换区域内的增益效果 |
pvpzone.admin |
/pvpzone reload |
重载插件及语言设置 |
pvpzone.admin |
/pvptop [page] |
按评分查看玩家排行榜 |
— |
/pvpshop |
打开增益商店 |
pvpzone.shop |
/pvp <player> [zone] |
向玩家发起决斗挑战 |
— |
/pvpaccept |
接受决斗请求 |
— |
/pvpdeny |
拒绝决斗请求 |
— |
/pvpfix |
重置 PvP 状态并恢复物品栏 |
— |
/pvpeffect |
切换领袖特效(火焰脚印) |
— |
? 权限说明
| 权限节点 |
说明 |
pvpzone.use |
使用 PvP 区域(默认:所有人) |
pvpzone.shop |
访问 /pvpshop(默认:所有人) |
pvpzone.admin |
管理员权限:创建区域、套装、设置坐标点、重载插件(默认:OP/管理员) |
pvpzone.* |
拥有插件的所有权限 |
? 游玩指南(玩家篇)
| 操作 |
命令/说明 |
| ? 进入 PvP 区域 |
自动装备 Kit,退出时保存并恢复你的物品栏 |
| ⚔️ 在区域内击杀敌人 |
获得评分和商店点数 |
| ? 挑战某人 |
/pvp <昵称> 或 /pvp <昵称> <区域> |
| ✅ 接受决斗 |
/pvpaccept |
| ❌ 拒绝决斗 |
/pvpdeny |
| ? 消耗积分 | /pvpshop — 购买生命值、速度、跳跃、伤害增益效果 |
| ? 查看排行榜 | /pvptop |
| ? 禁用领袖特效 | /pvpeffect(如果你是第一名且不想留下火焰脚印) |
✅ 快速检查清单:区域 + 套件设置
1️⃣ /pvpz1(第一个角落) 2️⃣ /pvpz2(第二个角落) 3️⃣ /pvpzone create arena(创建区域) 4️⃣ 将所需物品放入你的背包 5️⃣ /pvpkit(保存为默认装备包)或 /pvpzone kit save arena my_kit(为竞技场保存自定义装备包) 6️⃣ 如果需要:/pvpzone kit set arena default(分配装备包)
? 完成! 当玩家进入该区域时,他们将自动获得已分配的装备包。
? 插件文件
| 文件 |
描述 |
config.yml |
主配置文件(语言、区域、加成) |
lang/en.yml |
英文翻译 |
lang/ru.yml |
俄文翻译 |
kit.yml |
默认装备包存储 |
kits/ |
自定义装备包文件夹 |
leader_effect_disabled.yml |
禁用了领袖效果的玩家列表 |
pvpzone.db |
SQLite 数据库(玩家、排名、积分、加成) |
❓ 常见问题
❓ 问:如何切换英文和俄文?
✅ 答:在 config.yml 中设置 language: "en" 或 language: "ru",然后运行 /pvpzone reload。
❓ 问:我可以编辑翻译文本吗?
✅ 答:可以!直接编辑 lang/en.yml 或 lang/ru.yml。
❓ 问:如何添加多个拥有不同装备包的区域?
✅ 答:使用 /pvpzone create <name> 创建区域,并使用 /pvpzone kit set <zone> <kit_name> 分配装备包。
❓ 问:决斗无法开始?
✅ 答:请检查是否指定了存在的区域(或者至少存在一个区域)。两名玩家都必须在线,且未处于其他决斗中。
? 要求
- ?️ 服务器: Paper(或兼容 API)1.21+
- ☕ Java: 17+
- ? 依赖项(包含在 JAR 中):SQLite JDBC, BungeeCord Chat, Gson
? 支持
发现 Bug?有建议?在 Modrinth 上留言或在我们的 GitHub 上提交 Issue!
⚔️ PvP Zone — 战斗,赚取,升级! English ?? | Русский ??
⚔️ 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)
- ? All zones automatically use the
default kit
- 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
- ?️ 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 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 ?? | Русский ??
评论 0
登录后参与评分
还没有评论,来抢沙发吧