Event-PVP-Plugin
运行自定义事件,举办带有物品或金钱赌注的 PvP 决斗,并通过浏览器管理你的设置。Event-PVP-Plugin 将事件、竞技场、装备套件和库存恢复整合在一个插件中。
打造单人生存活动,组织团队战斗,或者让玩家通过可配置规则、奖励和负载进行赌注对战。

自定义事件
- 单人和团队模式: 大乱斗、两队和三队事件。
- 灵活的获胜条件: 最后存活者、物品收集、击杀目标和限时生存。
- 你的竞技场,你的规则: 配置 PvP、饥饿、淘汰、观众以及可选的活动前大厅。
- 七种出生点类型: 单点、随机半径、随机区域、随机立方体、多点、团队出生点和基于命令的出生点。
- 自动调度: 按可配置的时间间隔随机或按顺序轮换事件。
- 奖励与统计: 向获胜者和参与者发放物品或基于命令的奖励。使用 PlaceholderAPI、AJLeaderboards 和 DecentHolograms 显示统计数据。
PvP 赌注
让玩家通过游戏内 GUI 互相挑战,选择竞技场并确定赌注。
- 通过兼容 Vault 的经济系统押注 物品或金钱。
- 使用可配置的装备套件,包括护甲、武器、附魔、副手物品和背包。
- 支持反提议、平局投票、投降和旁观。
- 配置竞技场保护和重复比赛的重置功能。
- 保留持久的支付记录,并为符合条件的离线玩家排队奖励。不确定的支付结果仍可供管理员审查。
在浏览器中配置
Web 配置器为管理员提供了一种可视化的方式来管理设置、事件、世界、装备和库存备份。YAML 文件仍然可用于手动配置。
- 可视化编辑器: 配置事件和套件,使用 Minecraft 纹理预览物品,并检查生成的 YAML。
- 库存备份浏览器: 搜索玩家,检查包含护甲、副手和经验的已保存库存,并在确认目标玩家后恢复选定的备份。
- 恢复概览: 检查库存保护会话和库存管理设置。
- 世界管理: 通过 Multiverse 创建、导入、加载和卸载世界。备份和还原世界,或在明确确认后删除它们。
- 清晰的保存反馈: 查看未保存的更改,重试失败的加载,并处理保存冲突,而不会静默丢弃编辑内容。
- 基于令牌的访问: 在游戏中通过
/eventpvp webtoken生成一次性登录令牌。 - 自定义外观: 调整主题颜色。深色界面支持窄屏、键盘导航和减少运动,并使用本地 SVG 图标和捆绑的原版物品纹理。
- 资源包纹理: 可选择从服务器资源包中导入物品纹理。
面板默认使用端口 8085。其端口、绑定地址和公共 URL 可在 web-config.yml 中配置。为了实现远程访问,请将其置于 HTTPS 反向代理 之后。

库存恢复
使用 InventoryBackup,受管理的事件和对战会在玩家进入前保存其库存,并在会话结束时恢复。持久的会话记录和返回位置支持断开连接和重启后的恢复。
Web 面板提供备份预览和恢复失败信息,以便管理员检查恢复问题。库存恢复依赖于一个兼容且启用的 InventoryBackup 提供程序;它不能替代常规服务器备份。
避免在活动世界和竞技场世界中存在竞争的库存管理器。 如果你有意使用其他插件来管理库存交换,请先检查库存提供程序设置。
七种语言
英文、德文、西班牙文、法文、日文、波兰文和俄文均已包含在游戏界面和 Web 配置器中。缺失的自定义翻译条目将回退到捆绑的英文默认值。
要求
对于当前的 1.1.x 版本:
| 要求 | 版本 / 详情 |
|---|---|
| 服务端 | Purpur, Paper 或 Spigot 26.2 / 26.3 |
| Java | 25 或更高版本 |
| Multiverse-Core | 版本 4 或 5 |
| VaultUnlocked 或 Vault | 安装 其中一个;金钱赌注还需要一个兼容的经济插件 |
| InventoryBackup | 0.2.0 / API 修订版 2 或更高版本 |
此版本不支持 Minecraft 1.21.x 及更早版本、Java 17/21 和 Folia。
可选集成:PlaceholderAPI、AJLeaderboards、DecentHolograms 和 PvPManager。
快速开始
- 将所需的依赖项和
event-pvp-plugin-1.1.3.jar安装到服务器的plugins/文件夹中。 - 启动服务器并检查控制台是否有依赖项或配置错误。
- 以管理员身份在游戏中运行
/eventpvp webtoken。 - 打开消息中显示的 Web 地址,输入令牌并配置你的事件、竞技场和套件。
- 使用
/event start <name>启动事件,或使用/pvpask <player>发送决斗请求。
基本命令
玩家
/event list 列出可用事件
/event join <name> 加入事件
/event leave 离开当前事件
/pvpask <player> 发起 PvP 挑战
/pvpaccept 接受挑战
/pvpdeny 拒绝挑战
/surrender 投降当前比赛
/draw 投票平局
/pvp spectate <player> 旁观决斗
管理员
/eventpvp webtoken 生成网页登录令牌
/eventpvp reload 重载配置文件和语言文件
/event start <name> 启动一个事件
/event stop <name> 停止一个事件
/event forcestart <name> 跳过剩余的加入倒计时
/eventpvp rescue list 列出等待返回或恢复的玩家
/eventpvp payouts list 检查待处理的赔付
更新现有服务器
停止服务器,并在替换 JAR 文件之前备份插件数据。请检查上述当前服务器、Java 及依赖项要求,特别是在从较旧的 Minecraft 版本升级时。
配置迁移会保留现有设置,并在需要更改时创建备份。来自 1.1.2 之前的更新还会引入新的赔付账本:回滚操作需要预先更新的数备份,并审查自更新以来进行的任何赔付。
请参阅 1.0.8 → 1.0.9 的升级指南 以了解旧版依赖项转换,以及 1.1.2 迁移与恢复说明 以获取赔付恢复和回滚详情。
Event-PVP-Plugin
Run custom events, host PvP duels with item or money wagers, and manage your setup from a browser. Event-PVP-Plugin brings events, arenas, equipment kits and inventory recovery together in one plugin.
Build a solo survival event, organize team battles, or let players challenge each other to a wager match with configurable rules, rewards and loadouts.

Custom events
- Solo and team modes: Free-for-all, two-team and three-team events.
- Flexible win conditions: Last player standing, item collection, kill targets and timed survival.
- Your arena, your rules: Configure PvP, hunger, elimination, spectators and an optional pre-event lobby.
- Seven spawn types: Single point, random radius, random area, random cube, multiple points, team spawns and command-based spawning.
- Automatic scheduling: Rotate events randomly or in sequence at configurable intervals.
- Rewards and statistics: Give winners and participants items or command-based rewards. Display statistics with PlaceholderAPI, AJLeaderboards and DecentHolograms.
PvP wagers
Let players challenge each other through an in-game GUI, choose an arena and agree on their stakes.
- Wager items or money through a Vault-compatible economy.
- Use configurable equipment kits with armor, weapons, enchantments, offhand items and inventories.
- Support counter-offers, draw votes, surrender and spectators.
- Configure arena protection and resets for repeatable matches.
- Keep persistent payout records and queue eligible offline rewards. Uncertain payout outcomes remain available for administrator review.
Configure it in your browser
The web configurator gives administrators a visual way to manage settings, events, worlds, equipment and inventory backups. YAML files remain available for manual configuration.
- Visual editors: Configure events and kits, preview items with Minecraft textures, and inspect generated YAML.
- Inventory backup explorer: Search players, inspect saved inventories with armor, offhand and XP, and restore a selected backup after confirming the target player.
- Recovery overview: Inspect inventory-guard sessions and inventory-management settings.
- World management: Create, import, load and unload worlds through Multiverse. Back up and restore worlds, or delete them with explicit confirmation.
- Clear save feedback: See unsaved changes, retry failed loads and handle save conflicts without silently discarding edits.
- Token-based access: Generate a one-time login token in-game with
/eventpvp webtoken. - Custom appearance: Adjust theme colors. The darker interface supports narrow screens, keyboard navigation and reduced motion, with local SVG icons and bundled vanilla item textures.
- Resource-pack textures: Optionally import item textures from your server resource pack.
The panel uses port 8085 by default. Its port, bind address and public URL are configurable in web-config.yml. For remote access, put it behind an HTTPS reverse proxy.

Inventory recovery
With InventoryBackup, managed events and matches save player inventories before entry and restore them when the session ends. Persistent session records and return locations support recovery after disconnects and restarts.
The web panel exposes backup previews and restore failures so administrators can inspect recovery problems. Inventory recovery depends on a compatible, enabled InventoryBackup provider; it does not replace regular server backups.
Avoid competing inventory managers on event and arena worlds. If you intentionally use another plugin to manage inventory swaps, review the inventory-provider settings first.
Seven languages
English, German, Spanish, French, Japanese, Polish and Russian are included for the in-game interface and web configurator. Missing custom translation entries fall back to the bundled English defaults.
Requirements
For the current 1.1.x release:
| Requirement | Version / details |
|---|---|
| Server | Purpur, Paper or Spigot 26.2 / 26.3 |
| Java | 25 or newer |
| Multiverse-Core | Version 4 or 5 |
| VaultUnlocked or Vault | Install one of these; money wagers also require a compatible economy plugin |
| InventoryBackup | 0.2.0 / API revision 2 or newer |
Minecraft 1.21.x and older, Java 17/21 and Folia are not supported by this release.
Optional integrations: PlaceholderAPI, AJLeaderboards, DecentHolograms and PvPManager.
Quick start
- Install the required dependencies and
event-pvp-plugin-1.1.3.jarin your server'splugins/folder. - Start the server and check the console for dependency or configuration errors.
- Run
/eventpvp webtokenin-game as an administrator. - Open the web address shown in the message, enter your token and configure your events, arenas and kits.
- Start an event with
/event start <name>or send a duel request with/pvpask <player>.
Essential commands
Players
/event list List available events
/event join <name> Join an event
/event leave Leave the current event
/pvpask <player> Open a PvP challenge
/pvpaccept Accept a challenge
/pvpdeny Decline a challenge
/surrender Surrender the current match
/draw Vote for a draw
/pvp spectate <player> Spectate a duel
Administrators
/eventpvp webtoken Generate a web login token
/eventpvp reload Reload configuration and language files
/event start <name> Start an event
/event stop <name> Stop an event
/event forcestart <name> Skip the remaining join countdown
/eventpvp rescue list List players awaiting return or recovery
/eventpvp payouts list Inspect pending payouts
Updating an existing server
Stop the server and back up plugin data before replacing the JAR. Check the current server, Java and dependency requirements above, especially when upgrading from an older Minecraft version.
Configuration migrations preserve existing settings and create backups when changes are needed. Updates from before 1.1.2 also introduce a new payout ledger: rolling back requires the pre-update data backup and a review of any payouts made since the update.
See the upgrade guide for 1.0.8 → 1.0.9 for the older dependency transition and the 1.1.2 migration and recovery notes for payout recovery and rollback details.
下载 Event-PVP-Plugin
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Event-PVP-Plugin
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Event-PVP-Plugin
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Event-PVP-Plugin
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Event-PVP-Plugin
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Event-PVP-Plugin
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Event-PVP-Plugin
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Event-PVP-Plugin
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Event-PVP-Plugin
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
[1.1.3] - 2026-10-28
Web 面板布局与可靠性改进。现有的深色/绿色设计、公共 API 端点和配置格式保持不变。
物品栏显示
- 修复不一致的槽位大小、空护甲槽折叠以及溢出物品栏网格的问题。静态加载共享物品栏样式,并对装备编辑器样式进行作用域限制,这样访问编辑器时不再更改备份预览。
- 将主物品栏和快捷栏对齐为九个等宽列;在窄屏上保持物品栏内的水平滚动。
- 在不改变槽位尺寸的情况下定位堆叠数量和附魔指示器。在渲染和计数之前标准化物品栏数据,排除 AIR(空气)、无效槽位和重复条目。
- 仅显示一次装备导出操作。在加载时清除之前的备份数据,并仅对当前加载的备份启用预览操作。
- 使物品提示保持在视口内,并支持焦点、点击和按 Escape 键关闭。
加载、保存与会话
- 取消被取代的玩家和备份请求,并忽略过时的响应。
- 将恢复和删除操作绑定到其原始玩家和备份;在请求挂起期间防止重复提交。
- 按类别跟踪配置加载情况,显示失败并提供重试选项,而不替换其他类别中的编辑内容。不保存加载失败的类别。
- 仅对确认成功的操作保存不可变快照并更新基线。保留保存过程中进行的编辑,并按类别处理部分成功的情况。
- 在所有保存完成后呈现修订冲突;仅在确认后重新加载以丢弃未保存的更改。
- 共享请求处理逻辑,限制读取请求持续时间,在登出时清理读取和状态轮询,并防止旧的写入响应使新登录会话过期。写入操作不会自动重试。
布局、可访问性与本地化
- 改善标题、按钮和通知的换行效果;保持移动端导航位于页面内容之前。
- 约束对话框高度,管理初始焦点和焦点返回,陷阱键盘焦点,并通过现有的关闭处理程序支持 Escape 键。
- 在语言更改期间保留打开的编辑器输入,并在所有七种支持的语言中添加共享面板消息。
Web 查看器设计与交互
- 加深默认背景、面板和卡片的颜色,提高元数据对比度,并使用带有可读标签的纯色主按钮。为自定义强调色派生按钮标签颜色,而不更改已保存的主题值。
- 用共享的本地 SVG 注册表替换外部 Font Awesome 依赖项和装饰性界面表情符号,包括动态渲染的视图和附魔。在所有七种语言中清理界面装饰,同时保留 Minecraft 纹理和用户内容。
- 使所有七个导航目标成为原生的键盘可访问按钮,并带有可访问的当前页面指示器。为编辑器标签页、物品选择器、护甲槽和物品栏编辑添加键盘激活功能,并为图标操作、主题字段和开关提供可访问的名称。
- 同步主题选择器、十六进制字段、加载和重置默认值;修复次要文本配置映射并拒绝无效的颜色值。已保存的主题不会自动迁移。
- 改善窄屏布局,考虑侧边栏中标题高度的换行影响,保持对话框中开关的稳定,并防止通知覆盖对话框操作。保留九个物品栏列和 42 像素的槽位。
- 以无障碍方式宣布保存状态,并尊重减少动效和减少透明度偏好。
验证
- 添加了 18 个 Chromium 回归测试,使用模拟 API 响应覆盖布局、编辑器访问顺序、320/360/768/1024/1440 像素视口、200% CSS 缩放、本地 SVG、键盘物品栏编辑、主题往返、主按钮对比度、减少动效、请求竞争、部分保存、修订冲突、会话生命周期、对话框和本地化。
- 扩展
tools/verify.ps1,增加对共享运行时和物品辅助工具的语法检查,以及通过-BrowserTests可选的浏览器检查。 - 设计更新验证已通过:18 个浏览器测试和 3 个 Web 安全测试。早期的后端验证通过了 447 个 Java 测试;对于此纯前端更新,未重新运行 Java 测试和 JAR 打包。
- 浏览器测试使用固定装置(fixtures);未执行实时服务器物品栏恢复。本次发布未引入新的配置迁移。
[1.1.1] - 2026-09-23
维护版本。更新了对 Minecraft 26.3 的支持,修复了 Web 面板的几处安全漏洞,更新了构建工具链并修正了兼容性文档。你无需迁移任何配置。现有的 web-config.yml 文件仍可正常使用,新选项默认行为与旧版一致。
? 发布亮点
- 支持 Minecraft 26.3: 单个 JAR 现在可以可靠地在 Purpur/Paper 26.2 和 26.3 上运行。
- 加固 Web 面板: 拒绝来自其他来源的请求。现在对请求大小和登录尝试次数有限制,并且 IP 白名单已实际生效。
- 线程安全的 Web 操作: 从面板触发的重载和其他操作现在会在服务器主线程上执行其 Bukkit 工作。
- 现代化构建: 使用最新的 Maven 插件和测试库,移除了旧的构建变通方案。
? 详细变更
1. Minecraft 26.3
- 插件针对
purpur-api 26.3编译时无警告。26.2 与 26.3 之间的 API 差异仅包含新增内容:Material、EntityType、Sound、ItemType、Enchantment或PotionEffectType中没有任何删除项。 - 在 Purpur 26.3 (build 2639) 上测试通过:插件启动、
/eventpvp reload命令及 Web 面板。 api-version仍保持为26.2,因此同一个 JAR 可以在 26.2 和 26.3 服务器上加载。- 新的 Maven profile
mc263针对 26.3 API 进行构建:mvn -Pmc263 package。 - Web 面板图标: 8 个探险地图图标重命名为其最终的 26.3 物品名称:
ABANDONED_CAMP_MAP、BURIED_ANCIENT_CITY_MAP、BURIED_MINESHAFT_MAP、BURIED_TRIAL_CHAMBERS_MAP、JUNGLE_PYRAMID_MAP、OCEAN_MONUMENT_MAP、SWAMP_HUT_MAP、WOODLAND_MANSION_MAP。 - 回退用的
items.texture-source现在指向26.3资源分支,而非1.21。
2. Web 面板安全性
- 不再镜像 CORS 来源: 之前,服务器会将每个
Origin以Access-Control-Allow-Credentials: true反射回去。由于SameSite=Strict忽略端口,同一主机不同端口上的页面(例如地图查看器)可能会利用管理员 Cookie。现在仅接受同源请求以及来自配置的public-url的请求。其他请求将返回 403。 - 请求大小限制: 请求体上限为 2 MB。超出限制的请求将返回 413。请求体中的换行符现在也得以保留。
- 登录速率限制: 每个 IP 每分钟最多允许 10 次登录尝试。超过限制的尝试将返回 429。
- 强制执行
security.allowed-ips: 该选项此前虽有文档说明但从未被检查。空列表仍表示允许所有 IP。 - 尊重
security.required-permission: 此前该权限硬编码为eventpvp.admin.web。 - 新增选项
security.bind-session-to-ip(默认false):会话仅在创建时的 IP 下有效。 - HTTP 服务器使用小型线程池(4 个线程)而非单线程,因此一个缓慢的请求不再阻塞整个面板。
3. 线程安全
/api/reload、切换库存提供者、保存config.yml以及按名称查找玩家等操作,现在都在服务器主线程上执行其 Bukkit 工作,超时时间为 30 秒。此前它们运行在 HTTP 线程上,并与服务器 tick 竞争。
4. 构建与工具
maven.compiler.release=25取代了单独的source/target设置。- 已更新:maven-compiler-plugin 3.15.0、maven-shade-plugin 3.6.2、maven-surefire-plugin 3.5.6、JUnit 5.14.4、Mockito 5.23.0、AssertJ 3.27.7、PlaceholderAPI 2.12.3。PlaceholderAPI 仓库 URL 也已更新。
- 已移除:
- Groovy manifest 变通方案
- 多余的
paper-api 1.21-R0.1-SNAPSHOT测试依赖 - 失效的 Sonatype 和 Spigot 仓库
-Dnet.bytebuddy.experimental=true标志
dependency-reduced-pom.xml不再由 Git 跟踪。
5. 日志记录
event_stats.yml中的损坏条目现在会记录其键名,而不是被静默跳过。MultiverseHelper在解析克隆源失败时会写入调试消息,而不是吞掉错误。
6. 文档
- 修正兼容性矩阵: Paper/Purpur 1.21.x 和 1.20.x 无法加载带有
api-version: 26.2的插件。此外,该插件需要 Java 25 字节码支持和 Adventure 5。目前支持:26.2 和 26.3。 - 修正 Adventure 说明: Adventure 5.2.0 已被阴影化但未重定位。重定位它会破坏接受
Component的 Paper 方法。1.1.0 的说明与此相反。 - README、README_DE 和 Modrinth 描述现已列出正确的服务器版本和 Java 25。
- 新增了关于在 HTTPS 反向代理后运行面板,以及关于
allowed-ips和bind-session-to-ip的说明。
? 质量
| 检查项 | 结果 |
|---|---|
| 单元测试、集成测试和 MockBukkit 测试 | 370 / 370 通过 (新增 10 个) |
| i18n 审计 (D1–D11, console, self-tests) | 干净 |
| 针对 Purpur 26.2 和 26.3 的编译 | 0 警告 |
⚙️ 技术规格
| 组件 | 版本 |
|---|---|
| 插件版本 | 1.1.1 |
| 目标 API | purpur-api:26.2.build.2618-stable (profile mc263: 26.3.build.2639-experimental) |
| api-version | 26.2 |
| 支持的服务器引擎 | Purpur / Paper / Pufferfish 26.2 和 26.3,Spigot 26.2+ |
| Java | 25+ |
| Kyori Adventure | 5.2.0 (阴影化,未重定位) |
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧