crimsonwarpedcraft / uhc

A simple UHC plugin for Paper and Spigot Minecraft servers.

UHC

A simple UHC plugin!

Features

• Moving configurable world border
• Reset world to first day
• Disable player passive regeneration
• Reset player stats and inventory
• Player health displayed in player list
• Disable totem of undying
• Disable villager damage and trades
• Removed suspicious stew recipe
• Block new players from joining after a game has started

Commands

/uhc start - Starts the game

Permissions

uhc.admin - Allows players to use administrative commands (Default: op)

Contributing

General workflow

1. First, pull any changes from main to make sure you're up-to-date
2. Create a branch from main
   • Give your branch a name that describes your change (e.g. add-scoreboard)
   • Focus on one change per branch
   • Keep your commits small, and write descriptive commit messages
3. When you're ready, create a pull request to main with a descriptive title, and listing any changes made in its description
   • Link any issues that your pull request is related to as well

Example:

Create scoreboard for total points

ADDED - Scoreboard displayed in-game at game end  
CHANGED - Updated `StorageManager` class to persist scoreboard data

After the pull request has been reviewed, approved, and passes all automated checks, it will be merged into main.

Building locally

Thanks to Gradle, building locally is easy no matter what platform you're on. Simply run the following command:

macOS/Linux/Unix/

./gradlew build

Windows

gradlew.bat build

This build step will also run all checks, making sure your code is clean.

uhc's Issues

Thing we want to do

Clear gamePlayers on StartCommand

Create moving world border

Create a world border that can move

Make an event for a player death

Is your feature request related to a problem? Please describe.
Yes, we need the event for other things to work

Describe the solution you'd like
Make a lifeStatusEvent for a player's alive status changing

Describe alternatives you've considered
Make a player death event which detects a player's status changing from alive to dead

Player health scoreboard inconsistent

Describe the bug
When all players are full health and a new player joins, only their health is shown until other players take damage.

Expected behavior
All players' health should be shown at all times.

Disable totems of undying

Disable totems of undying by cancelling all EntityResurrectEvent from Players.

Other thing we want to do

• Part 1
• Part 2

Store player data in UUID map

Store data about the player in the UUID map of players in GameState.

Reset player health and hunger on startup

Implement methods to reset health, food level, and saturation of the player when the start command is run.

Cancel villager trades

Cancel all villager trades with the intent of re-enabling them in the future with custom trades. This can be done by cancelling a PlayerInteractEntityEvent where the type of the entity is an AbstractVillager.

Disable PvP for first day

Is your feature request related to a problem? Please describe.
No, new feature

Describe the solution you'd like
Players should not be able to damage each other until sunrise of the second day

• Send a message when PvP is re-enabled

Fix Player XP Reset

Describe the bug
Player XP is not reset on game start, wrong function used

Expected behavior
Player XP should be set to 0

Disable Trident Zombie spawning

Related to a problem?

• Trident damage is too oppressive

Shrink border when a player dies

Is your feature request related to a problem? Please describe.
No, its a new feature

Describe the solution you'd like
Whenever a player dies the border should shrink

• Border should not shrink if there are only 2 players alive or less

Clear player Effects when startCommand is used

• Check if player has any effects
• Create list of effects
• Remove effects

Add health scoreboard in player list

Add player's health information to the scoreboard that appears upon pressing "tab". The health information should be displayed as hearts.

Additional Info:

• https://www.spigotmc.org/threads/creating-a-scoreboard.156548/?__cf_chl_jschl_tk__=4b6eebbfcf5896ab26e449777db0e96df43e7956-1621884483-0-AW_W5xrW6B267ajm3-vGGP_b1sSl75gp1tHfaT4vpx_U_O5lpeHfp83OcHBwjAPVReLTQrWyG84xPM7z0Q5uDvVpL7zUBNzK1hv211K_SsX78ABX_Po2-cf2moE3ZyMs40YEjbdqYNMMZovPO1BELjBxQKJmPHIvQXxJsts6wSpOtXU35tOZ9BiXvermGRrMd_05GQMbxLwgBiiR_MsiDrk2L6TiV8_vidUOw2-vgeGV5JsXD5-SwQ_ZXpjsCg4yMWY8ABKsXL3OrwPdmZrEchK-vzrAiLfHVFgkVwyyUB1JULbZFIktYud1fuYTXzcLb3CafFM4V1oIYzh3Dgtnm-c90dL_Jhw5e1jgN0tdb4g8d5M3_l5JRXO9Z_N3-cW9KKxO16jGBBB_LRyA5GnUpC9r_cA7aoBUc1ivnaaGeg7H5YNkz3WNtnPp_IXKZMTXlA
• https://www.spigotmc.org/threads/how-can-i-show-the-player-health-in-the-tablist.448121/
• https://www.spigotmc.org/threads/plugin-to-display-a-players-health-on-tab.172276/
• https://hub.spigotmc.org/javadocs/spigot/org/bukkit/scoreboard/Scoreboard.html

Set time to day on game start

Is your feature request related to a problem? Please describe.
Game should start at the beginning of the day

Describe the solution you'd like
Set time to day when start command is used

Prevent villager damage

Prevent all damage events for villagers

Set dead players to spectator

• Listen for UhcDeathPlayerEvent
• Set event player to spectator

Add end command

• End game
• Check if > 2 players alive
• Set all players to creative
• Expand world border
• Send Message

Teleport players away from one another on start

• We want to spread players throughout the initial border size
• We don't really care how far apart they are from one another
• Randomize centered at 0,0

Disable player regeneration

Disable player natural regeneration

Disable end portal

Disable the end portal by cancelling the appropriate PortalCreateEvent based on its PortalCreateEvent.CreateReason.

Reset player inventories on start

Is your feature request related to a problem? Please describe.
Players can collect items before the start of the game and will have an unfair advantage.

Describe the solution you'd like
Player's inventories should be reset.

Create a way to add recipes

Is your feature request related to a problem? Please describe.
Yes, we will need this for God-Apples and potions

Describe the solution you'd like
Have a simple way to add recipes in the future

Disable suspicious stew

Cancel suspicious stew from by removing any crafting recipes containing both mushrooms, a bowl, and any flower (determined by item tags).

Create reasonable bounds on config values (e.g. checking fo negatives, null).

• Compare to gameConfig values
• Send Error if any config is out of bounds

Prevent new players from joining

Prevent new players from joining the game after the game is started. This will consist of a few parts:

• Create a HashSet inside of the GameState class that will store all players in the game.
• Create a storeGamePlayers() method in GameState, store all online players in that Set if the input is true.
• Create a getGamePlayers() method which returns a copy of the HashSet (it has to be a copy otherwise the code that uses it could accidentally modify the data)
• Create a method in GameState named isGamePlayer() to search if a Player is in the Set.
• Create a listener to check if a Player from a PlayerJoinEvent is in the list of online players when the game is running.