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. 安装
- 从 Modrinth 下载最新版本,或 从源代码构建。
- 安装 Vault 和经济插件。
- 将
MagicKPvP-VERSION.jar放入服务器的plugins/文件夹并启动服务器。 - 编辑
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 时自动追加;现有内容永远不会被更改。
占位符
从源码构建
需要 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:
- 下载:
- 问题反馈:
欢迎提交错误报告和拉取请求。报告问题时,请包含你的服务器版本、插件版本以及相关控制台输出。
MagicKPvP
Custom kits, unique abilities and progression for Paper PvP servers.
MagicKPvP turns a Paper server into a kit PvP arena. Kits are plain YAML: every item can carry enchantments, attributes, lore, cooldowns and one or more abilities. Players buy, sell and select kits from a paged menu while coins, XP, ranks, stats, leaderboards and advancements track their progress.
New here? The wiki covers installation, configuration and every ability in depth.
Features
Kits and items
- Multi-item kits defined in
items.yml, with names, lore, enchantments, attributes, potion data, glow,unbreakableitems and buy/sell prices. - 15 ability types: auras, dashes, summons, totems, decoys, black holes, chain lightning, rewinds, silences and more.
- Per-player item cooldowns (
10s,500ms,2m), optional permission-based reduction and an action-bar countdown. - Optional XP and kill requirements before a kit can be bought.
- Nexo item support for custom textures and models.
Economy and progression
- Buy, sell and select kits with commands or the paged menu, including read-only previews of kits you do not own.
- Coin and XP rewards for kills and damage contribution, plus configurable kill-streak rewards.
- XP ranks synced to LuckPerms groups, with rank-up broadcasts.
- Kills, deaths, K/D, current and best streaks, cached leaderboards and custom advancements with rewards.
Menus and items
- Kit selector, stats and advancements items given on join and respawn, protected from dropping and storing.
- Configurable menu size, pages, border decoration, and per-kit slot and lore.
- Left click to buy or select, right click to preview an unowned kit or sell an owned one.
Server control
- Combat tagging blocks
/spawnand kit switching, with a punishment for combat logging. - Spawn teleport with countdown, join/respawn teleport and a kit reset on
/spawn. - Arena teleporter with random or menu-based spot selection, restricted to spawn.
- Kit-item protection and optional non-kit item prevention.
- Spawn regions flagged with WorldGuard block abilities and projectile launches.
- SQLite or MySQL storage and live reload with
/magickpvp reload.
1. Requirements
| Server | Paper 1.21.8 or newer. The plugin needs Java 21+; Paper 26.x servers need Java 25+. |
| Required | Vault |
| Economy features | A Vault-compatible economy plugin |
| Optional | WorldGuard, LuckPerms, PlaceholderAPI, Nexo |
- WorldGuard adds the
magickpvp-spawn(blocks abilities and projectile launches) andmagickpvp-kit-switchregion flags. - 1.21.8 uses an ArmorStand decoy; 1.21.9 and newer use Paper's native Mannequin. Both are included in the same JAR.
- LuckPerms is needed for XP ranks.
- PlaceholderAPI exposes the
%magickpvp_...%placeholders. - Nexo lets kit items use Nexo items for custom textures.
2. Installation
- Download the latest release from Modrinth or build it from source.
- Install Vault and an economy plugin.
- Drop
MagicKPvP-VERSION.jarinto your server'splugins/folder and start the server. - Edit the generated files in
plugins/MagicKPvP/, then run/magickpvp reload.
Default files are only written when missing. Delete a file to regenerate it with the current defaults.
3. Set spawn and open the menu in game:
/magickpvp setspawn
/magickpvp menu
See the wiki's Configuration Overview for every option, and Creating Kits & Items for the full item syntax.
Commands
Show all commands
The main command is /magickpvp, with /mkp as an alias. /spawn is a shortcut for /magickpvp spawn.
| Command | Description | Permission |
|---|---|---|
/magickpvp menu |
Open the kit selection menu | magickpvp.menu |
/magickpvp select <kit> |
Select a kit you own | magickpvp.select |
/magickpvp buy <kit> |
Buy a kit | magickpvp.buy |
/magickpvp sell <kit> |
Sell a previously purchased kit | magickpvp.sell |
/magickpvp info |
Show plugin information | magickpvp.info |
/magickpvp xp |
Show your XP and rank progress | magickpvp.xp |
/magickpvp xp <add|remove|set> <player> <amount> |
Change a player's XP | magickpvp.xp.admin |
/magickpvp stats [player] |
Show your stats or another player's | magickpvp.stats |
/magickpvp top [xp|kills|deaths|streak] |
Show a leaderboard | magickpvp.top |
/magickpvp kitusage [page] |
Show how often each kit was purchased | magickpvp.kitusage |
/magickpvp advancements |
Open the advancements menu | magickpvp.advancements |
/magickpvp spawn or /spawn |
Teleport to spawn and reset your kit | magickpvp.spawn |
/magickpvp setspawn [x y z] [yaw pitch] |
Set the spawn point | magickpvp.setspawn |
/magickpvp arena |
Open the arena menu or teleport to a random spot | magickpvp.arena |
/magickpvp arena <set|add|remove> <name> ... |
Manage arena spots | magickpvp.arena.admin |
/magickpvp reload |
Reload all configuration files | magickpvp.reload |
Permissions
Show all permissions
| Permission | Default | Description |
|---|---|---|
magickpvp.command |
Everyone | Main command |
magickpvp.menu |
Everyone | Open the kit menu |
magickpvp.select |
Everyone | Select owned kits |
magickpvp.buy |
Everyone | Buy kits |
magickpvp.sell |
Everyone | Sell purchased kits |
magickpvp.info |
Everyone | View plugin information |
magickpvp.xp |
Everyone | View your own XP |
magickpvp.xp.admin |
Operators | Change player XP |
magickpvp.stats |
Everyone | View player stats |
magickpvp.top |
Everyone | View leaderboards |
magickpvp.kitusage |
Operators | View kit purchase statistics |
magickpvp.advancements |
Everyone | Open the advancements menu |
magickpvp.spawn |
Everyone | Teleport to spawn |
magickpvp.setspawn |
Operators | Set the spawn point |
magickpvp.arena |
Everyone | Use the arena teleporter |
magickpvp.arena.admin |
Operators | Manage arena spots |
magickpvp.reload |
Operators | Reload configuration |
magickpvp.bypass |
Operators | Ignore kit item protection |
magickpvp.kit.* |
Nobody | Grants ownership of all kits |
magickpvp.kit.<id> |
Nobody | Grants ownership of one kit |
magickpvp.admin |
Operators | All of the above |
Configuration files
Show all configurations
| File | Contents |
|---|---|
config.yml |
Menu, arena mode, spawn, storage, rewards, ranks, combat, cooldowns and item protection |
items.yml |
Kits, items and abilities; each top-level key is a kit ID |
arena.yml |
Arena teleport spots |
advancements.yml |
Advancements and their rewards |
messages.yml |
Every player-facing message, using MiniMessage |
Missing options are appended automatically on start and /magickpvp reload; existing content is never changed.
Placeholders
Show all placeholders
With PlaceholderAPI installed, the plugin registers placeholders:
The complete list is in the PlaceholderAPI Reference.
Building from source
Requires JDK 25 to build; the plugin itself runs on Java 21+.
git clone https://github.com/malusic23354/MagicKPvP.git
cd MagicKPvP
./gradlew build
The plugin JAR is written to build/libs/MagicKPvP-VERSION.jar.
Multi-version source layout
src/main/kotlincontains the common plugin, compiled against the oldest supported Paper API (1.21.8).src/versions/1_21_8/Version.ktcontains all 1.21.8-specific code (the ArmorStand decoy fallback).src/versions/1_21_9/Version.ktcontains all 1.21.9+-specific code (the native Mannequin decoy).src/main/kotlin/net/malusic/magickpvp/VersionAPI.ktcontainsVersionAPI, which detects the server version and loads the matchingVersionAdapterby class name.
To add another version, create src/versions/<version>/Version.kt, register a source set and its Paper API dependency in build.gradle.kts, implement VersionAdapter, and add the new class name to the version range in VersionAPI. One file per version is enough; unrelated abilities stay in the common source set.
To run a local test server, place a Paper JAR at run/paper.jar and use:
./gradlew runServer
Support
- Documentation:
- Discord:
- Downloads:
- Issues:
Bug reports and pull requests are welcome. When reporting a problem, include your server version, plugin version and the relevant console output.
下载 MagicKPvP
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MagicKPvP
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MagicKPvP
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MagicKPvP
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MagicKPvP
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MagicKPvP
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MagicKPvP
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MagicKPvP
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MagicKPvP
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MagicKPvP
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
自 1.2.3 版本以来的更改。
新增
- 添加了开发者 API(
net.malusic.magickpvp.api.AbilityApi,通过 Bukkit 的服务管理器注册),用于注册自定义能力并通过键覆盖内置能力,支持unregister和get方法。 /magickpvp reset <confirm>会清除所有插件数据:套件、经验值、统计数据、进度以及套件使用记录。在未提供confirm参数时运行/magickpvp reset仅打印警告信息。需要magickpvp.reset权限,该权限默认授予操作员。- 出售确认界面:在菜单中右键点击已拥有的套件将打开一个包含“接受”和“取消”按钮的确认界面,而非直接出售。两个按钮均支持 Nexo 物品。
- 新增消息:
reset-warning和reset-done。 - 添加了 Modrinth 自动版本创建与部署功能
变更
- 出售确认功能在
config.yml中的sell-confirmation下进行配置:可启用或禁用它,修改标题、信息槽位,以及“接受”和“取消”按钮的槽位、材质、Nexo ID、名称和描述。 /magickpvp sell <kit>仍会立即出售;确认界面仅适用于菜单操作。- 由插件注册的能力在该插件被禁用时会自动移除。
升级说明
- 设置
sell-confirmation.enabled: false以保留旧版右键即时出售行为。 reset-warning和reset-done消息会自动添加到现有的messages.yml文件中。sell-confirmation部分不会写入现有的config.yml文件。在你添加该部分之前,将使用内置默认值。
1.2.3 版本以来的变更。
新增
/magickpvp reset <confirm>会清除所有插件数据:套件、经验值、统计信息、进度以及套件使用记录。仅运行/magickpvp reset(不带confirm)只会打印一条警告信息。需要magickpvp.reset权限,该权限默认授予管理员。- 出售确认界面:在菜单中右键点击已拥有的套件将打开一个确认界面,提供接受和取消按钮,而不是立即出售。两个按钮均支持 Nexo 物品。
- 新增消息:
reset-warning和reset-done。 - 添加了 Modrinth 自动版本创建与部署功能。
更改
- 出售确认配置位于
config.yml中的sell-confirmation下:可启用或禁用该功能,修改标题、信息栏位,以及接受和取消按钮的栏位、材质、Nexo ID、名称和描述。 /magickpvp sell <kit>命令仍会立即出售;确认界面仅适用于菜单操作。
升级说明
- 设置
sell-confirmation.enabled: false以保留旧版右键点击即立即出售的行为。 reset-warning和reset-done消息会自动添加到现有的messages.yml文件中。sell-confirmation部分不会写入现有的config.yml文件。在您手动添加该部分之前,将使用内置默认值。
MagicKPvP 1.2.3
新增
/magickpvp help列出玩家有权限使用的子命令。- Nexo 物品支持现已涵盖出生点选择器物品(
menu-item、stats-item、advancements-item)、统计菜单图标及成就图标。在material(或icon)旁边设置nexo: "<id>"。如果无法构建该 Nexo 物品,插件将回退至使用材质。 - 统计菜单图标可在
config.yml中的stats.items.<xp|kills|deaths|kdr|streak|best-streak|advancements>下进行配置。 - 回溯(Rewind)现在是一项限时技能:
- 当设置了回溯点时,它会有一个可选的“激活”状态物品外观,通过技能配置中的
active-material或active-nexo进行设置。 - 当你回溯、死亡或持续时间结束时,该物品会恢复原状。
- 它会发送
rewind-activated和rewind-expiring消息。后者是最后 3 秒的倒计时提示。 - 其冷却时间从计时器结束后开始计算。
- 当设置了回溯点时,它会有一个可选的“激活”状态物品外观,通过技能配置中的
更改
- 缺失的 Nexo 物品现在会在加载时按 ID 仅报告一次,涵盖菜单、统计和成就图标,而不仅仅是套件组件。
- 在
usage消息中添加了help-header消息和help命令说明。 - 版本提升至 1.2.3,涉及构建文件、
paper-plugin.yml以及 README。更新了 README 中关于 Nexo 和构建输出的说明。
修复
- 在死亡、重载和玩家退出时清理回溯计时器和快照。这防止了残留的激活状态物品。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧