Skip to content

Latest commit

 

History

History
147 lines (112 loc) · 7.07 KB

README.md

File metadata and controls

147 lines (112 loc) · 7.07 KB

MINECRAFT MANHUNT

Jenkins build status Donate Subscribe Discord

Crowdin

bStats Players bStats Servers SpigotMC tested server versions

Snyk Vulnerabilities for GitHub Repo

GitHub license GitHub issues GitHub forks GitHub stars GitHub release (latest by date) GitHub all releases GitHub last commit GitHub repo size GitHub top language

wakatime


A unique take on Dream's manhunt game with many features, built from scratch.

All credit for the idea goes to Dream. His Manhunt videos are awesome, and you should check him out.


bStats


Notice

This plugin is out of beta, but there's probably still a lot of bugs! You can help out by testing the latest build on our Jenkins or the latest stable release.


Basic setup

  • Change settings and add hunters/runners with /manhunt settings.
  • If you want to stop the game manually run /manhunt stop.

Info

When the game is started, all other players will be put into spectator, and the hunters will be given a compass that they can use to track the nearest runner. When all runners are dead the hunters win but if one of the runners kills the Ender Dragon the runners win. The runners cannot respawn, but the hunters can. For the rules, check the rulebook (obviously you can make up your own rules if these don't fit your taste).

Features

  • Multiple hunters/runners support
  • SuperVanish/PremiumVanish support
  • Scenarios - Add twists to your game
  • Spectator support
  • Automatic removal of player from game if they disconnect
  • Settings menu

Dependencies

This plugin does not have any dependencies, but it works with SuperVanish or PremiumVanish to hide any spectators who are in vanish from the Manhunt player list.

Contributing

Please report any bugs you find in a GitHub Issue or improve our code and make a pull request! We're always open to suggestions!

API

This plugin has a (somewhat simple and somewhat terrible) API for developers to use. You can start and stop the game and access the list of runners and hunters. See this page for more info.

bStats

We use bStats to track how people use our plugin.

If you don't want bStats to collect data from your server, you can disable it in the bStats config file. This file can be found in the /plugins/bStats/ folder.


Config

The config file is well documented with comments. Just look at the config.yml file in the plugin's folder on your server.

Below are some parts of the default config. More documentation about the config can be found here. On large updates, you might have to delete the config file and let it regenerate.

# Gives runner(s) a head start by giving hunters blindness, slowness, and weakness
# Set to false for a more authentic manhunt.
head-start:
  # Head start enabled?
  enabled: true
  # Length of the head start (in seconds)
  length: 30

# ...

### SCENARIOS ###
scenarios:
  RUNNER_CREATIVE:
    # Runners are set to creative every `time` seconds.
    time: 300
    # Runners can keep creative for `duration` seconds.
    duration: 5
    # ALlow flying while runners in creative?
    allow-fly: false

# ...

### Join Message ###
join-message:
  enabled: true
  noperm: '&aWelcome to this Manhunt server! The game will start shortly.'

# ...

### Language preferences ###
# Set this to one of the supported languages.
# Set this to 'custom' to generate a custom language file.
language: 'en_gb'

# ...

Language

This plugin uses a configurable language system. To use the new prebundled languages, change the language key in the config to one of the following (in order of completeness):

  • en_GB (English UK - default)
  • en_US (English US)
  • pl_PL (Polish)
  • de_DE (German)
  • ko_KR (Korean) [Needs Proof-reading]
  • sv_SE (Swedish) [Incomplete]
  • fr_FR (French) [Incomplete]
  • es_ES (Spanish) [Incomplete]
  • it_IT (Italian) [Incomplete]
  • ja_JP (Japanese) [Incomplete]
  • nl_NL (Dutch) [Incomplete]
  • ru_RU (Russian) [Incomplete]
  • zh_CN (Chinese Simplified) [Incomplete]

This list may be incomplete, so check the Crowdin page for more up-to-date info.

If you natively speak or are fluent in any of these languages then you can help us translate! Just go to this website and start translating: https://crowdin.com/project/minecraft-manhunt

If you want to be a proofreader, join the Discord server then DM radialbog9 on Discord!