RevivalPVP - 服务器插件
适用于 Paper / Purpur 的插件,可为任何 Minecraft 服务器添加 /pvp 命令。玩家将通过 RevivalPVP 网络匹配对手;实际的对战将在我们的竞技场服务器上进行,对战结束后玩家会被送回你的服务器。
管理员面板:
Discord:
此插件的功能
- 添加
/pvp(通过箱子 GUI 选择装备、范围、排位/非排位模式并进行排队)。
- 添加
/pvpaccept(在聊天中接受好友的对战邀请)。
- 添加
/pvpadmin reload|status|key。
- 每十分钟向 RevivalPVP 后端发送心跳信号,以便
play.revivalsmp.net/pvp/host/dashboard 上的操作员仪表板显示你的服务器已连接。
- 按需从后端获取装备目录,因此新增或重命名装备无需更新插件。
此插件不执行的操作
- 它本身不运行对战。当比赛开始时,玩家会被转移到我们的竞技场服务器 (
pvp.revivalpvp.net),比赛结束后再返回你的服务器。竞技场代码、地图和装备发放逻辑不属于此插件的一部分。
- 它不会在本地存储玩家数据,除了会话缓存之外。统计数据、评级、好友关系和赞助币均保存在后端。
要求
- Minecraft 1.21+ 环境下的 Paper 或其分支(推荐使用 Purpur)。
- Java 21+(如果你使用的是 Minecraft 26.1+,则需要 Java 25)。
- 服务器主机能够访问
api.revivalpvp.net。
- 一个来自 的免费租户密钥 (tenant key)。
安装
-
从 Releases 下载最新的 RevivalPVPServerMod-X.Y.Z.jar。
-
将其放入服务器的 plugins/ 文件夹中。
-
重启服务器。插件将生成默认的 plugins/RevivalPVPServerMod/config.yml。
-
如果尚未注册,请在 进行注册。你将通过电子邮件获得一个租户密钥。
-
编辑 plugins/RevivalPVPServerMod/config.yml 并粘贴密钥:
tenant-key: "rpvp_xxxxxxxxxxxxxxxxxx"
backend-url: "https://api.revivalpvp.net"
origin-server: "yourserver.example.com:25565"
default-scope: "global"
origin-server 是公网可访问你服务器的地址 —— 用于在对战结束后将玩家传回。
-
重启服务器。你应该在控制台中看到以下内容:
[RevivalPVPServerMod] RevivalPVPServerMod enabled — /pvp ready
[RevivalPVPServerMod] Kit catalog refreshed: N kits loaded.
[RevivalPVPServerMod] Dashboard connection registered — plan=free, status=trial.
-
访问你的管理员仪表盘 —— 一旦心跳成功,安装面板会折叠为绿色的“Server connected”横幅。
许可证
PolyForm Shield 1.0.0 —— 详见 ../LICENSE.md 和 ../NOTICE.md。该许可证允许付费 Minecraft 服务器运营商使用(你是 RevivalPVP 服务的客户,而非竞争对手)。许可证限制的是竞争用途 —— 运行 rival 跨服务器 PVP 匹配服务。有关通俗易懂的解释,请参阅 NOTICE.md。
RevivalPVP - Server Mod
Paper / Purpur plugin that adds /pvp to any Minecraft server. Players
queue against opponents from across the RevivalPVP network; the actual
duel runs on our arena server and they're returned to your server when
it ends.
For operators:
Discord:
What this plugin does
- Adds
/pvp (chest GUI to pick kit, scope, ranked/unranked, queue).
- Adds
/pvpaccept (accept a friend's duel invite from chat).
- Adds
/pvpadmin reload|status|key.
- Heartbeats to the RevivalPVP backend every ten minutes so the
operator dashboard at
play.revivalsmp.net/pvp/host/dashboard
shows your server as connected.
- Fetches the kit catalog from the backend on demand, so kit
additions and renames don't require a plugin update.
What this plugin does NOT do
- It does not run duels itself. When a match starts, players are
transferred to our arena server (
pvp.revivalpvp.net) and back to
yours when the match ends. The arena code, maps, and kit-delivery
logic are not part of this plugin.
- It does not store player data locally beyond per-session caches.
Stats, ratings, friends, sponsor coins live on the backend.
Requirements
- Paper or a Paper fork (Purpur recommended) on Minecraft 1.21+.
- Java 21+ (Java 25 if you're on Minecraft 26.1+).
- Internet access from the server host to
api.revivalpvp.net.
- A free tenant key from .
Install
-
Download the latest RevivalPVPServerMod-X.Y.Z.jar from
Releases.
-
Drop it in your server's plugins/ folder.
-
Restart the server. The plugin will generate a default
plugins/RevivalPVPServerMod/config.yml.
-
Sign up at if you haven't
already. You'll get a tenant key by email.
-
Edit plugins/RevivalPVPServerMod/config.yml and paste the key:
tenant-key: "rpvp_xxxxxxxxxxxxxxxxxx"
backend-url: "https://api.revivalpvp.net"
origin-server: "yourserver.example.com:25565"
default-scope: "global"
origin-server is how your server is reachable from the public
internet — used to transfer players back after a duel ends.
-
Restart the server. You should see in the console:
[RevivalPVPServerMod] RevivalPVPServerMod enabled — /pvp ready
[RevivalPVPServerMod] Kit catalog refreshed: N kits loaded.
[RevivalPVPServerMod] Dashboard connection registered — plan=free, status=trial.
-
Visit your operator dashboard — the install panel collapses to a
green "Server connected" banner once the heartbeat lands.
License
PolyForm Shield 1.0.0 — see ../LICENSE.md and
../NOTICE.md. Permissive for paid Minecraft server
operators (you're a customer of the RevivalPVP service, not a
competitor). The license restricts Competing Uses — running a
rival cross-server PVP matchmaking service. See NOTICE.md for the
plain-language rundown.
评论 0
登录后参与评分
还没有评论,来抢沙发吧