# \ud83c\udfae Advanced Hunt<\/p>\n
> Create engaging treasure hunts with customizable collections, rewards, and requirements!<\/p>\n
—<\/p>\n
## \ud83c\udfac Plugin Showcase v.2.2<\/p>\n
<\/p>\n
—<\/p>\n
## \ud83d\udc1b Bug Reports & Support<\/p>\n
\u26a0\ufe0f **IMPORTANT**: Please report every bug on our Discord to make the plugin as good as possible!<\/p>\n
\ud83d\udeab **DO NOT REPORT BUGS AS RATINGS!**<\/p>\n
\ud83d\udcac Need help? Join our Discord Server for support and updates!<\/p>\n
—<\/p>\n
## \ud83d\udccb Requirements<\/p>\n
– **NBT-API** (Required)
\n– **PlaceholderAPI** (Optional – supported since v1.6)
\n– **PacketEvents** (Required – since v4.0.0)<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n – \ud83d\udcac Custom messages with multi-language support —<\/p>\n ## \ud83c\udfa8 Media<\/p>\n \ud83d\udcf8 **More pictures available in the Modrinth Gallery**<\/p>\n —<\/p>\n ## \ud83d\udd0c PlaceholderAPI Integration<\/p>\n All placeholders can be viewed on the GitHub Wiki<\/p>\n<\/details>\n —<\/p>\n ## \u2699\ufe0f Configuration Example<\/p>\n “` storage: # MySQL Configuration (Only needed if type is MYSQL) # Supported languages are en, de, bn, vi command: # Enable Brigadier command integration for enhanced command completion. rewards: particle-settings: # Shows an action bar when the placer is in range of a treasure leaderboard: hint: # Minigame settings for hints # Settings for the Reaction minigame # Settings for the Memory (Simon) minigame # Updates the plugin automatically when a new version comes out # Update for dependency plugin sounds: fireworks: colors: fade-colors: # Settings for data migration “`<\/p>\n<\/details>\n —<\/p>\n ## \u2764\ufe0f Support the Community<\/p>\n 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.<\/p>\n **Thanks to everyone who supports the community!** \ud83d\ude4f<\/p>\n —<\/p>\n ## \ud83d\udc96 Support the Developers<\/p>\n If you like AdvancedHunt and want to support its future development, consider donating:<\/p>\n \ud83d\udcb8 Donate via Ko-fi **Every bit of support helps us continue creating new updates and features \u2764\ufe0f**<\/p>\n —<\/p>\n ## \ud83d\udcca Statistics<\/p>\n  —<\/p>\n ## \ud83d\udcdc Legal Notice<\/p>\n \u26a0\ufe0f **ATTENTION**: This resource is for **private use only**.<\/p>\n – \u274c It is **NOT allowed** to upload\/publish this resource on other websites —<\/p>\n ## \ud83d\udd17 Quick Links<\/p>\n – \ud83d\udcd6 Full Documentation —<\/p>\n *Made with \u2764\ufe0f for the Minecraft community*<\/p>\n","protected":false},"excerpt":{"rendered":" Treasure Hunt plugin for the entire server.<\/p>\n","protected":false},"featured_media":7183,"template":"","meta":{"_minecraft_slug":"advancedhunt","_minecraft_project_id":"8ZWWJnYu","_minecraft_author":"TheRedEnd2000","_minecraft_license":"Apache-2.0","_minecraft_downloads":1539,"_minecraft_follows":9,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"advancedhunt.zip","_minecraft_size_bytes":27769219,"_minecraft_version_count":14,"_minecraft_updated_at":"2026-05-16T07:09:23.680521Z","_minecraft_date_created":"2024-03-27T06:10:01.190220Z","_minecraft_date_modified":"2026-04-04T20:59:25.781517Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/advancedhunt","_minecraft_icon_attachment_id":7183,"_minecraft_imported_at":"2026-05-31T14:37:24+00:00","_minecraft_import_hash":"d24635f9ddfeb8f49e087cbe1150f8bf","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,124,156,866,127,129],"mod_loader":[130,132,134],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,30,31,860,861,862,863,864],"class_list":["post-7182","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-bukkit","mod_category-decoration","mod_category-minigame","mod_category-paper","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4"],"yoast_head":"\nClick to expand feature list<\/summary>\n
\n– \u2728 Particle effects for treasures
\n– \ud83d\udce6 Interactive list inventory
\n– \u2699\ufe0f In-game configuration
\n– \ud83c\udfaf Place mode for better item placement
\n– \ud83d\udd0a Sound effects for every action
\n– \ud83d\udcbe Inventory save during place mode
\n– \ud83c\udfc6 Leaderboard menu
\n– \ud83d\udcca Progress tracking menu
\n– \ud83c\udf1f Treasure glow effects
\n– \ud83c\udf81 Custom reward commands
\n– \ud83d\udca1 Hint system with cooldowns
\n– \ud83d\udcda Multiple independent collections
\n– \ud83c\udf0d Multi-language support (EN, DE, FR, VN, BN, ZH)
\n– \ud83c\udfa8 Hex color support
\n– MYSQL, SQLite support
\n– Client-Side hiding when disabled<\/p>\n<\/details>\nAvailable Placeholders<\/summary>\n
config.yml Preview<\/summary>\n
\nconfig-version: 4.0<\/p>\n
\n # Options: SQLITE, MYSQL, YAML
\n type: SQLITE<\/p>\n
\n mysql:
\n host: localhost
\n port: 3306
\n database: advancedhunt
\n username: root
\n password: password<\/p>\n
\nlanguage: en<\/p>\n
\n # Defines the main command and its aliases for the plugin.
\n # The first value is used as the primary command, all following values (separated by “|”) are registered as aliases.
\n name: advancedhunt|ah|ahunt|treasure|treasures<\/p>\n
\n # Brigadier provides native Minecraft command suggestions and validation.
\n # Disable this if you experience command-related issues or prefer legacy completion.
\n brigadier-integration: false<\/p>\n
\n # Commands matching these regex patterns will be blocked from being added or executed.
\n # Use ^ to match the start and $ to match the end of the command.
\n # Matches are case-insensitive.
\n command-blacklist:
\n – “^([^:]+:)?execute\\b”
\n – “^([^:]+:)?op\\b”
\n – “^([^:]+:)?deop\\b”
\n – “^([^:]+:)?kill\\b”
\n – “^([^:]+:)?summon\\b”
\n – “^([^:]+:)?setblock\\b”
\n – “^([^:]+:)?fill\\b”
\n – “^([^:]+:)?reload\\b”
\n – “^([^:]+:)?rl\\b”
\n – “^([^:]+:)?stop\\b”
\n – “^([^:]+:)?restart\\b”
\n – “^([^:]+:)?kick\\b”
\n – “^([^:]+:)?whitelist\\b”
\n – “^([^:]+:)?ban\\b”
\n – “^([^:]+:)?ban-ip\\b”
\n – “^([^:]+:)?pardon\\b”
\n – “^([^:]+:)?pardon-ip\\b”
\n – “^([^:]+:)?pex\\b”
\n – “^([^:]+:)?lp\\b”
\n – “^([^:]+:)?luckperms\\b”
\n – “^([^:]+:)?perm\\b”
\n – “^([^:]+:)?perms\\b”
\n – “^([^:]+:)?permission\\b”
\n – “^([^:]+:)?permissions\\b”
\n # If true, blacklisted commands will also be blocked from executing.
\n # If false, they will only be blocked when an admin tries to add them via the GUI.
\n block-execution: true<\/p>\n
\n enabled: true
\n view-distance: 32
\n # Particles for treasures not found by the current player
\n not-found:
\n enabled: true
\n particle: CRIT
\n count: 3
\n speed: 0.01
\n offset:
\n x: 0.3
\n y: 0.3
\n z: 0.3
\n # Particles for treasures already found by the current player
\n found-by-player:
\n enabled: true
\n particle: HAPPY_VILLAGER
\n count: 2
\n speed: 0.03
\n offset:
\n x: 0.3
\n y: 0.2
\n z: 0.3
\n # Particles for treasures found by another player in single-player-find collections
\n found-by-others:
\n enabled: false # Disabled by default for performance
\n particle: WAX_OFF
\n count: 2
\n speed: 0.3
\n offset:
\n x: 0.3
\n y: 0.2
\n z: 0.3<\/p>\n
\nproximity-settings:
\n enabled: true
\n range: 10<\/p>\n
\n # Maximum number of entries to display in the GUI leaderboard (per collection)
\n display-limit: 100
\n # How often to refresh the leaderboard cache in seconds (default: 300 = 5 minutes)
\n cache-refresh-interval: 300<\/p>\n
\n # Enable\/disable the hint feature
\n enabled: true
\n # Cooldown in seconds before player can request another hint
\n cooldown-seconds: 300
\n # Maximum distance in blocks to search for treasures
\n proximity-range: 50
\n # Apply cooldown if the player fails the minigame?
\n apply-cooldown-on-fail: true
\n # Apply cooldown to operators
\n apply-cooldown-to-operators: false
\n # Which coordinate to reveal: X, Z, or RANDOM (only X or Z)
\n reveal-coordinate: RANDOM<\/p>\n
\n minigames:
\n # Global setting to enable\/disable minigames entirely
\n enabled: true
\n # Which minigame to use for hints (REACTION, MEMORY, or RANDOM)
\n type: RANDOM<\/p>\n
\n reaction:
\n enabled: true
\n # Number of correct clicks required to win
\n required-clicks: 15
\n # Time in ticks (20 ticks = 1 second) before the target moves and counts as a miss
\n update-time: 20<\/p>\n
\n memory:
\n enabled: true
\n # Number of rounds to complete to win
\n rounds: 5
\n # Time in ticks to show each color during the sequence display
\n display-time: 20<\/p>\n
\nupdater:
\n # Update for AdvancedHunt plugin
\n enabled: true<\/p>\n
\n dependencies:
\n PacketEvents: false
\n NBT-API: false
\n PlaceholderAPI: false<\/p>\n
\n enabled: true
\n treasure-found:
\n enabled: true
\n sound: ENTITY_PLAYER_LEVELUP
\n volume: 1.0
\n pitch: 1.5
\n collection-completed:
\n enabled: true
\n sound: UI_TOAST_CHALLENGE_COMPLETE
\n volume: 1.0
\n pitch: 1.0
\n treasure-placed:
\n enabled: true
\n sound: BLOCK_NOTE_BLOCK_PLING
\n volume: 1.0
\n pitch: 2.0
\n treasure-broken:
\n enabled: true
\n sound: BLOCK_NOTE_BLOCK_SNARE
\n volume: 0.6
\n pitch: 0.8
\n treasure-already-found:
\n enabled: true
\n sound: BLOCK_NOTE_BLOCK_BASS
\n volume: 0.7
\n pitch: 0.5
\n treasure-claimed-by-other:
\n enabled: true
\n sound: ENTITY_ENDERMAN_TELEPORT
\n volume: 0.6
\n pitch: 0.8
\n block-protected:
\n enabled: true
\n sound: ENTITY_VILLAGER_NO
\n volume: 0.8
\n pitch: 1.0
\n place-mode-break-denied:
\n enabled: true
\n sound: ITEM_SHIELD_BLOCK
\n volume: 0.4
\n pitch: 0.9
\n place-mode-collect-denied:
\n enabled: true
\n sound: BLOCK_NOTE_BLOCK_BASS
\n volume: 1.0
\n pitch: 1.0
\n collection_unavailable:
\n enabled: true
\n sound: BLOCK_BEACON_DEACTIVATE
\n volume: 1.0
\n pitch: 1.0<\/p>\n
\n # Enable or disable all custom fireworks
\n enabled: true
\n # Should the firework be silent (no launch\/explosion sound)
\n silent: false
\n power:
\n # Minimum flight power (1 = low, 3 = very high)
\n min: 1
\n # Maximum flight power
\n max: 2
\n effects:
\n # Enable flickering effect
\n flicker: true
\n # Enable trail behind the firework
\n trail: true
\n # Possible firework effect types (used if random-type = true)
\n # Available: BALL, BALL_LARGE, STAR, BURST, CREEPER
\n # Will pick a random one
\n types:
\n – BALL
\n – BALL_LARGE
\n – STAR
\n – BURST
\n – CREEPER<\/p>\n
\n # Main firework colors
\n # Available colors:
\n # AQUA, BLACK, BLUE, FUCHSIA, GRAY, GREEN, LIME, MAROON,
\n # NAVY, OLIVE, ORANGE, PURPLE, RED, SILVER, TEAL, WHITE, YELLOW
\n # Will pick a random one
\n list:
\n – AQUA
\n – BLUE
\n – PURPLE
\n – RED
\n – ORANGE
\n – YELLOW
\n – LIME
\n – WHITE<\/p>\n
\n # Enable fade colors after explosion
\n enabled: true
\n # Colors used for fading
\n list:
\n – WHITE
\n – SILVER
\n – GRAY<\/p>\n
\n# These settings are ONLY used when running ‘\/ah migrate mysql’
\n# They define the TARGET database where data will be moved TO.
\nmigration:
\n target:
\n host: “localhost”
\n port: 3306
\n database: “advancedhunt_target”
\n username: “root”
\n password: “password”<\/p>\n
\n\u2b50 Leave a 5-Star Review on SpigotMC<\/p>\n
\nView all plugin statistics at **bStats**<\/p>\n
\n– \u274c Any misuse will be reported and removed
\n– \u2696\ufe0f **Unauthorized distribution is ILLEGAL**<\/p>\n
\n– \ud83d\udcac Discord Support
\n– \ud83d\udc1b Bug Reports
\n– \ud83c\udfd7\ufe0f Latest Dev Build (Open a ticket)<\/p>\n