✨ Mystic Treasures | HUGE UPDATE | MythicMobs, Oraxen, ItemsAdder support, animations, and teamwork.

✨ Mystic Treasures | HUGE UPDATE | MythicMobs, Oraxen, ItemsAdder support, animations, and teamwork. -----

Ready to give your players a reason to explore the world?

Download Now
225.2 KB .jar

Full Customization everything can be within your tastes
MythicMobs support - spawn your custom mobs and bosses and let your players fight for their lives.
ItemsAdder and Oraxen support
- Use custom items as rewards and give your players unique loot for their effort
- Use custom blocks as treasure chest and make your player's experience even more epic.
Holograms
- You can optionally install DecentHolograms or FancyHolograms for amazing holograms above the treasure.
- It's not mandatory though, you can just edit the basic hologram instead.

Unlimited amount of treasures:
- Have as many treasures as you'd like and set everything to your taste!
- Unlimited rarities with unlimited prizes
- Spawn the treasure wherever you want:
  - Randomly in your world - only in safe locations, inside borders, and outside regions
  - At your current location with /hunt start here
  - In fixed locations set in your config
Treasure Keepers - spawn mobs near the treasure in order to keep it safe
- You can require the players to kill all the mobs before allowing them to claim the treasure. Or not, it's up to you.
- You can make the mobs spawn when a players gets near the treasure or right when it spawns.
- Customize your TreasureKeepers
  - Use MythicMobs
  - Set max health
  - Set armor and equipment (with enchantments)
  - Add potion effects
  - Set custom name
  - Set range (spawn 5 to 10 mobs)
  - Set chance of spawn
No PVP - you disable PVP near the treasure so the players can focus on fighting the mobs. Or you can enable it and let chaos begin.

Treasure Keys - custom keys for every treasure (if you want)
Custom item rewards
- Every items has a chance to be dropped
- Customize your reward - set custom display name and lore
- Every item has an amount interval so players won't receive the same amount of an item every time
- Customize your item's name and lore
Command rewards
- Run commands to give your player all the prizes they'd like
- Set a chance to run the command

Potion effects near the treasure to make the fight more interesting
- You could help the players with regeneration or jump boost, or you could make it harder by giving them blindness and nausea.

Protecting the area against trolling, traps, or destruction
- Disable placing or breaking blocks, placing liquids, or other things that players might try to do in order to keep the competition away.

Prizes
- Give your players any prizes they want with items or commands as reward types.
- Reward only the player that opened the treasure the one who dealt the most damage, or everyone that participated in the hunt.
- Drop the prizes on the ground
- Configurable chance and custom item support!

PlaceholderAPI support - placeholders to show info about the hunt's status in order to integrate with other plugins:
- %mystictreasures_x% - display X coordinates
- %mystictreasures_z% - display Z coordinates
- %mystictreasures_world% - display the world's name
- %mystictreasures_active% - display if the hunt is active
- %mystictreasures_mobs% - display remaining mobs
- %mystictreasures_remaining% - display remaining time
- %mystictreasures_participants% - display how many players have participated so far in the treasure hunt (if enabled, shows the number of players that have killed at least a mob)

Animations
- With 3 different treasure chest animations (for now), amaze your player's eyes.
- When mobs spawn, they rise from the ground to make the fight unforgettable.
- Lightweight, with little to no impact on performance
Flares let your players see the treasure from far away
- Edit the look of the flares to your taste. Want it to be more visible, or less? Just change a few values in the config and you're set.
ActionBar to guide your players to the treasure, and alert them on the time left and the location of the treasure
- Upon getting near the treasure, the info will change to show how many mobs there are left.
- If you'd like, you can activate the 'mob tracker' so that the mobs can't hide from the players.
- Of course, everything is customizable.
Particles and fireworks to enhance the experience of the players.
- All of them are configurable, and they don't affect performance
Lots of settings
- Chance of appearance, minimum online players, duration, and many more settings are available to make this plugin your own.
I want a treasure here - spawn a treasure right where you're standing, or just start a random hunt somewhere on the map
Config updater sets the config to the newest values for you.
No fly zone
- Deny flying near treasures, without the worry that someone may die. The plugin lands them safely on the ground.
- Deny even elytra gliding if you'd like
WorldGuard support so no treasures are placed inside regions
ChunkyBorder support so no treasures are placed beyond borders
- Also works with vanilla world borders.
- You can also set the max coords that a treasure can spawn to in order to better control where you treasure can appear.
1.21, no need to change things. This plugin was made with compatibility in mind
HEX and color codes support everywhere. Also, some messages are centered in order to get your player's attention
You can require your players to click a number of times before retrieving the treasure
You can set cooldowns
- You can set a cooldown for claiming treasures. If you claimed a treasure, you need to wait before claiming another. Persistent after restart.
- You can set cooldowns for spawning treasures in a certain world. (ex. if a treasure was spawned now, it will wait some time before trying to spawn another - but that is up to the chance also).
- Clear a player's cooldown with /hunt clear
Lightweight. I work constantly to reduce excess code and to make everything as efficient as possible.
Reload your config with a simple command.
TabCompleter so that you don't have to worry about typing all the commands by yourself
Updater - be notified of the newest version available
Everything is toggleable, if you don't want something to be available to the players, you can just turn it off in the config, and reload the plugin.
Friendly developer, always ready to answer questions and squash bugs
Constant updates, as many as I can
Command list:
- /hunt start - Starts the hunt at a random location in the player's world
- /hunt start (Treasure) - Starts the hunt at a random location
- /hunt start here (Treasure) - Starts the hunt right at the player's location
- /hunt key (Player) (Treasure) (Number) - Give a player a treasure key
- /hunt stop (Treasure) - Stops the hunt in the specified world
- /hunt help - Lists all commands
- /hunt reload - Reloads config and messages - not all values can be reloaded for performance purposed, some may need a restart.
- /hunt clear - clears the player's cooldown
- /hunt debug - enter debug mode

Code (YAML):

treasure:
default:
world-name : "world"
treasure-name : "Hidden Treasure"
treasure-block : ENDER_CHEST
treasure-particles : COMPOSTER
treasure-animation : "protection" #none, spiral, orb, protection / Protection only works if 'require-all-mobs-dead' is 'true'
treasure-icon : EMERALD #Only if DecentHolograms or FancyHolograms is not installed
chance-for-treasure : 20 #The chance to spawn a random treasure
max-treasure-distance : 15000 #Bypasses the border setting, if the border is 20k, and this is 15k, the max distance for the treasure will be 15k. Usefull for when you don't set your border
interval : 30 #Interval of time in minutes for a chance to spawn the treasure (ex. every 30mins you have 20% chance for the treasure to spawn)
duration : 20 #The duration of the treasure before it despawns
cooldown : 15 #Cooldown between treasures in minutes
delay : 200 #In ticks, the delay from the announcement that the treasure will spawn until it really spawns
flare-type : "many" #Options: none, few, many
flare-particle : COMPOSTER
fireworks : true #Spawn fireworks upon clicking the treasure
fall-from-the-sky : true
reward-all-players-who-participated : false #Reward all players who killed a treasure keeper?
reward-highest-damage : false #Reward the player who gives to most damage to the treasure keepers
drop-items-on-ground : false #Drops Item Rewards on ground. Only works when 'reward-all-players-who-participated' and 'reward-highest-damage' is false
dropped-item-name : "&6Treasure Loot"
distance-from-player-to-spawn-mobs : 0 #0 To spawn when the treasure spawns, other value to spawn when the distance is achieved
mob-wandering-distance : 40 #How far away the mobs can wander before being teleported back near the treasure
enable-mob-tracker : true
require-all-mobs-dead : true #Can a player claim a treasure if they haven't defeated the mobs yet?
animate-mob-spawning : true #If distance-from-player-to-spawn-mobs is more than 0, play an animation to the mobs when they spawn?
minutes-before-pickup : 0
clicks-to-open : 1 #How many right clicks are required to open the treasure?
spawn-to-certain-coords : false #Set to true if you want the treasure to spawn only at one of the coords in the list below
spawn-coords : #Make sure to place valid coords - inside your world border
- "101:100:55" #Coords to spawn to. Use ':' to sepparate X Y and Z
treasure-key:
enabled : false
item : TRIPWIRE_HOOK
name : "&c&l&oTREASURE KEY"
lore :
- "&7&oOpen a treasure chest"
- "&7&ousing this mysterious key"
potion-effects :
- "REGENERATION:1"
mobs:
zombie:
entity-type : "ZOMBIE"
mythic-mobs : false
custom-name : "Bobby"
range : "5-10"
chance : 100
max-health : 50
potion-effects :
- "REGENERATION:5"
equipment:
helmet:
item : "DIAMOND_HELMET" #Set to 'none' to disable
slot : "HEAD" #TYPES: HEAD, BODY, LEGS, FEET, HAND, OFF_HAND
enchantments :
- "PROTECTION:4"
chest:
item : "DIAMOND_CHESTPLATE" #Set to 'none' to disable
slot : "BODY" #TYPES: HEAD, BODY, LEGS, FEET, HAND, OFF_HAND
enchantments :
- "PROTECTION:4"
legs:
item : "DIAMOND_LEGGINGS" #Set to 'none' to disable
slot : "LEGS" #TYPES: HEAD, BODY, LEGS, FEET, HAND, OFF_HAND
enchantments :
- "PROTECTION:4"
feet:
item : "DIAMOND_BOOTS" #Set to 'none' to disable
slot : "FEET" #TYPES: HEAD, BODY, LEGS, FEET, HAND, OFF_HAND
enchantments :
- "PROTECTION:4"
hand:
item : "DIAMOND_SWORD" #Set to 'none' to disable
slot : "HAND" #TYPES: HEAD, BODY, LEGS, FEET, HAND, OFF_HAND
enchantments :
- "SHARPNESS:4"
offhand:
item : "DIAMOND_PICKAXE" #Set to 'none' to disable
slot : "HEAD" #TYPES: HEAD, BODY, LEGS, FEET, HAND, OFF_HAND
enchantments :
- "EFFICIENCY:4"
drops:
diamonds:
item : "DIAMOND"
amount : "1-10"
chance : 20
item-rewards:
diamond : #Can be any text, it doesn't count. It's a reward identifier.
item : DIAMOND #Material name
name : "&6&l&oREWARD #1" #THIS WON'T WORK WITH ITEMS ADDER DUE TO HOW THEY RECOGNISE ITEMS
lore : #THIS WON'T WORK WITH ITEMS ADDER DUE TO HOW THEY RECOGNISE ITEMS
- "&7&oHave fun with this reward!"
amount : 1-10 #Between 1 and 10 diamonds
chance : 40 #Percentage (60%)
emerald : #Can be any text, it doesn't count. It's a reward identifier.
item : EMERALD #Material name
name : "&6&l&oREWARD #1"
lore :
- "&7&oHave fun with this reward!"
amount : 1-10 #Between 1 and 10 diamonds
chance : 100 #Percentage (60%)
command-rewards:
money:
command : "eco give %player% 100"
chance : 100

Code (YAML):

settings:
positive-sound : "ENTITY_PLAYER_LEVELUP"
negative-sound : "BLOCK_ANVIL_BREAK"
allow-pvp-near-treasure : false
allow-flight-near-treasure : false
allow-god-near-treasure : false
allow-elytra-near-treasure : false
disable-griefing-protection : false
protection-radius : 50 #The radius in which the griefing protection works. ATTENTION! You should NOT set this to 0!
min-players-online : 15 #Minimum players to have a chance to spawn a treasure
protect-mobs-from-sun : true #Should zombies not set on fire from the sun?
potion-effect-radius : 20 #How close you need to be to the treasure in order to be affected by the potion effects
broadcast-to-all-worlds : false #Send the actionbar message to all the worlds. If multiple treasures are started only one treasure will appear in the actionbar.
winner-cooldown : 1440 #How long in minutes, a treasure winner has to wait before claiming another treasure
actionbar:
enabled : true
refresh : 2 #Refresh rate in ticks
effects-particles : #You should change these only if they cause compatibility issues.
dust : DUST
wax_off : WAX_OFF
soul : SOUL
soul-fire-flame : SOUL_FIRE_FLAME
warped-spore : WARPED_SPORE
crit : CRIT
lava : LAVA
flame : FLAME
treasure-spawn-particle : EXPLOSION
treasure-fall-particle : CAMPFIRE_SIGNAL_SMOKE
treasure-remove-particle : EXPLOSION_EMITTER
updater : true
bstats : true

Code (YAML):

messages:
no-permission : "&6&lTreasure&e&lHunt &fYou don't have permission to use this command."
wrong-command : "&6&lTreasure&e&lHunt &fWrong command! Run &6/hunt help &ffor more info."
inexistent-world : "&6&lTreasure&e&lHunt &fHunts are not enabled in this world"
hunt-already-active : "&6&lTreasure&e&lHunt &fThere is already a hunt active in this world"
hunt-not-active : "&6&lTreasure&e&lHunt &fThere is no hunt active at the moment"
generating-treasure : "&6&lTreasure&e&lHunt &fis being generated.."
treasure-generated : "&6&lTreasure&e&lHunt &fgenerated successfuly!"
treasure-generated-confirmation : "&6&lTreasure&e&lHunt &fwas generated @ {world}, X: {x}, Z: {z}"
hunt-stopped : "&6&lTreasure&e&lHunt &fYou stopped the treasure hunt"
cannot-place-near-treasure : "&6&lTreasure&e&lHunt &fCan't place blocks near a treasure!"
cannot-break-near-treasure : "&6&lTreasure&e&lHunt &fCan't break blocks near a treasure!"
cannot-attack-near-treasure : "&6&lTreasure&e&lHunt &fCan't attack players near a treasure!"
no-hunt-in-this-world : "&6&lTreasure&e&lHunt &fThere are no hunts in this world"
full-inventory : "&6&lTreasure&e&lHunt &fYou have a full inventory, so you've dropped {amount} {item}"
actionbar : "&8(&2❖&8) &fTreasure despawning in &7{time} &8| &7X: &f{x} &7Z: &f{z}"
actionbar-all-mobs-dead : "&8(&2❖&8) &fAll the Treasure Keepers are dead! Go and open the treasure!"
actionbar-mobs-remaining : "&8(&2❖&8) &fThere are still {remaining_mobs} Treasure Keepers alive!"
actionbar-mobs-tracker : "&8(&2❖&8) &fA Treasure Keeper is located at &7X: &f{x}, &7Y: &f{z} &7Z: &f{z}"
treasure-icon-text : "&8(&2❖&8) &aTreasure &7 | Click"
winner-console : "&6&lTreasure&e&lHunt &f{player} has claimed the treasure @ X: {x}, Z: {z}"
winner-message : "&6&lTreasure&e&lHunt &fSweet! The treasure is all yours"
winner-cooldown : "&6&lTreasure&e&lHunt &fYou need to wait {time} before claiming another treasure"
config-reload : "&6&lTreasure&e&lHunt &fConfig reloaded!"
no-creative : "&6&lTreasure&e&lHunt &fYou can't break Treasures in Creative mode"
participating : "&6&lTreasure&e&lHunt &fYou are now participating in this TreasureHunt!"
participating-cleared-mobs : "&6&lTreasure&e&lHunt &fYou killed all the Treasure Keepers! The reward is all yours!"
player-not-found : "&6&lTreasure&e&lHunt &fThis player is not online!"
cooldown-reset : "&6&lTreasure&e&lHunt &fYou successfully reset the player's cooldown!"
remaining-clicks : "&6&lTreasure&e&lHunt &fKeep on clicking! ({current_clicks}/{needed_clicks})"
treasure-locked : "&c&lLOCKED"
treasure-unlocked : "&a&lUNLOCKED"
winner-broadcast :
- ""
- "&6&lTreasure &e&lHunt"
- ""
- "&fThe mysterious treasure was found by"
- "&6{player}"
- "&fCongratulations, adventurer!"
- ""
announce-treasure :
- ""
- "&6&lTreasure &e&lHunt"
- ""
- "&fA {alias} is rumored to appear!"
- "&fX : &7{x} &fZ : &7{z}"
- "&fGood luck finding it!"
- ""
- "&7&o((Tip : The treasure will spawn soon ) ) "
- " "
treasure-hologram:
- "&6&l {alias } "
- "&fStatus : {status } "
- " "
- "&fDespawning in {time } "
- "&fThere are {remaining_mobs } Treasure Keepers "
- "&fstill alive "
- "&fClick to open "
- " #ICON: EMERALD"
hunt-message :
- ""
- "&6&lTreasure &e&lHunt"
- ""
- "&fA {alias} has just emerged!"
- "&fX : &7{x} &fZ : &7{z}"
- "&fLet the hunt begin!"
- ""
- "&7&o((Tip : The treasure will dissapear in {duration } minutes ) ) "
- " "
need-to-kill-all-mobs:
- " "
- "&6&lTreasure&e&lHunt &fThe treasure is protected by a magic spell! "
- "&6&lTreasure&e&lHunt &fGet rid of the Treasure Keepers in order to claim it's belongings! "
- " "

Code (YAML):

##########################################
# #
# HEADER #
# #
##########################################

main : com.Moshu.Main
name : MysticTreasures
version : 2.0
description : The world is full of treasures!
author : Moshu
website : mc.b-zone.ro
softdepend : [WorldGuard, ChunkyBorder ]
api-version : "1.13"

commands:
hunt:
description : "Interact with the plugin"

permissions:
mystictreasures.hunt:
default : true
description : Use the main command
mystictreasures.admin:
default : op
mystictreasures.bypass:
default : op