Manhunt

Native Minecraft Version:

1.16

Tested Minecraft Versions:

1.16

Hi, welcome to my Manhunt plugin! I hope you enjoy it.

NOTE: The previous version numbers were incorrect. We were actually at 1.2 instead of 1.0.2. Same goes for 1.0.1 = 1.1.

Credit to Dream, as this plugin is based off of his Manhunt series.

Guide
- Basic Usage

There are 5 commands that you should know. These are `/startmh`, `/stopmh`, `/speedrunner`, `/hunter` and `/mhconfig`. I will tell you what each of these do;

startmh
Click to expand...

Usage: /startmh [-silent]

`/startmh` starts the manhunt. If the speedrunner or hunter teams are empty it will fail. If you specify the `-silent` tag like this; `/startmh -silent` it won't tell anyone else that the manhunt has started. If there is already an ongoing manhunt it will also fail.

stopmh
Click to expand...

Usage: /stopmh

You can use `/stopmh` to forcefully stop the manhunt. If the manhunt hasn't been started or has already been stopped, it fails.

/speedrunner and /hunter
Click to expand...

Usage: /<teamcmd> <add|remove|addall|reset|get> [player] [-s]

`/speedrunner` and `/hunter` have a few subcommands; `add`, `remove`, `addall`, `reset` and `get`.

add <player>: Adds the specified player to the team.

remove <player>: Removes the specified player from the team.

addall: Adds all players in the server to the team.

reset: Clears the team.

get: Prints the current team to the chat.

Use `-s` as an argument with `add` to automatically move the player to the team. (The player automatically gets removed from the other team)

/mhconfig
Click to expand...

Usage: /mhconfig <key> <value>

You can use this to change a specific value in the configuration.
The current supported keys are;

pointToNetherPortal: If the tracked person is in the nether and the tracking person is in the overworld, should the compass point to the portal of the tracked person?

teamCommandPermission: The permission required to run the `/hunter` and `/speedrunner` commands. "_" means no permission required. (Default)

powerCommandPermission: The permission required to run the `/startmh`, `/stopmh` and `/mhconfig` commands. "_" means no permission required. (Default)

Click to expand...

- Addons

You can use addons to add extra functionality to your manhunt. I will probably do a detailed tutorial on how to code an addon later, but this is just a quick description.

Installing an addon.
Installing an addon is very simple. Every addon should be contained inside of its own regular plugin JAR, which you just put inside of the plugins folder. The Manhunt plugin should automatically load all addons.

How it works & developing one.
The addon loader goes through all plugins and checks or they are annotated with the `@ManhuntAddon` annotation. If so, they check what was inputted in the `value` field, which should be a path to your addon class which extends `MHAddon`. Then, it creates an instance of your class, and links it to your plugin and some other addon management stuff in an `AddonLink`.

Quick example

Folder structure
Click to expand...

com.example.mhaddon

- Main (Plugin class)

- Addon (Addon class)

Click to expand...

com.example.mhaddon.Main code
Click to expand...

Code (Java):

package com.example.mhaddon;

import org.bukkit.plugin.java.JavaPlugin;
import net.orbyfied.manhunt.api.build.ManhuntAddon;

@MHAddonProvider("com.example.mhaddon.Addon")
public class Main extends JavaPlugin {
public void mh_provide(MHPluginManager m) { // OPTIONAL
Bukkit.getConsoleSender()
.sendMessage(ChatColor.YELLOW + "yay it works!");
}
}

com.example.mhaddon.Addon code
Click to expand...

Code (Java):

package com.example.mhaddon;

import net.orbyfied.manhunt.api.build.MHAddon;
import net.orbyfied.manhunt.api.select.CompassInterface.

import org.bukkit.Location;
import org.bukkit.entity.Player;
import org.bukkit.inventory.ItemStack;

import org.bukkit.ChatColor;

public class Addon extends MHAddon {
@Override
public void onCompassUsed(Player by, CompassInterface i, ItemStack compass) {
by.sendMessage(ChatColor.RED + "lol no");
i.setCancelled(this, true);
}
}

This completely useless addon will stop hunters from using their compass.
Click to expand...

- Changelog

1.1

Compass event bugs fixed and signature changed;
There was a bug in the passing of the compass ItemStack to the method, which was fixed and the compass now uses an CompassInterface which allows you to modify the final used values.

Signature changed to:

Code (Java):

void onCompassUsed(Player, CompassInterface, ItemStack)

Click to expand...

Fixed encoding issues;
Since I moved my project over to Gradle it had some encoding issues with special characters like the double arrow (»). These have been resolved thanks to StackOverflow post https://stackoverflow.com/a/34717160/14837740.

1.2

New addon loading / registration system.
On the surface, this may not look like a big change. The old way of registering addons still works, but the `ManhuntAddon` annotation has been changed to `MHAddonProvider`. This allows you to use the `otherAddons` field in the annotation to simply register multiple addons from one plugin. You can now also dynamically register addons by capturing the `MHProviderManager` in a static field when `mh_provide(MHProviderManager)` is invoked, by doing this;

Code (Java):

public static MHProviderManager manager;

public void mh_provide(MHProviderManager m) {
manager = m;
}

public void newAddon() {
manager.loadAddon("com.example.EpicGamerAddon");
}

Prefixed most classes with "MH" to specify that it is a Manhunt related class.
For example; "AddonLink" has been changed to "MHAddonLink".

1.2.1

The MHAddonRegistry now maps all addons to their addons classes, and it actually registers the MHProviderManagers now.

Renamed MHProviderAddonManager to MHProviderManager.

Updated the speedrunner and hunter commands to check for an ongoing game and they now correctly output the current team when using `get`. The `-s` argument has also been fixed for the hunter command and it should now work properly.

Click to expand...

Resources

Manhunt 1.2.1

Recent Updates

Sponsors

Useful Searches

Manhunt 1.2.1

Recent Updates