Manual Tournaments

General information
There are numerous automated event solutions available, but only a limited number of manual ones. Sometimes there is a need for a serious tournament with cash prizes, where full control over all aspects, such as kits, settings, and cooldowns, becomes essential. This plugin offers that capability by enabling you to organize fights and full tournament brackets between teams of varying sizes.

Version 1.5 introduces a complete tournament system: single-elimination brackets with team support, configurable prizes, scheduled events, MySQL persistence, PlaceholderAPI expansion, per-player statistics, and a full set of admin controls.

Features

• Single-elimination tournament brackets with auto-advancement and bye handling
• Team tournaments (2v2, 3v3, up to 16 per team)
• Configurable match timeout system (default 15 minutes)
• Prize distribution via console commands on tournament end
• Scheduled tournaments with configurable times and auto-start
• MySQL storage with HikariCP connection pooling (async, non-blocking)
• YAML fallback mode - zero config needed to get started
• YAML-to-MySQL migration command
• 4 Bukkit API events for integration with other plugins
• PlaceholderAPI expansion with 11 placeholders
• Per-player stats tracking (wins, losses, tournaments played)
• Granular permission nodes with per-tournament join restriction
• Interactive bracket GUI - click matches to spectate
• Fully configurable messages via config.yml
• Live scoreboard shown only to participants and spectators
• Confirmation system for destructive commands
• All existing fight modes: team, FFA, queue, team-arena
• Full arena and kit management via GUI and commands

Future plans
Support for future MC versions with bugfixes
New features currently on the waiting list:

• Double-elimination and round-robin bracket formats
• Kit editor with full meta support (BundleMeta, MusicInstrumentMeta, SkullMeta, ArmorMeta)
• Party system for team tournaments
• Translations

Support
The plugin supports versions 1.8 through 1.21, though some features may behave differently across versions:

• Countdown sounds - prior to 1.12 the experience orb was unavailable in the Spigot API
• Spigot - spectators can perform empty hits on entities; sounds aren't cancellable to fighters
• /kit unbreakable - before 1.11 this command will not set items to unbreakable
• Freeze during countdown - optimized for newer versions, less comfortable on older ones

GUI Setup
Use /arena gui, /kit gui, and /settings gui to create arenas, kits, and configure settings intuitively. For full tournament controls use /tournament - see Commands in the Documentation tab for details.

Manual Setup
1. Create arena: /arena create (name)
2. Set team 1 spawn: /arena pos1 (name)
3. Set team 2 spawn: /arena pos2 (name)
4. Set spectator spawn: /arena spectator (name)
Validate all positions: /arena validate (name)
5. Set current arena: /settings current_arena (name)
6. Create kit: /kit create (name)
7. Set current kit: /settings current_kit (name)
8. Start a fight: /fight team (player1) (player2)
For larger teams, first half is team 1, second half is team 2.
Example: /fight team p1 p2 p3 p4 creates 2v2 (p1+p2 vs p3+p4)

Tournament commands (new in 1.5):
/tournament create <name> [maxPlayers] [arena] [kit] [teamSize]
/tournament join|leave|start|cancel
/tournament setprize|spectate|pause|resume|bracket
/tournament stats|history|reload