!JManhunt Banner Image

(Try out the latest version of the plugin at server IP: play.alttari.games)

JManhunt

JManhunt is a deeply configurable Paper plugin for 26.2+ Manhunts. It comes with a lean world reset engine, compass tracking, placeholders, statistics, and a variety of built-in actions and custom modifiers. The defaults work out of the box for simple manhunts with a fully tracking compass and gamecycle management.

Key Features

• Deep configurability » Toggle built-in mechanics on or off, or create entirely new gameplay through easy-to-use custom modifiers.
• World reset engine » Grid-based single-world manhunt engine with persistent spiral cell assignment and automatic End resets.
• Compass tracking » Hunter compass with configurable refresh and right-click behavior.
• Placeholders & statistics » Career statistics with PlaceholderAPI support.
• API » Developers may hook into the Manhunt lifecycle through the API.

Challenges

The plugin provides dedicated Custom Modifiers which allow you to easily toggle challenge presets or add ones of your own. While you can implement almost anything natively, the functionality can be extended by hooking Skript (or similar scripting plugins) to your modifiers. All of these options can be accessed in the config.

Default custom modifiers include:

• Speedrunners' speed potion
• Full iron kit
• Regen on kill
• One diamond given on any advancement
• Random item or mob every 60 seconds

and so much more.

If the default (or custom) challenges do not provide enough fun, you can install the JManhunt-Challenges addon for special ones like lucky blocks, one heart, and no jump.

Getting Started 🗺️

1. Install the plugin and restart your server.
2. Start a quick match by running /mh qs. This picks one random speedrunner automatically.
   • Or, to manually assign roles:
     1. Run /mh setplayer <selector> <role> for each player, setting them to HUNTER, SPEEDRUNNER, AFK, or NONE.
     2. Run /mh start.
3. Get World Resets working in three minutes by reading this section.

If you'd like to explore settings, view config.yml in your plugins folder. It may look overwhelming at first. That's when the documentation comes handy.

Documentation

Full documentation is available at the JManhunt documentation site.

Installation

Download the latest release from GitHub or Modrinth and place the jar in your server's plugins/ folder. Restart the server to generate the default configuration files.

Update

When installing a MAJOR update (e.g. v3.8.0 => 4.0.0), back-up your current JManhunt resources folder. This is because major updates may modify things with no backward compatibility. Minor and hotfix releases are safe to update.

Contributing

Contributions are welcome! You may contribute by submitting issues or PRs. See our GitHub README for additional details.

© 2026 jruk8. Licensed under GNU AGPLv3.