EpicPvPTournament Wiki
EpicPvPTournament works with a structured tournament flow. Players can join a tournament individually or as a team, depending on the selected event mode. Once the tournament starts, the plugin automatically organizes participants, creates match pairings, teleports players safely, and manages each round until a final winner is determined.The main goal of the tournament system is to remove manual management from server staff while keeping the event fair, stable, and competitive.
Main Features
- Solo PvP tournament system
- 2v2, 3v3, 4v4, and 5v5 team tournament support
- Command-based team creation system
- UltimateClans team validation support
- Automatic team registration
- Match queue system
- Matches are played one by one
- Safe arena and lobby teleport system
- Strong PvP kit system
- Cobweb support during matches
- Anti-abuse protections
- Safe join/quit handling
- Automatic tournament kit cleanup
- Configurable rewards
- Default Turkish language support
- English language file included
- TAB and PlaceholderAPI support
- Paper / Purpur / Leaf 26.1.2 compatible
Installation
- Put the plugin JAR file into your server’s plugins folder.
- Fully restart your server.
- Open the generated EpicPvPTournament folder.
- Set the lobby and arena spawn points.
- Start the tournament.
plugins/EpicPvPTournament/
plugins/EpicPvPTournament*.jar
Delete old plugin files before installing a new version.
First Setup
Set the tournament lobby:/tournament setlobby
Set arena spawn points:
/tournament setspawn1 arena1
/tournament setspawn2 arena1
After this, the tournament system is ready to use.
Solo Tournament Usage
Start a solo tournament:/tournament start
Players can join with:
/tournament join
After the join countdown ends, players are matched automatically and fights begin one by one.
Team Tournament Usage
An admin can start a team tournament with:/tournament start 2v2
/tournament start 3v3
/tournament start 4v4
/tournament start 5v5
After team tournament registration starts, players can create teams.
Create a team:
/tournament team create <teamName>
Short command:
/tournament create <teamName>
Invite a player:
/tournament team invite <player>
Short command:
/tournament invite <player>
Accept an invite:
/tournament team accept <leader>
Short command:
/tournament accept <leader>
View team info:
/tournament team info
Leave your team:
/tournament team leave
Team Tournament Logic
Example:/tournament start 2v2
This starts a 2-player team registration mode.
A player creates a team:
/tournament team create Dragon
Then invites a teammate:
/tournament team invite Steve
The invited player accepts:
/tournament team accept PlayerName
When the team reaches the required size, it is automatically registered and all team members are teleported to the tournament lobby.
At the end of the countdown, if at least 2 full teams are registered, the tournament starts.
UltimateClans Support
The team tournament system supports UltimateClans.Config example:
team-tournament:
require-ultimateclans: true
require-same-ultimateclans-team: true
When enabled:
- Teams cannot be created if UltimateClans is not installed.
- Players who are not in the same clan cannot join the same tournament team.
- Members of the same clan can still fight each other during the tournament.
- Normal UltimateClans protections outside the tournament are not affected.
Kit System
Players receive a PvP kit when their match starts.Default kit includes:
- Netherite armor set
- Protection IV armor
- Sharpness V sword
- Axe
- Bow
- Arrows
- Totems
- Golden Apples
- Enchanted Golden Apples
- Potions
- Cobwebs
Cobweb System
Players can place cobwebs during active matches.Config:
protections:
allow-cobweb-place-in-match: true
auto-remove-cobweb-after-seconds: 12
Cobwebs are automatically removed after the configured time.
Match Protections
The plugin includes several protections to prevent abuse.Protected actions:
- Outside player interference
- Command abuse
- Item dropping
- Item pickup
- Container opening
- Crafting
- Block breaking
- Block placing
- Teleport abuse
- Ender pearl abuse
- Chorus fruit abuse
- Fly abuse
- Creative / spectator mode abuse
- Leaving the server to keep tournament items
- Dropping items on death
- Escaping the arena
Safe Join / Quit Handling
If a player leaves during a match:- Tournament kit items are removed.
- The player is counted as eliminated.
- In team tournaments, the team state is updated safely.
- When the player rejoins, tournament items will not remain in their inventory.
Safe Spawn and Arena Teleport
The teleport system is designed to avoid unsafe spawn issues.The system:
- Centers the player on the block.
- Searches for a safe location if the block below is empty.
- Resets fall distance after teleporting.
- Uses safe arena spawn points.
/tournament setlobby
/tournament setspawn1 arena1
/tournament setspawn2 arena1
Reward System
Tournament rewards are configurable through commands.Example:
rewards:
first:
- "eco give %player% 100000"
- "crate key give %player% legendary 3"
second:
- "eco give %player% 50000"
third:
- "eco give %player% 25000"
Available placeholders:
%player%
%rank%
%round%
In team tournaments, reward commands are given to the champion team members.
Commands
Main command:/tournament
Aliases:
/turnuva
/pvpturnuva
/pvpt
Admin commands:
/tournament start
/tournament start 2v2
/tournament start 3v3
/tournament start 4v4
/tournament start 5v5
/tournament stop
/tournament reset
/tournament reload
/tournament setlobby
/tournament setspawn1 <arena>
/tournament setspawn2 <arena>
/tournament status
/tournament arenas
/tournament participants
/tournament removeplayer <player>
Player commands:
/tournament join
/tournament leave
/tournament team create <teamName>
/tournament team invite <player>
/tournament team accept <leader>
/tournament team leave
/tournament team info
Short team commands:
/tournament create <teamName>
/tournament invite <player>
/tournament accept <leader>
/tournament join <teamName>
Permissions
epicpvptournament.adminepicpvptournament.join
epicpvptournament.leave
epicpvptournament.gui
epicpvptournament.start
epicpvptournament.stop
epicpvptournament.reload
epicpvptournament.setarena
epicpvptournament.bypass
Recommended admin permission:
epicpvptournament.admin
PlaceholderAPI / TAB Support
If PlaceholderAPI is installed, these placeholders can be used:%epicpvp_status%
%epicpvp_players%
%epicpvp_round%
%epicpvp_joined%
%epicpvp_opponent%
These placeholders can be used in TAB, scoreboard, bossbar, or other supported plugins.
Example Tournament Setup
Solo tournament:/tournament setlobby
/tournament setspawn1 arena1
/tournament setspawn2 arena1
/tournament start
Players:
/tournament join
Team tournament:
/tournament start 2v2
Players:
/tournament team create Dragon
/tournament team invite Steve
/tournament team accept PlayerName
When the team is full, it is automatically registered and teleported to the lobby.
Recommended Config
Team tournament:team-tournament:
enabled: true
min-team-size: 2
max-team-size: 5
require-ultimateclans: true
require-same-ultimateclans-team: true
Safe teleport:
protections:
safe-teleport: true
center-spawn-on-teleport: true
search-safe-spawn-radius: 4
Cobweb system:
protections:
allow-cobweb-place-in-match: true
auto-remove-cobweb-after-seconds: 12
Notes
- Spectate system has been removed.
- Losing players are not placed into spectator mode.
- Losing players are safely sent back to the lobby.
- Team tournaments are fully command-based.
- GUI-based team creation has been removed.
- UltimateClans validation can be required for team tournaments.
- It is recommended to delete the old plugin folder when updating from older versions.
Support
For installation help, bug reports, or custom requests, contact your server management team.EpicPvPTournament is designed to make Minecraft PvP tournaments more organized, safe, and competitive.
