Enhanced UHC

# Enhanced UHC -# This text is from my github repositorie, avoid all the maven building help. UHC plugin for Minecraft Paper servers. It covers the full match lifecycle: configuration, scenarios, teams, scatter, timers, borders, statistics, scoreboard, Discord announcements, and match ending. ## Features - UHC match management: player scatter, countdown, final heal, PvP activation, timed Nether access, progressive borders, late scatter, 2-minute reconnect grace, and winner announcement. - FFA and team modes with invitations, team chat, cross-team merging for incomplete teams, kick, leave, and disband. - Admin GUIs for configuration and scenarios. - Dedicated `uhc` and `uhc_nether` worlds with automatic creation, configured borders, center PvP cleanup, and internal pre-generation or Chunky integration. - Dynamically toggleable scenarios: CutClean, Timber, FlowerPower, Randomizer, NoFall, SafeMining, Bowless, TimeBomb, Golden Head, SafeLoot, and more. - Configurable scoreboard with match, team, border, and Do Not Disturb placeholders, plus a below-name health and absorption indicator. - Gameplay controls for apple/flint rates, cobweb limits, potions, explosives, anti-burn drops, achievements, hidden commands, and whitelist state. - Optional TAB tablist formatting and Lunar Client Apollo TeamView integration. - Persistent MySQL statistics: kills, deaths, assists, wins, games played, points, Elo, and leaderboards. - Discord announcements for openings and results through a webhook or bot + target channel. - Optional MiniPlaceholders support for exposing statistics and match information. ## Requirements | Component | Version / note | | --- | --- | | Java | 21 | | Maven | 3.9+ recommended | | Server | Paper `1.21.x` (`api-version: 1.21`) | | Database | Optional MySQL, enabled by default in `database.yml` | | Optional plugins | MiniPlaceholders, TAB, Apollo, Chunky, WorldEdit / FastAsyncWorldEdit | The plugin is compiled against `paper-api:1.21.11-R0.1-SNAPSHOT`. ## Build ```bash mvn clean package ``` The production jar is generated in `target/`, for example: ```text target/uhc-1.0.4-SNAPSHOT.jar ``` ## Installation 1. Build the project with Maven. 2. Place the jar in the Paper server's `plugins/` directory. 3. Start the server once to generate the files in `plugins/UHC/`. 4. Configure the generated YAML files, then restart the server. 5. If needed, pre-generate the worlds with `/pregen`. The plugin automatically creates and configures the `uhc` and `uhc_nether` worlds. ## Configuration | File | Purpose | | --- | --- | | `uhc.yml` | Timers, teams, borders, Nether, drops, potions, scatter, late scatter, spectator spawn, gameplay flags, tablist, border wall, and Elo. | | `database.yml` | MySQL connection, assist window, leaderboard size, and refresh interval. | | `discordwebhook.yml` | Discord webhook, bot/channel target, role mention, opening and victory embeds. | | `scoreboard.yml` | Scoreboard title, objectives, and solo/team lines. | | `joinitems.yml` | Items given in the lobby. | | `guis.yml` | Interface labels and slots. | | `items.yml` | Custom item names and lore. | | `messages.yml` | Prefixes and shared messages. | | `language.yml` | Localizable text used by commands and listeners. | | `plugin.yml` | Commands, main permission, and Bukkit/Paper metadata. | By default, `database.yml` contains `mysql.enabled: true`. If no MySQL server is available, either provide valid credentials or set this value to `false`. In memory mode, stats work for the current session but are not persisted. ## Commands The administration permission is `uhc.host` and defaults to `op`. ### Administration | Command | Description | | --- | --- | | `/start` | Starts the match, scatters players, and starts timers. | | `/finish <player>` | Ends the match with a player winner. | | `/finish team <id>` | Ends the match with a team winner. Also accepts `/finish team:<id>`. | | `/configurationAdmin` | Opens the admin configuration GUI. | | `/scenariosadmin` | Opens the scenario administration GUI. | | `/pregen ` | Pre-generates the UHC Overworld and Nether. | | `/pregen stop` | Stops the current pre-generation task. | | `/announce <opening>` | Sends the Discord announcement. Accepted formats: `16h01m`, `16h01min`, `16:01`. | | `/hidden ` | Applies an anonymous identity to a player. | | `/hidden reset ` | Restores the original identity. | | `/statsadmin clear` | Deletes all statistics. | | `/statsadmin undo` | Reverts statistics from the last match. Alias: `/statsadmin undolastgame`. | | `/statsadmin get <player>` | Shows a player's statistics. | | `/statsadmin add <player> <stat> <amount>` | Adds a value to a statistic. | | `/statsadmin remove <player> <stat> <amount>` | Removes a value from a statistic. | | `/statsadmin set <player> <stat> <value>` | Sets a statistic value. | | `/revive <player>` | Revives a player and restores them to the alive counter when possib