PvPRequest Plugin Documentation

Overview

PvPRequest is a Minecraft plugin for Paper servers (version 1.21.5) that allows players to challenge each other to PvP duels. When a challenge is accepted, both players are teleported to designated positions in the arena and returned to their original locations after the duel ends.

Installation

1.Download the plugin JAR file (pvprequest-1.0-SNAPSHOT.jar) 2.Place the JAR file in your server's plugins directory 3.Start or restart your server 4.Set up the arena positions using the /pvppos1 and /pvppos2 commands

Commands For Players Command Usage

/pvpreq Send a PvP request to another player eg: /pvpreq Steve /pvpyes Accept an incoming PvP request eg:/pvpyes /pvpno Decline an incoming PvP request eg:/pvpno

For Admins CommandDescriptionPermissionUsage

/pvppos1Set the position for the player who sends the request at arena (pvprequest.admin) /pvppos2Set the position for the player who accepts the request at arena (pvprequest.admin)

[These two command are editable by the op only and seeting it up is a crucial step Else, both players will be teleported to the spawn (0,64,0) to fight]

Features

Request System: Players can send PvP requests to other online players Accept/Decline: Recipients can accept or decline incoming requests Time Limit: Requests automatically expire after 60 seconds (change this in config.yml) Separate Spawn Positions: Each player spawns at their own designated position in the arena Location Preservation: Players are returned to their original locations after the duel Duel Tracking: Tracks active duels to prevent multiple simultaneous requests Quitting Handling: If a player quits during a duel, the opponent is declared the winner

Workflow

Player A sends a PvP request to Player B using /pvpreq Player B receives a notification with options to accept /pvpyes or decline /pvpno If accepted, Player A is teleported to position 1 and Player B to position 2 After one player dies, both are returned to their original locations The server broadcasts the winner of the duel

##P ermissions

pvprequest.admin - Required to use the /pvppos1 and /pvppos2 commands

Configuration The plugin automatically saves both arena positions when set with /pvppos1 and /pvppos2. No manual configuration is needed. Setting Up Arena Positions

Go to the location where you want the challenger (request sender) to spawn Use the command /pvppos1 to set position 1 Go to the location where you want the opponent (request acceptor) to spawn Use the command /pvppos2 to set position 2

Troubleshooting

Positions not set: If players receive "The PvP arena positions have not been set up yet!" message, an admin needs to use both /pvppos1 and /pvppos2 Permissions: Make sure the admin has the pvprequest.admin permission to set arena positions Player not found: Ensure you're typing the exact player name when sending a request Multiple requests: A player can only have one pending request at a time

Technical Notes

The plugin stores player locations in memory and returns players to these locations after duels Both arena positions are stored in the plugin's config.yml file Pending requests timeout after 60 seconds The plugin handles player disconnects during duels

Limitations

Currently only supports 1v1 duels Only one pair of positions can be set at a time Does not preserve player inventory or status effects

Future Improvements

Multiple arena support , Team duels, Arena selection options , Statistics tracking , Inventory preservation options,