META MOBHUNTING

This is a fork of the original Rocologo family of plugins to receive support from 1.20.4 and beyond.

This is meant to be used as a full replacement of the original MobHunting. Leave the existing configuration files in tact, and update your jar to the most latest version here.

MobHunting 9.0.5+ is dependent on Meta CustomItemsLib

Version Downloads:

1.21.4+ (Latest):

• Spigot / Paper: Download on SpigotMC through the button above

1.21.1-1.21.3:

• Spigot / Paper : Download here

1.21:

• Spigot: Download here
  
• Paper: Unofficially supported - Download here

1.20.6:

• Spigot: Download here
  
• Paper: NOT SUPPORTED

All earlier versions:

• Spigot: Download here
  
• Paper: Download here

Description

MobHunting adds a new level of fun to hunting monsters, animals or opponents. Now you can get money or even dead players skull from kills, get bonuses for skilled and creative kills, and get special achievements!

Features

• Get Money for killing monsters. (BagOfGold, Gringotts and all Vault supported economies can be used).
  
• Reward / Punish Money from killing mobs/animals.
  
• Give players a Mobhead / Playerhead as a reward.
  
• Steal money from other players pockets
  
• Put a bounty on your enemies and get them killed.
  
• Run a console command as a reward | punishment | Give permission to something.
• Modifiers to increase your income for creative kills
• Many Achievements to collect
• MasterMobHunters (Citizens2) and Signs
• Leaderboards
  
• Holographic Leaderboards
  
• Mob grinder detection and Farm detection
• Rewards, items and xp can be removed if the player cheats.
  
• Heavily customizable
• Language support.
  
• MySQL support is optional
  
• Tested on SpigotMC & PaperSpigot/PaperClip.

Video tutorial


But there is SO much more to discover in this plugin!

Requirements
To use MobHunting, all you need is CustomItemsLib, Vault or Reserve and a compatible economy plugin (f.ex. BagOfGold or Essentials) ProtocolLib is an option, but is strongly recommended, because the user experience is improved.

Bonuses

• Brawler - A bonus for not using a weapon to kill a monster
• FriendlyFire - A bonus for getting another monster to kill another monster
• Mounted - A bonus for killing monsters while riding a horse
• Sniper - A bonus for sniping a monster from 20 or more blocks away
• Pro Sniper -A bonus for sniping a monster from 50 or more blocks away
• Return to Sender - A bonus for returning a ghast fireball to the ghast
• A Shove - A bonus for killing a monster by making it fall to its death
• Just in time - kill a Zombie in early daylight before it burns up. Hurry!
  
• Killstreak - A bonus for killing certain amounts of monsters without getting damaged. You need 5 for 1.5x, 10 for 2x, 20 for 3x. and 40 for 4x.
• Under Cover - A bonus for killing a player while disguised
• Cover Blown - A bonus for killing a player who is disguised
• World Difficulty Bonus - Depending on the World Dificulty (Peaceful, Easy, Normal, Hard) The reward will be multiplided with (0.5, 0.75,1.0, 2.0)

Rank / Group Permission bonuses
You can now give players extra bonus depending on they rank / group permission. Ex give player who has donated or have voted for your server extra reward money. (See permissions)

Achievements
There are many achievements to get from killing monsters. These can be about using specific weapons, using specific techniques, or just killing monsters in special ways

There are more than 20 achievements to get. So get hunting.

At any time your achievements can be viewed with /mobhunt kills or /mobhunt achievements. /mobhunt by default has an alias /mh so you can use /mh kills for ease of use.

Skull Collection
The player can now start his Skull Collection and get new skulls, when he kills new Mobs.

Each time a player kills a Mob there is a chance that a command is run and the player gets a reward. The standard setup is giving skulls once in while. This can be configured in config.yml.

Master MobHunters
Create NPC's showing the Skin of the best MobHunters and create a sign showing the statistics of the Masters. ( more info)
OBS You need Citizens2 to use /mh npc.


Signs can also be redstone powered when the MasterMobHunter (The player) is online on the server. This can be used for a lot of smart features. Powering Lamps, Pistons, Doors and much more. ( See the info page)


DropMoneyOnGroup - RPG Servers
As default the money reward will be dropped on the ground as a Bag of gold, but you can also choose to drop the money reward as a normal Minecraft Item, The killers head or the killed mobs head, or your can disable the drop feature and let the player have the money directly in his pocket. This can be configured in config.yml, check the DropMoneyOnGround section. If you have Gringotts installed, the reward will be paid in Gringott currency.

I you choose to use the Bag of gold as a currency, you can create "Bag of gold signs", where the players can Sell (or buy) Bags of gold. ( More info)


Leaderboards
You can now make Leaderboard to show the Top players! ( more info)
VariationVault has made a Video toturial on YouTube,

The Leaderboards can also be Holographic if you have Holographic Displays or CMI or Holograms installed.


Configuration
MobHunting is ready to use without any configuration, but the default values provided may not be well suited to your server.

What can be changed:

• Base money from monsters can be changed or disabled
• Modifiers can be changed and disabled
• Money from getting achievements can be changed
• Run a concole command as a reward.
  
• Penalty amounts can be changed or disabled

The configuration file (config.yml) is well documented

Run a console command as a reward
You can now run any console command you want as a reward, whenever a player get an achievement. Ex:

axe-murderer: 20.0
axe-murderer-cmd: pex user {player} timed add essentials.fly 600 {world}
axe-murderer-cmd-desc: You are now allowed to use /fly for 600 seconds
or
hunt-begins: 10.0
hunt-begins-cmd: give {player} diamond 5
hunt-begins-cmd-desc: Hi {player} you got 5 diamonds in world {world}

Disabling/Enabling MobHunting

Sometimes you don't want players to get money from killing monsters. You might have a special games world, or want it to be rank based

If you want to disable MobHunting in one or more worlds, you just need to put the worlds names into the 'disabled-in-worlds' list in the configuration file.

general:
disabled-in-worlds: [games,world_nether]

NEW Feature: You can add regions in disabled worlds and set the Worldguard custom flag 'MobHunting allow', to enable MobHunting in a limited area in the world. OR you can disable Mobhunting in a worldguard region with the custom flag 'MobHunting deny'.

Example
/mh region peaceful_area mobhunting deny


If you want to disable MobHunting per player or per rank, you can use the permission:

mobhunting.enable

which every player has by default

Commands and Permissions

You can get a list of every command and permission over here

Compatibility

MobHunting has built in compatibility for the following plugins:

• MythicMobs record kills and get rewards and achievements for killing MythicMobs.
• TARDISWeepingAngels record kills and get rewards and achievements for killing TARDISWeepingAngels.
• Citizens2 - Player does now get a reward if they kill a Sentry or a Sentinel NPC
• CustomMobs record kills and get rewards and achievements when killing CustomMobs.
• MysteriousHalloween Mobs record kills and get rewards when killing a MysteriousHalloween.
• SmartGiants Record kills and Achivements when killing a SmartGiant.
  
• LevelledMobs & LorinthsRpgMobs & Conquestia Mobs & EliteMobs. Get a bonus for killing higher level mobs.
  
• MobStacker / StackMob. You can configure how MobHunting acts on stacked mobs.
• Infernal Mobs. Get higher money rewards for killing Infernal Mobs.
  
• MobArena players don't get rewards when they are in a MobArena.
• PVP Arena players don't get rewards when they are in a PVPArena.
• MinigamesLib / Minigames / disabling MobHunting for a player whenever they enter a minigame.
• MyPet allowing MyPets to help you killing mobs and get the reward when your pet kills a mobs.Your MyPet will be able to pickup rewards if your pet has FARM skills.
  
• WorldEdit can be used when you are creating Leaderboards.
• WorldGuard players don't get rewards if they hide in a regions where 'MOB_DAMAGE deny', also a custom flag 'MobHunting' is added to allow/deny mobhunting in a region.
• Factions / FactionsUUID players don't get rewards when the hide in the SafeZone while killing mobs.
• Towny players don't get rewards for killing mobs in their home town by default.
• Residence players don't get rewards when they have the damage = false flag set in their Residence.
  
• PreciousStones players dont get rewards if they are protected by stones.
  
• Essentials(X) - Player don't get rewards if they are in God Mode or Vanished.
• LibsDisguises, DisguiseCraft & iDisguise - Player get bonuses, Player / Victim is unDisguised when attacked.
• VanishNoPacket. Players don't get rewards if vanished.
• WeaponMechanics / CrackShot - The player will get reduction in the reward is they use a WeaponMechanics/CrackShot weapon. Can be changed to a reward in config.yml
• McMMO / McMMO Classic- The player gets McMMO skill levels for killing mobs.
  
• BattleArena - Player does not get any rewards when playing BattleRewards. Can be disabled in Config.yml
• BossBarAPI & BarAPI: is used for Learning messages.
• TitleManager, ActionAnnouncer & ActionBarAPI: is used for ActionBar & Achievement messages.
• TitleWelcomeMessage & TitleAPI: is used for Achievement messages.
• PlaceHolderAPI. Gives the players new PlaceHolders.
  
• Gringotts. If you are using Gringotts, rewards can be dropped on ground in Gringott currencies.
• ProtocolLib. Is recommended but optional. It is used for making a nice "Pickup Money Animation" even when the Player inventory is full and to show Blacklisted/Whitelisted grinding areas.
• Holograms and Holographic Displays if you want to make Holographic Leaderboards to show the TOP 10 players

If you find a compatibility issue with another plugin please feel free to shoot me a PM with the name of the incompatible plugin, and the reason it is incompatible.

bStats

This plugin utilizes BtoBastian's plugin metrics system, which means that the following information is collected and sent to mcstats.org:

• A unique identifier
• The server's version of Java
• Whether the server is in offline or online mode
• The plugin's version
• The server's version
• The OS version/name and architecture
• The core count for the CPU
• The number of players online
• The bStats version
• Collect information about which plugin hooks is used

If you choose to disable the bStats data collection a warning message will be written in the server console log and a short delay will be introduced.


Bugs
If you find a bug, please create a ticket.

Wishlist
Feel free to add more wishes to the List

API for Developers
You can find information about the MobHuntingAPI here.

Source Code
You can check out the source code over at GitHub

Development Builds
If you want to be on the edge and help testing new versions, you can find development build here.