MagicKPvP

插件

· 作者 Malusic

MagicKPvP 是一款基于 Paper 的 Minecraft PvP 插件,支持可配置的套装、自定义物品技能、套装购买以及游戏内套装选择菜单。它通过 Vault 与服务器经济系统提供商进行对接。

0 本站下载 0 关注 更新于 3 天前

需要前置:VaultUnlocked

最新 1.2.4 · 26.3 · Paper / Purpur

一键开服(送7天)

MagicKPvP

为 Paper PvP 服务器提供自定义套装、独特能力和成长系统。


MagicKPvP 将 Paper 服务器转变为套装 PvP 竞技场。套装定义采用纯 YAML 格式:每个物品都可以附魔、拥有属性、描述文本、冷却时间以及一个或多个能力。玩家可以从分页菜单中购买、出售和选择套装,同时通过金币、经验值(XP)、等级、统计数据、排行榜和成就来追踪玩家的进度。

新手引导? wiki 详细介绍了安装、配置以及每种能力的用法。

功能特性

套装与物品

  • 在 items.yml 中定义的多物品套装,支持名称、描述文本、附魔、属性、药水数据、发光效果、unbreakable(不可破坏)物品以及买卖价格。
  • 15 种能力类型:光环、冲刺、召唤物、图腾、诱饵、黑洞、连锁闪电、回溯、沉默等。
  • 基于每个玩家的物品冷却时间(10s、500ms、2m),可选的权限缩减冷却时间以及动作栏倒计时显示。
  • 可选的经验值和击杀要求,满足条件后方可购买套装。
  • 支持 Nexo 物品以使用自定义纹理和模型。

经济与成长

  • 通过命令或分页菜单购买、出售和选择套装,包括预览你尚未拥有的套装(只读模式)。
  • 击杀和伤害贡献奖励金币和经验值,并支持可配置的连杀奖励。
  • 经验值等级与 LuckPerms 组别同步,并提供升级广播通知。
  • 记录击杀数、死亡数、K/D 比、当前及最佳连杀数,缓存排行榜以及带有奖励的自定义成就。

菜单与物品交互

  • 加入游戏和重生时发放套装选择器、统计数据和成就相关物品,这些物品受到保护,防止掉落或存入储物箱。
  • 可配置菜单大小、页数、边框装饰,以及每个套装的槽位和描述文本。
  • 左键点击购买或选择套装,右键点击预览未拥有的套装或出售已拥有的套装。

服务器控制

  • 战斗标记机制阻止 /spawn 传送和套装切换,并对战斗中退出(combat logging)的行为进行惩罚。
  • 出生点传送带有倒计时,加入/重生传送以及执行 /spawn 时重置套装。
  • 竞技场传送器支持随机位置或基于菜单的位置选择,且仅限在出生点区域使用。
  • 套装物品保护,以及可选的非套装物品禁止功能。
  • 使用 WorldGuard 标记的出生点区域会禁用能力和投射物发射。
  • 支持 SQLite 或 MySQL 存储,并通过 /magickpvp reload 实现热重载。

1. 需求

服务器 Paper 1.21.8 或更高版本。该插件需要 Java 21+;Paper 26.x 服务器需要 Java 25+。
必需 Vault
经济功能 一个兼容 Vault 的经济插件
可选 WorldGuard、LuckPerms、PlaceholderAPI、Nexo
  • WorldGuard 添加了 magickpvp-spawn(禁用能力和投射物发射)和 magickpvp-kit-switch 区域标志。
  • 1.21.8 使用 ArmorStand(盔甲架)作为诱饵;1.21.9 及更高版本 使用 Paper 原生的 Mannequin(人体模型)。两者均包含在同一个 JAR 文件中。
  • LuckPerms 是经验值等级功能的必要条件。
  • PlaceholderAPI 暴露了 %magickpvp_...% 占位符。
  • Nexo 允许套装物品使用 Nexo 物品以实现自定义纹理。

2. 安装

  1. 从 Modrinth 下载最新版本,或 从源代码构建。
  2. 安装 Vault 和经济插件。
  3. 将 MagicKPvP-VERSION.jar 放入服务器的 plugins/ 文件夹并启动服务器。
  4. 编辑 plugins/MagicKPvP/ 中生成的文件,然后运行 /magickpvp reload。

默认文件仅在缺失时写入。删除文件将以当前默认值重新生成它。

3. 在游戏中设置出生点并打开菜单:

/magickpvp setspawn
/magickpvp menu

请参阅 wiki 的 配置概览 了解所有选项,以及 创建套装与物品 查看完整的物品语法。

命令

显示所有命令

主命令为 /magickpvp,/mkp 为其别名。/spawn 是 /magickpvp spawn 的快捷方式。

命令 描述 权限
/magickpvp menu 打开套装选择菜单 magickpvp.menu
/magickpvp select <kit> 选择你拥有的套装 magickpvp.select
/magickpvp buy <kit> 购买套装 magickpvp.buy
/magickpvp sell <kit> 出售已购买的套装 magickpvp.sell
/magickpvp info 显示插件信息 magickpvp.info
/magickpvp xp 显示你的经验值和等级进度 magickpvp.xp
/magickpvp xp <add|remove|set> <player> <amount> 修改玩家的经验值 magickpvp.xp.admin
/magickpvp stats [player] 显示你自己的或另一名玩家的统计数据 magickpvp.stats
/magickpvp top [xp|kills|deaths|streak] 显示排行榜 magickpvp.top
/magickpvp kitusage [page] 显示每个套装的购买次数 magickpvp.kitusage
/magickpvp advancements 打开成就菜单 magickpvp.advancements
/magickpvp spawn 或 /spawn 传送至出生点并重置你的套装 magickpvp.spawn
/magickpvp setspawn [x y z] [yaw pitch] 设置出生点 magickpvp.setspawn
/magickpvp arena 打开竞技场菜单或传送至随机位置 magickpvp.arena
/magickpvp arena <set|add|remove> <name> ... 管理竞技场位置 magickpvp.arena.admin
/magickpvp reload 重新加载所有配置文件 magickpvp.reload

权限

显示所有权限
权限 默认值 描述
magickpvp.command 所有人 主命令
magickpvp.menu 所有人 打开套装菜单
magickpvp.select 所有人 选择已拥有的套装
magickpvp.buy 所有人 购买套装
magickpvp.sell 所有人 出售已购买的套装
magickpvp.info 所有人 查看插件信息
magickpvp.xp 所有人 查看自己的经验值
magickpvp.xp.admin 操作员 修改玩家经验值
magickpvp.stats 所有人 查看玩家统计数据
magickpvp.top 所有人 查看排行榜
magickpvp.kitusage 操作员 查看套装购买统计
magickpvp.advancements 所有人 打开成就菜单
magickpvp.spawn 所有人 传送至出生点
magickpvp.setspawn 操作员 设置出生点
magickpvp.arena 所有人 使用竞技场传送
magickpvp.arena.admin 操作员 管理竞技场位置
magickpvp.reload 操作员 重新加载配置
magickpvp.bypass 操作员 忽略套装物品保护
magickpvp.kit.* 无 授予所有套装的所有权
magickpvp.kit.<id> 无 授予单个套装的所有权
magickpvp.admin 操作员 拥有以上所有权限

配置文件

显示所有配置
文件 内容
config.yml 菜单、竞技场模式、出生点、存储、奖励、等级、战斗、冷却时间和物品保护
items.yml 套装、物品和能力;每个顶级键是一个套装 ID
arena.yml 竞技场传送位置
advancements.yml 成就及其奖励
messages.yml 所有面向玩家的消息,使用 MiniMessage 格式

缺失的选项会在启动和 /magickpvp reload 时自动追加;现有内容永远不会被更改。

占位符

显示所有占位符

安装 PlaceholderAPI 后,插件会注册以下占位符:

完整列表请参阅 PlaceholderAPI 参考。

从源码构建

需要 JDK 25 进行构建;插件本身运行在 Java 21+ 上。

git clone https://github.com/malusic23354/MagicKPvP.git
cd MagicKPvP
./gradlew build

生成的插件 JAR 文件位于 build/libs/MagicKPvP-VERSION.jar。

多版本源码布局

  • src/main/kotlin 包含通用插件代码,针对最旧支持的 Paper API(1.21.8)编译。
  • src/versions/1_21_8/Version.kt 包含所有 1.21.8 特定代码(盔甲架诱饵回退方案)。
  • src/versions/1_21_9/Version.kt 包含所有 1.21.9+ 特定代码(原生的假人诱饵)。
  • src/main/kotlin/net/malusic/magickpvp/VersionAPI.kt 包含 VersionAPI,用于检测服务器版本并按类名加载匹配的 VersionAdapter。

要添加另一个版本,请创建 src/versions/<version>/Version.kt,在 build.gradle.kts 中注册源集及其 Paper API 依赖,实现 VersionAdapter,并将新类名添加到 VersionAPI 中的版本范围。每个版本只需一个文件即可;无关的能力保留在通用源集中。

要运行本地测试服务器,请将 Paper JAR 放置在 run/paper.jar,并使用:

./gradlew runServer

支持

  • 文档:
  • Discord:
  • 下载:
  • 问题反馈:

欢迎提交错误报告和拉取请求。报告问题时,请包含你的服务器版本、插件版本以及相关控制台输出。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源