SyPVP

# SyPVP v2.0 > A multi-functional PVP plugin for Minecraft 1.21.x Purpur / Paper / Spigot Author: Shiyuan Environment: Java 21 + Spigot API (compatible with Paper / Purpur) --- ## Overview SyPVP provides four core PVP gameplay modes: | # | Feature | Description | |---|---------|-------------| | 1 | **Personal PVP Toggle** | Players can enable/disable their own PVP state at any time; immune to other players' damage when disabled | | 2 | **Ranked Season Mode** | Initiate server-wide PVP invitations via GUI; ranking points are adjusted on settlement | | 3 | **Entertainment PVP Mode** | Same flow as ranked mode, but no points are calculated — purely for fun | | 4 | **OP Activity Mode** | Admins use a stick to select a fixed match region; configurable whether ranking points are counted | --- ## 1. Personal PVP Toggle - Command: `/pvp` or `/sypvp toggle` - When PVP is disabled, the player is immune to damage from other players - When a player **with PVP enabled** attacks a player **with PVP disabled**: - No damage is dealt - The attacker receives a chat message containing a clickable **"Invite to enable PVP"** button - Clicking the button sends the target a message with a clickable **"Click to enable PVP"** button - The target can click the button to enable their own PVP PVP state is persisted to `pvp_states.yml` and survives server restarts. --- ## 2. Ranked Season Mode ### Flow 1. Player runs `/sypvp ranked` to open the GUI panel 2. Select the total number of participants (2 ~ 8, configurable upper bound in config) 3. Click the "Start Invitation" button to broadcast a clickable invitation to the whole server 4. Other players click the **"Click to Join"** button in chat to join the match 5. Invitation is valid for **2 minutes** (configurable); cancelled if not full when expired 6. **When full**: - All participants are teleported to random locations in the main world (ring distribution, range configurable) - Both sides see a Title countdown: `3 → 2 → 1 → Start!` - PVP is auto-enabled during countdown; the match officially begins ### Win/Lose Determination - The **first player to die** loses - Or the **first player to run `/sypvp surrender`** loses - The killer (or the other participant in the match) wins ### Point Settlement | Result | Points Change (default) | |--------|--------------------------| | Win | +25 points | | Lose | -15 points | Points are persisted to `ranking.yml` and viewable via `/sypvp top`. --- ## 3. Entertainment PVP Mode - Command: `/sypvp fun` - The entire flow is identical to the ranked season mode (GUI initiation, countdown, random teleport, death/surrender determination) - **Difference**: No ranking points are adjusted on settlement — entertainment only --- ## 4. OP Activity Mode (Admin Only) ### 1. Obtain the Selection Stick ``` /sypvp opactivity wand ``` Receive a stick named "SyPVP Region Selection Stick". ### 2. Select the Match Region - **Left-click** air/block: set point 1 - **Right-click** air/block: set point 2 The two points define a cuboid region used as the fixed match arena for this activity. ### 3. Start the Activity ``` /sypvp opactivity start <ranked:true|false> ``` - `ranked`: whether to count ranking points (true / false) - `maxPlayers`: max participants (default 2, bounded by config) After starting, participants are teleported to random locations within the selected region for PVP. The flow is the same as ranked mode. --- ## Command Reference | Command | Permission | Description | |---------|------------|-------------| | `/pvp` | `sypvp.use` | Toggle own PVP state | | `/sypvp toggle` | `sypvp.use` | Same as `/pvp` | | `/sypvp ranked` | `sypvp.use` | Open the ranked mode GUI | | `/sypvp fun` | `sypvp.use` | Open the entertainment mode GUI | | `/sypvp surrender` | `sypvp.use` | Surrender the current match | | `/sypvp top ` | `sypvp.use` | View the top n ranking leaderboard (default 10) | | `/sypvp join <id>` | `sypvp.use` | Join the match with the given ID (usually triggered via button click) | | `/sypvp invite <player>` | `sypvp.use` | Invite a player to enable PVP | | `/sypvp accept` | `sypvp.use` | Accept an invitation and enable own PVP | | `/sypvp opactivity wand` | `sypvp.admin` | Obtain the region selection stick | | `/sypvp opactivity start <ranked> ` | `sypvp.admin` | Start an activity in the selected region | | `/sypvp reload` | `sypvp.admin` | Reload the configuration file | `sypvp.admin` permission is owned by OPs by default. --- ## Permission Nodes | Permission | Default | Description | |------------|---------|-------------| | `sypvp.use` | All players | Basic PVP feature usage | | `sypvp.admin` | OP | OP activity mode and reload permission | --- ## Installation 1. Ensure the server is **Minecraft 1.21.x** with Purpur / Paper / Spigot core 2. Ensure the server runs on **Java 21** 3. Place `target/SyPVP-2.0.jar` (or the jar from the release page) into the server's `plugins/` dire