MinecraftManhunt

Made by Eric (yoonicode.com)
Minecraft: TildeTildeTilde

Inspired by Dream on YouTube

This project is open-source! View on Github

Something wrong? Plugin broken? Check the FAQ Issues page or report the problem here!

How It Works

Three teams: Hunters, Runners, and Spectators Hunters try to kill the runners before they beat the enderdragon. Runners must beat the enderdragon before they get killed once!

Features

• Compass tracking: Right-click with your compass to choose who to track, then the compass will point to that runner!
• Portal tracking: If a runner is in the nether, the compass will track their last-used portal!
• Teams assignment: Automatically assigns in-game /team to distinguish between players with colors!
• Discord integration: Optionally integrate with Discord for extra features!
  • Auto role assignment: Automatically assign Discord roles according to teams
  • Music player: Automatically (or manually) play music in your Discord voice channel that mirrors the action happening!

Instructions For Use

• Move the .jar to your plugins folder.
• Make sure your config file is up to date and has all the required options (more info down below).
• Assign roles with /speedrunner, /hunter, and /spectator.
• If you want automatic music, type /music auto now.
• Type /start!
• After the headstart period is over, hunters should be able to start tracking runners by selecting someone to track by right-clicking with their compass.

Note: teams are not persistent between server sessions— if you shut down the server you'll have to re-assign teams and type /start again.

Discord Setup Instructions

• • Create a Discord app from the Developer Portal.
  • Add a Bot under the bots tab.
  • Take note of your Client ID (in the General Information tab) and your Token (under the Bot tab).
  • Go to the following link, replacing 123YourClientID456 with your client ID: https://discord.com/oauth2/authorize?scope=bot&client_id=123YourClientID456&permissions=8
    • Select the Discord server to add your bot to.
  • Add your Client ID and Token to the respective fields in the config file.
  • Go to your Discord server, and add the following values to the config file, in accordance with the table above (you can Right Click > Copy ID if you turn on Developer Mode in Discord settings!)
    • the ID of your server
    • the ID of the voice channel you want your music to play in
    • the ID of the hunter, runner, and spectator Discord roles you want to be automatically assigned

  Note: For auto-role-assignment to work, each Discord user's nickname for your Server must be set to their Minecraft username.

Commands

• /speedrunner <username>: Assign speedrunner role
• /hunter <username>: Assign hunter role
• /spectator <username>: Assign spectator role
• /start: Start the match
• /end: End the match
• /compass: Give yourself a compass
• /music: Controls the Discord music
  • /music list: Gets a list of available tracks to play.
  • /music <trackname>: Plays a specific track by nickname and turns off auto-music.
  • /music stop: Stops all music playing and turns off auto-music.
  • /music auto: Turns on auto-music, which plays different tracks based on game events and hunter/runner distance.
  • /music forceupdate: Forces the music to update to match the current hunter/runner distance. Use /music stop first if a special event track is playing.

Configuration Options

Edit the plugins/MinecraftManhunt/config.yml file with the following options:

Game Options

Extra Options

Discord Integration

Note: if any of the role IDs are missing or invalid, no roles will be assigned.

Permissions

Music Queues

Part of the fun of this plugin is learning what each music queue means to get a competitive advantage. Here's a list of what causes each track to play.

Distance

The intensity of the music depends on the distance between the runners and the hunters. Tracks are selected at random from the following categories:

• < 50 blocks away: Chasing
• < 150 blocks away: In Sight
• < 300 blocks away: Stealth
• < 450 blocks away: Approaching
• >= 450 blocks away: Far away

Additionally, there is a set of tracks that play if the runners, but not the hunters, are in the Nether.

Special Events

Special tracks play when events related to the game occur. Some events are:

• The runners mine their first iron ore
• The runners mine a diamond ore
• The hunters craft their first piece of iron armor
• The hunters and runners damage each other
  • "Chase" music plays if the fighters have a combined total of less than two pieces of armor
  • "Fight" music plays if they have more than two pieces of armor
• A hunter dies
• A runner dies
• Both players are in boats
• A runner trades with a Piglin for the first time
• A runner teleports to the end

Troubleshooting

• online-mode in server.properties must be set to true as of version 1.2.4.
• If you are using Discord integration, make sure your server's system clock is set correctly.
• Check the FAQ Issues page, or report a problem on the Issues tab!

Made With

• Bukkit/Spigot plugin library
• JDA: Java Discord Library
• LavaPlayer: Audio Player for Discord