Logo
AdvancedHunt
PluginApache-2.0

AdvancedHunt

Treasure Hunt plugin for the entire server.

785
Downloads
8
Followers
4 months ago
Updated
📦
10
Versions
adventuredecorationminigamebukkitpaperspigot
Download Latestv3.1.4-BETAView on Modrinth

📖About AdvancedHunt

🎮 Advanced Hunt - Spigot Plugin

Create engaging treasure hunts with customizable collections, rewards, and requirements!

🎬 Plugin Showcase v.2.2

Plugin Showcase

🐛 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

bStats
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

Made with ❤️ for the Minecraft community