SwagTournaments

SwagTournaments is a flexible tournament and competition framework for Paper, built on SwagAPI. Every tournament is a YAML template: display name, scoring mode, scoring formula, schedule, rewards, and cosmetics all live in one file, so new tournament types are new YAML files, not new code.
Features:
- Template-driven: new tournament types are new YAML files, changes apply with /tadmin reload, no restart
- Four scoring modes: SUM (additive), MAX (personal best), UNIQUE_COUNT (distinct items/locations), FIRST_TO (race to a target, ends early when reached)
- Six tournament types: FISHING, FARMING, COMBAT, MINING, ECONOMY, CUSTOM, each backed by its own scoring engine
- In-house formula evaluator: score-formula supports +, -, *, /, Math.max(), Math.min(), and named variables, no scripting engine, no security surface
- Two scheduling modes: fixed weekly/daily cron slots per template, and a weighted-random auto-rotation pool
- Soft-dependency bridges: SwagFishing and SwagFarming bridges add richer scoring context and suppress overlapping tournaments
- Web editor: a full template, schedule, history, and config SPA mounted on SwagAPI's shared panel
- Discord announcements: start and end embeds (and optional live standings) via SwagAPI's shared event bus for DiscordUtils to pick up
- PlaceholderAPI expansion: 8+ dynamic placeholders for scoreboards and chat, including per-rank top_N_name/top_N_score
- Admin tools: /tournamentadmin for starting, stopping, scoring tournaments, and reloading templates live
- Crash recovery: a tournament left ACTIVE by an unclean shutdown is resumed or properly finalized with rewards on next boot, instead of silently lost
Requirements: Paper 1.21+, Java 21, SwagAPI (hard dependency, SwagTournaments will not enable without it). SwagFishing, SwagFarming, DiscordUtils, Vault, and PlaceholderAPI are all optional.
Requires SwagAPI: https://www.spigotmc.org/resources/swagapi.139376/