The Basics

First of all, you will need to download the UHC mod, that is only required on the Minecraft server. Note that the Plasmid API is required for the UHC mod to work.

You will configure the UHC using a data pack. You can learn how to create a data pack on the official Minecraft wiki.

Navigating through the original UHC data pack will help you understand how it all works and what are the default configurations, so it is also a good thing to extract the resources/data folder from the JAR file. In this tutorial you will add our own game with your own data pack. Note: You can always override the original UHC data pack.

Creating a Game Config

Creating the file

Plasmid provides data pack support for the games folder in order to create game configurations through JSON files. You can learn more about it on the Plasmid wiki. The UHC currently provides a single type of game: uhc:uhc and you will use that as well. Then, set up a name using the name or translation key. Now, you need to know about the UHC-required JSON keys.

You CANNOT properly build a game config without the following keys!

players

This custom object (provided by Plasmid) key defines how much players are needed to start the game:

• min - The bare minimum amount of players required for the game to even work. The game won't be able to work if that amount is not reached.
• max - The ideal maximum amount of players required for the game. The game will start automatically when this amount is reached.
• threshold (optional, min by default) - The ideal minimum amount of players.
• countdown (optional)
  • ready_seconds (optional, 30 by default)
  • full_seconds (optional, 5 by default)

"players": {
  "min": 1,
  "threshold": 2,
  "max": 10,
  "countdown": {
    "ready_seconds": 45,
    "full_seconds": 10
}

team_size

This integer key defines the number of players per team. Solo games would have this set to 1, while Duos would be 2.

"team_size": 2

map

This custom object key defines the different map settings.

• dimension (optional, minecraft:overworld by default) - the dimension of the generated world
• settings - the chunk settings of the generated world

"map": {
  "dimension": "minecraft:overworld",
  "settings": "minecraft:overworld",
  "start_size": {
    "min": 200,
    "max": 8000
  },
  "end_size": {
    "min": 15,
    "max": 40
  },
  "shrinking_speed": 0.6,
  "spawn_offset": 50
}