SyPVP

SyPVP

A PVP control plugin for Minecraft Purpur/Paper 1.21.x

Features

- Multiple Game Modes - Players can freely enable or disable PVP status - Multiple Game Modes - Use `/pvp` command to open an intuitive settings interface - Multiple Game Modes - Cannot disable PVP for 1 minute after engaging in combat - Multiple Game Modes - Invite players who haven't enabled PVP to battle - Multiple Game Modes - Admin can create PVP arenas and players can host PVP matches - Multiple Game Modes - Players can send server-wide PVP invites - Multiple Game Modes - Auto queue when all arenas are occupied - Multiple Game Modes - Free-for-all, 1vMany, 2vMany, Random 2 Teams, Random 3 Teams

Commands

Player Commands

| Command | Description | Permission | |---------|-------------|------------| | `/pvp` | Open PVP settings GUI | `sypvp.use` | | `/sypvp` | Alias for `/pvp` | `sypvp.use` | | `/pvpinvite <player>` | Invite a player to enable PVP | `sypvp.use` | | `/svp send <count>` | Send server-wide PVP invite | `sypvp.use` |

Admin Commands

| Command | Description | Permission | |---------|-------------|------------| | `/sypvp set pvp <id>` | Create PVP arena with stone hoe selection | `sypvp.admin` | | `/sypvp remove pvp <id>` | Remove a PVP arena | `sypvp.admin` | | `/sypvp list` | List all PVP arenas | `sypvp.admin` |

Permissions

- `sypvp.use` - Allow using PVP related commands (default: true) - `sypvp.admin` - Allow using admin commands (default: op)

Usage

Enable/Disable PVP

1. Type `/pvp` to open the settings interface 2. Click the green wool to enable PVP 3. Click the red wool to disable PVP

Invite Players

When attacking a player who hasn't enabled PVP: 1. The system will prompt "The other player has not enabled PVP" 2. Click the "[Invite player to enable PVP]" button to send an invitation 3. The recipient will receive an invitation message and can click "[Click to open PVP settings]" to enable

Create PVP Arena (Admin)

1. Hold a Right-click 2. Right-click a block to set corner 1 3. Right-click a block to set corner 2 4. Type `/sypvp set pvp <arena-id>` to create the arena

Host a PVP Match (Player)

1. Type `/svp send <invite-count>` to send a server-wide invite 2. Other players can click "[Accept]" or "[Reject]" in the chat message 3. When enough players accept, the team will be teleported to a random arena 4. The host selects the game mode from the GUI 5. Fight until one team remains!

Queue System

If all arenas are occupied when a match starts: - Players will see a "Queueing..." message with a "[Stop Queueing]" button - The system will automatically check for available arenas every 5 seconds - Click "[Stop Queueing]" or type `/sypvp queue stop` to cancel

Game Modes

- Random 3 Teams - Every player fights alone, last one standing wins - Random 3 Teams - One player vs all others - Random 3 Teams - Two players team up against all others - Random 3 Teams - Players are randomly split into 2 teams - Random 3 Teams - Players are randomly split into 3 teams

Configuration

Edit `plugins/SyPVP/config.yml`:

```yaml

Max invites per hour per player

max-invites-per-hour: 5

Max players per PVP game

max-players-per-game: 10 ```

Technical Specifications

- JDK: Purpur/Paper 1.21.x - JDK: Java 21

Installation

1. Download `SyPVP-1.1.0.jar` 2. Place the JAR file into your server's `plugins` folder 3. Restart the server or load the plugin

Data Storage

- `plugins/SyPVP/data.yml` - Players' PVP status settings - `plugins/SyPVP/regions.yml` - PVP arena definitions

Author

Shiyuan