MobHunting

MobHunting

MobHunting rewards players for hunting monsters, animals and other players. Rewards, penalties, achievements and special bonuses can be configured to match the economy and gameplay style of each server.

Maintained fork

This project is maintained by Becerritoo and continues the work maintained for many years by Rocologo. The original authors and contributors remain fully credited.

Features

• Configurable money rewards for killing monsters.
• Configurable rewards or penalties for passive animals.
• Player-kill rewards, penalties, money stealing and bounties.
• Special bonuses for skilled or unusual kills.
• Achievements and persistent kill statistics.
• Mob heads and player heads as optional rewards.
• Console commands as achievement rewards or penalties.
• Kill streaks and difficulty-based reward modifiers.
• Mob grinder and farming detection.
• Leaderboards, signs and optional Citizens NPCs.
• Learning mode explaining why a reward was accepted, changed or rejected.
• Per-world and WorldGuard region controls.
• SQLite and MySQL storage.
• PlaceholderAPI support.
• Support for direct economy payments or physical BagOfGold rewards.
• Update checks through reviewed Hangar releases.

Requirements

Paper 1.21.11 is the currently tested server version. Compatibility with other Minecraft versions is not guaranteed unless explicitly listed on a release.

Reserve support remains in the inherited code but was not runtime-tested for this release. Vault is the recommended economy bridge.

Installation

1. Install CustomItemsLib-1.4.0.jar.
2. Install Vault and a compatible economy provider.
3. Optionally install BagOfGold-4.8.0.jar for physical currency.
4. Install MobHunting-8.7.1.jar.
5. Start or restart the server.
6. Review plugins/MobHunting/config.yml before enabling rewards for players.

A complete server restart is recommended when installing or updating the plugin stack.

Rewards and penalties

Every supported mob type can have its own configurable reward. Positive values reward the player, while negative values can be used as penalties.

This allows server administrators to:

• Reward hostile-mob hunting.
• Penalize the killing of protected or passive animals.
• Disable rewards for selected mobs.
• Adjust rewards by world or difficulty.
• Run console commands as special rewards.
• Give items, permissions or other server-specific benefits.

Special kill bonuses

MobHunting can increase rewards when players use particular techniques. Available mechanics include bonuses for:

• Fighting without a weapon.
• Long-range sniper kills.
• Returning a Ghast fireball.
• Making a mob fall to its death.
• Killing mobs while mounted.
• Causing one mob to kill another.
• Maintaining a kill streak.
• Other configurable combat conditions.

Bonuses can be adjusted or disabled in the configuration.

Achievements and skull collection

Players can unlock achievements for killing particular mobs, using selected weapons or completing special types of kills.

Achievements can award money, execute commands or provide other configured benefits. Mob and player heads can also be used as collectible rewards.

Bounties and player hunting

Players can place configurable bounties on other players. When the target is defeated under valid conditions, MobHunting processes the bounty through the configured economy.

Player-kill rewards, penalties and money stealing can be configured or disabled to suit the server's PvP rules.

Grinder protection and learning mode

MobHunting tracks suspicious or repetitive farming activity and can reduce or deny rewards from detected grinding areas.

Learning mode helps players and administrators understand reward decisions, including why a kill did not produce a payment.

Leaderboards and Master MobHunters

Kill statistics can be displayed through leaderboards and signs. With Citizens installed, servers can also use Master MobHunter NPCs to represent leading players.

Worlds and protected regions

MobHunting can be disabled in selected worlds. WorldGuard integration allows administrators to control hunting behavior in individual regions.

This is useful for:

• Spawn areas.
• Creative or minigame worlds.
• Protected towns.
• Arenas.
• Dedicated mob-farming areas.

Optional integrations

MobHunting retains integrations with a large ecosystem of plugins. The current reference environment includes integrations such as:

• BagOfGold and Vault-compatible economies.
• BetterRevive.
• CMILib.
• Citizens.
• EssentialsX.
• InfernalMobs.
• MyPet.
• PlaceholderAPI.
• Towny.
• WorldEdit and WorldGuard.

Some integrations were validated only for loading and clean shutdown, while others received gameplay or regression testing. Additional inherited integrations remain available but have not all been tested on Paper 1.21.11.

See the compatibility report for the current validation status and the list of retired integrations.

Basic commands

• /mobhunt version — Displays the installed version.
• /mobhunt reload — Reloads the configuration.
• /mobhunt update — Checks Hangar for a compatible reviewed release.
• /mobhunt achievements — Displays achievements.
• /mobhunt kills — Displays kill statistics.
• /mobhunt bounty — Manages player bounties.
• /mobhunt learn — Enables or disables learning mode.
• /mobhunt mute — Controls MobHunting messages.
• /mobhunt top — Displays ranking information.

The aliases /mh, /mob and /mobhunt can be used for the main command.

Updates

MobHunting checks Hangar for public, reviewed releases compatible with the server's exact Paper version. Downloaded updates are checked for expected size and SHA-256 before being placed in the server update directory.

Automatic update behavior can be configured or disabled.

Support and source code

• Maintained source code
• Bug reports and feature requests
• Original source code
• Original SpigotMC project

MobHunting was initially created by Schmoller and was later extensively developed and maintained by Rocologo.

If you are an original author or contributor and would like to coordinate maintenance or project access, please contact me through GitHub.