?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
RevivalPVP Server

RevivalPVP Server

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.

2
0
2
0

Compatibility

Minecraft: Java Edition

26.1.x
1.21.x

Platforms

Links

Report issues View source Visit wiki Join Discord server

Tags

Creators

Details

Published 18 hours ago

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: https://play.revivalsmp.net/pvp/host Discord: https://discord.gg/revival-smp

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 https://play.revivalsmp.net/pvp/host.

Install

  1. Download the latest RevivalPVPServerMod-X.Y.Z.jar from Releases.

  2. Drop it in your server's plugins/ folder.

  3. Restart the server. The plugin will generate a default plugins/RevivalPVPServerMod/config.yml.

  4. Sign up at https://play.revivalsmp.net/pvp/host if you haven't already. You'll get a tenant key by email.

  5. 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.

  6. 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.

  7. 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.