UHCMEETUP

UHCMEETUP is a complete UHC deathmatch plugin built for Paper 1.21.11.

Players join a queue, vote for a game mode, receive randomized kits, and fight inside a shrinking world border until only one player or team remains. Every match uses a freshly generated world, so the arena never needs to be reset by hand.

Play classic solo UHC, choose from several team presets, fight entirely in the Nether, or enable Legendary mode with 26 built-in artifacts.

Features

• Solo and team-based UHC deathmatches
• Automatic queue and countdown system
• Mode voting before each match
• Fresh match world generated automatically
• Randomized Tier I, Tier II, and Tier III kits
• Grace period with damage immunity and fire resistance
• Configurable shrinking world border
• Golden heads and kill rewards
• Kill streak announcements
• Player statistics and leaderboards
• Sidebar and tab-list match information
• Tracking compass with a target-selection GUI
• Automatic spectator handling
• Friendly fire protection
• Configurable shields and dropped-item burning
• Configurable game difficulty
• No external plugin dependencies
• No client-side mod required

Game Modes

Overworld

The standard UHCMEETUP experience.

Players fight in a newly generated Overworld using randomized kits, golden heads, tracking compasses, kill rewards, and a continuously shrinking border.

Nether

The entire match takes place in the Nether.

Nether mode includes several gameplay changes:

• Water can be placed in the Nether
• Beds do not explode
• Nether portal travel is blocked
• Natural health regeneration remains disabled
• Players receive food, bottles, sugar, redstone, and a golden head
• Mining three Nether Gold Ore rewards one golden apple
• Custom Nether generation and modified bastion loot

Legendary

A high-power UHC mode built around 26 integrated artifacts.

Every player starts with:

• 40 maximum health — 20 hearts
• Two random artifacts
• Arrows when an artifact bow or crossbow is selected
• Detailed artifact instructions in the item lore
• Action-bar cooldown information
• Vanilla-style hotbar cooldown overlays

Shields are disabled by default in Legendary mode, but this can be changed in the configuration.

Awakened artifacts are not included.

Built-in Artifacts

UHCMEETUP includes all 26 standard artifacts directly inside the plugin:

1. Sculk Crossbow
2. Midas Sword
3. Mjolnir
4. Shadow Blade
5. Reaper Scythe
6. Villager Staff
7. Dragon Katana
8. Excalibur
9. Void Staff
10. Magma Club
11. Shrink Ray
12. Chainsaw Sword
13. Wither Sickles
14. Cloud Sword
15. Hypnosis Staff
16. Emerald Blade
17. Golem Hammer
18. Toxic Crossbow
19. Lich Staff
20. Artemis Bow
21. Poseidon Trident
22. Reinforced Elytra
23. Ravager Horn
24. Freezing Chakram
25. Sculkweaver's Lantern
26. War Pick

Artifact abilities work from either hand where appropriate, ignore teammates, and include visible cooldown feedback.

Solo and Team Presets

Preset	Format	Maximum Players
solo	Free-for-all	64
4x8	4 teams of 8	32
8x4	8 teams of 4	32
32v32	2 teams of 32	64
8x2	8 teams of 2	16
8x1	8-player free-for-all	8
4x4	4 teams of 4	16
4x6	4 teams of 6	24

Players are distributed automatically between teams. Teammates spawn near each other, cannot damage one another, and are excluded from tracking and hostile artifact targeting.

The server capacity automatically follows the selected preset. New connections are rejected when the preset is full.

Match Flow

1. Players enter the queue with /join
2. The countdown begins after enough players join
3. Players vote for Overworld, Nether, or Legendary mode
4. A fresh match world is generated
5. Players receive their kits and grace-period protection
6. The border begins shrinking
7. The last living player or team wins
8. The match world is cleaned up automatically

Operators can skip voting and force a mode when needed.

Player Commands

Command	Description
/join	Join the match queue
/leave	Leave the queue or current match
/vote <overworld|nether|legendary>	Vote for a game mode
/stats [player]	View player statistics
/stats top	View the statistics leaderboard

Administrator Commands

Administrator commands require the uhcmeetup.admin permission, which is granted to operators by default.

Command	Description
/uhc start	Start the normal countdown
/uhc forcestart <mode>	Skip voting and force a game mode
/uhc stop	Stop the current match
/uhc status	View the current match status
/uhc reset	Forcefully reset the match
/uhc reload	Reload the configuration
/uhc teams [preset]	View or change the team preset
/uhc givehead [player] [amount]	Give golden heads
/uhc setmode <mode> [player]	Change a player's game mode

Installation

1. Install Paper 1.21.11 with Java 21.
2. Place the UHCMEETUP JAR inside the server's plugins directory.
3. Start the server once to generate the configuration files.
4. Configure a dedicated lobby world and match world.
5. Restart the server after completing the configuration.

The bundled datapack is installed and validated automatically during startup.

Important: UHCMEETUP deletes and regenerates the configured match world between matches. Never configure your lobby, survival world, or any permanent world as the match world.

Requirements

• Paper 1.21.11
• Java 21
• No external plugin dependencies
• No client-side mod required

The current release includes Simplified Chinese in-game messages.

License

The original UHCMEETUP plugin code is licensed under the MIT License.

Some bundled artifact components retain their original Apache License 2.0 notices and are not relicensed under MIT.