UhcCore

UhcCore
UHC, or Ultra Hardcore, is a classic PvP gamemode in which players or teams fight to be the last one standing in survival mode, with natural health regeneration disabled. The only sources of healing are golden apples, potions and other such items which grant status effects, so players must be careful not to take unnecessary damage!

The original gamemode was invented by the Mindcrack community over 10 years ago, but this plugin adds many new features:

• 40+ scenarios that alter the game in fun ways, with a voting system
  • Nether start
  • Randomized block drops
  • Upside down crafting
  • Dragon rush
  • Superheroes
  • And many more...
• Easy GUI menu for team creation (no commands required)
• Configurable start kits
• Configurable crafting recipes
• Shrinking world border and deathmatch options
• Option to pre-generate worlds to avoid lag during the game
• Option to remove oceans from the terrain generation
• 2:1 nether scale instead of the default 8:1
• And many more can be found in the configuration files...

Downloads
You can download the plugin from either of these sources:

• Spigot plugin page
• Releases on GitLab
• Permalink to latest release
• Snapshot builds

Setup guide
UhcCore can be run on a Spigot-based Minecraft server such as Spigot or Paper for Minecraft versions 1.8.8 to 1.21.10. Note that the plugin is incompatible with world management plugins such as MultiWorld or Multiverse, so you will need to run it on a standalone server.

Setup steps

1. Download the plugin to the plugins/ directory and start the server.
2. Set the enable-uhc option to true in plugins/UhcCore/config.yml (NOTE: This will erase player data, e.g. inventories).
3. Restart the server.
4. Wait for the world to pre-generate (see console output for progress).
5. Your players can now join! The game starts when enough players have joined (according to the configuration file), or when the /start command is issued.

After running the plugin for the first time, configuration files will be generated in the plugins/UhcCore/ directory. Changes can be taken into effect by restarting the server.

Make sure to read the FAQ if you're having trouble, or you can also ask for help on the Discord server.

Community
If you have any questions about the plugin, want to discuss features or bugs, or just chat with the community, feel free to join the UhcCore Discord server!

Submitting feature requests and bug reports
If you have an idea for a new feature, or found a bug that needs to be fixed, you can create an issue at the GitLab repository. Please be as descriptive as possible and include all relevant information, such as error messages and/or server logs when submitting a bug report. You are also welcome to discuss the matter on the Discord server, in the #bugs or #suggestions channel.

Documentation and API
Please see the FAQ for more details:

• "Where can I read more about configuration, commands etc? Is there a wiki?"
  
• "Does UhcCore have an addon API?"
  
• "Can I add my own custom scenarios?"

Contributing
Contributions are highly appreciated and can be sent as merge requests to the GitLab repository! See CONTRIBUTING.md and the FAQ for more details.

Building the plugin from source code
Note: You will need to install a Java Development Kit (JDK) in order to build the source code.

This plugin uses the Gradle build tool. To build the plugin from source code, first open a terminal and navigate to the root directory of the repository. Next, run one of the following commands to build the project depending on your operating system:

Build command on Windows

gradlew build

Build command on Linux and macOS

./gradlew build

After running the build command, you should hopefully see a BUILD SUCCESSFUL message. The resulting plugin JAR file is located in the build/libs/ directory.

Acknowledgments
Special thanks to Mezy and val59000mc, the original authors, who maintained the plugin prior to version 1.20.0. See below for historical reference:

• Mezy's plugin page
  • GitHub repository
• val59000mc's plugin page
  • Archived Bitbucket repository

License

Copyright (C) 2015 Valentin Baert
Copyright (C) 2017-2021 Pieter de Bot and others
Copyright (C) 2022-2025 Odin Dahlström and others

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.