Bukkit

UHC Handler

This plugin will assist server operators in running UHC matches. It implements a 30-minute timer as seen in Mindcrack UHC videos, notifying players of every 30 minute mark (for reference, or for recording needs). It also gives server operators several commands to control the setup and game play.

Commands

/match start - UHC.matchControl - Starts the match by clearing all players' inventories, setting them to full health and saturation, and healing them. Also sets time to day, butchers hostile mobs, and starts match timer.

/match pause - UHC.matchControl - Freezes players in place and disallows placing and breaking of blocks. Also pauses match timer.

/match resume - UHC.matchControl - Unfreezes players and allows placing and breaking of blocks. Also resumes match timer.

/match stop - UHC.matchControl - Stops and Resets match timer.

/match time - UHC.matchTime - Displays current match time to player running the command. Used to check time more precisely than every 30 minutes. By default, enabled for all players, with option to allow based on permissions in config.yml.

/freeze - UHC.freeze - Freezes all non-opped players in place. Used as a toggling command.

/mute - UHC.mute - Mutes all non-opped players to assist in communication from operators. Used as a toggling command.

Permissions

• UHC.admin - Gives user permission to use entire UHC Handler plugin
• UHC.matchControl - Gives user permission to use /match <start|stop|pause|resume>
• UHC.matchTime - Gives user permission to use /match time even if it is disabled in the config.
• UHC.freeze - Gives user permission to use /freeze
• UHC.mute - Gives user permission to use /mute
• UHC.ignoreFreeze - Gives user permissions to move while game is frozen
• UHC.ignoreMute - Gives user permissions to talk while game is muted
• UHC.receiveMute - Sends all messages to user while game is frozen

Configuration File

• BanOnDeath: true
  
  • Controls whether players are banned after dying.

• BanOnDeathDelay: 30
  
  • Controls how long (in seconds) players are allowed to stay on server before being banned after death.

• BanMessage: 'Thanks for playing UHC!'
  
  • Controls what message the user is displayed when banned after dying.

• TimerAnnounce: true
  
  • Controls whether the timer broadcasts messages or not.

• TimerInterval: 30
  
  • Controls how often (in minutes) timer messages are displayed.

• TimerMessage: '%t Minutes Elapsed!'
  
  • Controls what message is displayed when the timer reaches its interval (as defined above). Use '%t' in place of the actual game time.

• AllowMatchTimeCommand: true
  
  • Controls whether players without permissions can use /match time to check how long a match has been going on.

• TimerResolution: 60
  
  • Controls how often your timer checks to see if it needs to display. Make this number lower to get a more precise timer, and higher to use fewer server resources. The number itself represents how often your timer will check to see if it needs to display (in seconds). This will produce a timer that is correct to the nearest [x] seconds.
  • Should be less than or equal to TimerInterval*60.

• ChangeMOTD: true
  
  • Controls whether the plugin changes your server's MOTD based on game progress.

• SetupMOTD: 'Log on now to play UHC!'
  
  • Displays while plugin is loaded, but game is not in progress to players viewing the server from their multiplayer launcher. Only active if ChangeMOTD is enabled.

• RunningMOTD: 'UHC Match in Progress.'
  
  • Displays while plugin is loaded, and game is in progress to players viewing the server from their multiplayer launcher. Only active if ChangeMOTD is enabled.

• ControlLogins: true
  
  • Controls whether the plugin manages player log ins, allowing players to relog, but not allowing players to join after match has begun.

• overwriteFreeze: true
  
  • Controls whether this plugin's freeze controls /freeze commands, or they are allowed to go to other plugins.

YouTube Video Explanation

Future Plans

• Add Functionality to notify admins when players get close to one another.
• Add Functionality to allow for a time-limited match, outputting a message at the end of the game.
• Add Functionality to delay the enabling of PvP for x minutes after match begins.
• Add Option for players to be allowed to spectate/be muted at end of match rather than be banned.
• Add Functionality to scatter players. (Possibly)
• Add Multi-Game Support. (Possibly)
• Add Functionality to remove users banned during match at completion of game to keep ban file clean. (Added in v1.6)
• Fix Issue where players in air when /freeze command is run are kept in air and repeatedly kicked for flying. (Resolved in v1.5.2)
• Change timer message to custom message, controlled in config file. (Added in v1.5)
• Change ban message to custom message, controlled in config file. (Added in v1.5)
• Add Option in Config to disallow use of /match time. (Added in v1.5)
• Resolve Conflict with ghowden's UltraHardcore plugin on /freeze command. (Resolved in v1.4)
• Implement Permissions Nodes. (Added in v1.3)
• Add config file to change time interval. (Added in v1.2)
• Add functionality to send player chat to Ops even when muted. (Added in v1.1)