Compatibility
Minecraft: Java Edition
Platforms
Details
🎮 Advanced Hunt - Spigot Plugin
Create engaging treasure hunts with customizable collections, rewards, and requirements!
🎬 Plugin Showcase v.2.2
🐛 Bug Reports & Support
⚠️ IMPORTANT: Please report every bug on our Discord to make the plugin as good as possible!
🚫 DO NOT REPORT BUGS AS RATINGS!
💬 Need help? Join our Discord Server for support and updates!
📋 Requirements
- NBT-API (Required)
- PlaceholderAPI (Optional - supported since v1.6)
- ProtocolLib (Optional - experimental)
✨ Features
Click to expand feature list
- 💬 Custom messages with multi-language support
- ✨ Particle effects for treasures
- 📦 Interactive list inventory
- ⚙️ In-game configuration
- 🎯 Place mode for better item placement
- 🔊 Sound effects for every action
- 💾 Inventory save during place mode
- 🏆 Leaderboard menu
- 📊 Progress tracking menu
- 🌟 Treasure glow effects
- 🎁 Custom reward commands
- 💡 Hint system with cooldowns
- 📚 Multiple independent collections
- 🌍 Multi-language support (EN, DE, FR, VN, BN, ZH)
- 🎨 Hex color support (since v2.0.2)
🎨 Media
📸 More pictures available in the Modrinth Gallery
🔌 PlaceholderAPI Integration
Available Placeholders
All placeholders can be viewed on the GitHub Wiki
⚙️ Configuration Example
config.yml Preview
config-version: 3.7
# Change the language
# Available: en (English) | de (German) | fr (France) | vn (Vietnamese) | bn (Bangla, Bengali) | zh (Simplified Chinese only messages no menus)
messages-lang: en
# Change the plugin name or the main purpose
plugin-name-singular: "treasure"
plugin-name-plural: "treasures"
# The first command listed here is going to be the main command
# IMPORTANT: COMMANDS WILL ONLY APPLY IF THE SERVER RESTARTS; A PLUGIN RELOAD WILL NOW CHANGE THIS!
commands:
- "treasurehunt"
- "treasures"
- "advancedhunt"
- "aeh"
- "easter"
#Auto download
Download:
# Will be downloaded if a new plugin version is out
AdvancedHunt: true
# Will download for the plugin to work (This should not be disabled)
NBT-API: false
# ProtocolLib: false
PlaceholderAPI: false
# Experimental feature toggles
# Remove the '#' and set to true to use
Experimental:
# Enable ProtocolLib support (requires ProtocolLib plugin)
ProtocolLibSupport: false
prefix: '&f[&eAdvancedHunt&f] &r'
Settings:
# The sound volume for all sounds
SoundVolume: 3
# If a message should be sent if the plugin has a newer version
Updater: true
# Shows the coordinates in the progress inventory of the player
ShowCoordinatesWhenEggFoundInProgressInventory: false
# If a firework should spawn after clicking a treasure
ShowFireworkAfterEggFound: true
# How long the armor stands are visible after typing /%PLUGIN_COMMAND% show
ArmorstandGlow: 10
# In witch radius the player gets a message that he is near a treasure
ShowEggsNearbyMessageRadius: 10
# If the plugin prefix should show up
PluginPrefixEnabled: true
# If left-clicking a treasure works
LeftClickEgg: false
# If right-clicking a treasure works
RightClickEgg: true
# How many panes a player has to click before getting their reward
HintCount: 25
# How long the cooldown on the hint inventory is ( in seconds )
HintCooldownSeconds: 1800
# How long the update in the hint inventory is ( in ticks )
HintUpdateTime: 20
# If the cooldown should be applied to the hint command on a failed attempt
HintApplyCooldownOnFail: true
Presets:
# Name of the preset that loads after placing a new treasure
DefaultIndividualPresetLoad: default
# Name of the preset that loads after creating a new collection
DefaultGlobalPresetLoad: default
Sounds:
PlayerFindEggSound: ENTITY_PLAYER_LEVELUP
EggAlreadyFoundSound: ENTITY_VILLAGER_NO
AllEggsFoundSound: ENTITY_ENDER_DRAGON_DEATH
EggBreakSound: BLOCK_NOTE_BLOCK_BASS
EggPlaceSound: BLOCK_NOTE_BLOCK_BELL
ErrorSound: BLOCK_NOTE_BLOCK_BASEDRUM
InventoryClickSuccess: BLOCK_NOTE_BLOCK_CHIME
InventoryClickFailed: BLOCK_NOTE_BLOCK_HAT
# Rarity's display how rare the item is that you found
# It will show up when you find an item
# Smallest number: 0.0000001
send-rarity-messages: true
Rarity:
common:
display: '&fCOMMON'
min: 50
max: 100
uncommon:
display: '&aUNCOMMON'
min: 10
max: 50
rare:
display: '&9RARE'
min: 1
max: 10
epic:
display: '&5EPIC'
min: 0.1
max: 1
legendary:
display: '&6LEGENDARY'
min: 0.005
max: 0.1
mythic:
display: '&dMYTHIC'
min: 0.0000001 #0.0000001
max: 0.005
Particle:
enabled: true
type:
EggFound: CRIT
EggNotFound: VILLAGER_HAPPY
# Change the messages that show up when no data for this placeholder is available
PlaceholderAPI:
# Replacement for collection is null
collection: 'N/A'
# Replacement if the player name is null
name: 'N/A'
# Replacement if the count is null
count: '-1'
# Add commands that cant be executed by the plugin
BlacklistedCommands:
- op
- minecraft:op
- kill
- minecraft:kill
- summon
- minecraft:summon
- stop
- minecraft:stop
- restart
- minecraft:restart
- execute
- minecraft:execute
- setblock
- minecraft:setblock
- fill
- minecraft:fill
- reload
- minecraft:reload
- rl
- minecraft:rl
- luckperms:lp
- lp
- luckperms:perm
- perm
- luckperms:permission
- permission
- luckperms:permissions
- permissions
- luckperms:perms
- perms
Place:
# You can only use textures if the type is a player head
0:
type: PLAYER_HEAD
texture: 'ZWNlZGRjMjNmOWQ5NmJhYWEwZDJkN2I5ZWMxODBjZDdiZWE1NDQ3ZDM5YzQyNWNhOWU0NGQ4ODA4ZWExMWVhMCJ9fX0='
1:
type: PLAYER_HEAD
texture: 'ODYyMWE1MjY5ODY5ODQ3NTMxMDE1NjYzMDBhMzU2YjVmMzBkNjk3NWExZWZlNjI5YWJmMjY5NDc2NWQ5NmNjIn19fQ=='
2:
type: PLAYER_HEAD
texture: 'NmUzMmE3ZGU3YTY3MmNjNjhmYTdhMjcyYmFhNmE4OWViZDQ0MGMzMmRjZjQ0ZTc3MDU3MDY4OTg5MDQyZjdjNiJ9fX0='
3:
type: PLAYER_HEAD
texture: 'NmI3NDQ2NTUwZjBmOTU3NmI3MzE3MjhiNWNiZWIyYmNlYTI1ZmQxYTU1NjBhMTdiMjM1N2U2MTZmYmM2NTYyMSJ9fX0='
4:
type: PLAYER_HEAD
texture: 'ZmU2ZmFiMDkxZTQ5NmMwOTY5MTA0ODBkYTBkODVlZTkxOWJjNDlhYTMxNzc1Y2FkYmJmNTA1ZWY0MTFiNWY5NCJ9fX0='
5:
type: PLAYER_HEAD
texture: 'ODUzMWNjMjY5YzhlNDcwNmU4OTJmOGEwZmIzNTFiMTA5MDE1NmIzZjYyNjFkODE2MzVkMDdhY2FkYmU2Y2UwZSJ9fX0='
6:
type: PLAYER_HEAD
texture: 'YTZhNjA1MWY3ZjZmNDM5ZDhmMjE0YzIzNGU4ZTJjNDc3NjMwMDUyNDMyZTQyNjA3ZjA0MDRiODQwYjUzY2VhYiJ9fX0='
7:
type: PLAYER_HEAD
texture: 'MjEzYjJlMjhlMDM3MTAwNzM5MTMwYjJlYjkwZWY0OTFjNmMzZGZmNWRlNTYxNWQyZjZkZmQxZTQ2YzljMmY3YyJ9fX0='
8:
type: PLAYER_HEAD
texture: 'NTIzZDkyMmJlMGJhZTA1ZDBlN2I4OGU2NDljMTlmZTNiMmRhZTQzNjM5ZGRkMDljYjcxZTI4M2JmMDM0ZjY4OSJ9fX0='
🌐 Servers Using Advanced Hunt
- 🎮 mc.bycraft.net
- 🎮 play.lexurcraft.com
- 🎮 LazyLive.minehut.gg
- 🎮 Mythological.info
Is your server using the plugin? Join our Discord and open a ticket to be featured here!
❤️ Support the Community
If you'd like to support the developers, please consider donating to FamaLlama - a community-run server for neurodivergents that is completely non-profit and struggling to raise money to keep running.
Thanks to everyone who supports the community! 🙏
💖 Support the Developers
If you like AdvancedHunt and want to support its future development, consider donating:
💸 Donate via Ko-fi
⭐ Leave a 5-Star Review on SpigotMC
Every bit of support helps us continue creating new updates and features ❤️
📊 Statistics
View all plugin statistics at bStats
📜 Legal Notice
⚠️ ATTENTION: This resource is for private use only.
- ❌ It is NOT allowed to upload/publish this resource on other websites
- ❌ Any misuse will be reported and removed
- ⚖️ Unauthorized distribution is ILLEGAL
🔗 Quick Links
- 📖 Full Documentation
- 💬 Discord Support
- 🐛 Bug Reports
- 🏗️ Latest Dev Build (Open a ticket)
Made with ❤️ for the Minecraft community





