Wuhc

A Wsmpcore-powered UHC and Battle Royale addon for Paper 1.21.11.

Wuhc turns a Paper server into a configurable UHC experience with fresh match worlds, Cornucopia starts, custom structures, low-tier randomized loot, kits, scenarios, legendary systems, recipes, and an operator GUI.

Required dependency: Wsmpcore must be installed and enabled before Wuhc starts.

Game modes

Solo Royale
Teams Royale
Civilizations
One Block Royale
One-player administrator test rounds

Match flow

Players join using /wuhc join.
An operator starts the selected mode.
Wuhc creates a fresh match world.
The central chunks are generated through a rate-limited, TPS-aware queue.
Wuhc waits at least 60 seconds — and longer if preparation is still running — before teleporting players.
A flat Cornucopia, custom trees, structures, and starting cages are prepared.
Players begin in glass cages around Cornucopia.
The cage countdown ends, cages open, and the UHC game begins.

UHC gameplay

No natural regeneration
Golden-head support
Player head drops
PvP grace period
Shrinking border
Deathmatch arena
Spectator elimination handling
Safe final-death cleanup
Inventory and PvP-state restoration after games

Structures and world content

Flat Cornucopia arena
Rich Cornucopia chest ring
Ruins
Watchtowers
Manors
Forges
Temples
Legend Shrines
Mineshafts
Battlefields
Custom large Oak, Spruce, and Cherry-style trees

Regular generated chests use a configurable safe low-tier loot pool. By default, every chest has 5–8 random low-tier stacks and excludes iron, gold, diamonds, emeralds, Netherite, golden apples, enchanted gear, tridents, and crossbows.

Kits

Miner
Warrior
Archer
Looter
Trapper

Scenarios

Hastey Boys
SafeLoot
Timber
Backpacks
Bleeding Sweats
No Clean
Friendly Fire
No Fall
Magnetism
Vein Miner
Second Chance
CutClean

Legendary and recipe systems

Wuhc includes configurable legendary items, a custom recipe browser, and a GUI recipe editor.

Operators can open a recipe, hold a replacement item in their main hand, and click an ingredient slot to change the recipe. Changes are saved and recipes re-register immediately.

Main commands

Command	Purpose
`/wuhc`	Open the administrator GUI or see game status
`/wuhc join`	Join the next game queue
`/wuhc leave`	Leave the queue/current game
`/wuhc kit <kit>`	Select a kit
`/wuhc start <mode>`	Start a mode as an operator
`/wuhc stop`	Stop and clean up the active game
`/wuhc recipe`	Open the recipe viewer
`/wuhc backpack`	Open the team backpack when enabled

Configuration GUI

/wuhc includes an All Settings Editor that recursively exposes all config values:

Click booleans to toggle them.
Left/right-click numeric values to adjust them.
Shift-click for larger numeric steps.
Click text and lists, then enter the replacement in chat.
Configure game phases, borders, world generation, Cornucopia, structures, trees, scenarios, kits, loot, recipes, and legendary settings.

Installation

Install Paper 1.21.11 with Java 21.
Install Wsmpcore-1.1.1.jar in plugins/.
Install Wuhc-1.3.4.jar in the same plugins/ directory.
Restart the server.
Use /wuhc as an operator to configure and start games.

Compatibility

Minecraft: 1.21.11
Platform: Paper
Side: Server only
Java: 21
Required dependency: Wsmpcore

Wuhc is designed for configurable custom games and original UHC/Battle Royale experiences.