Mineforgian
AdvancedHunt
Treasure Hunt plugin for the entire server.
- Загрузки
- 2K
- Подписчики
- 10
- Обновлён
- 11 июня 2026 г.
- Лицензия
- Apache-2.0
Опубликован 23 марта 2024 г.
🎮 Advanced Hunt
Create engaging treasure hunts with customizable collections, rewards, and requirements!
🎬 Plugin Showcase v4.0.4
v2.2
🎬 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)
- PacketEvents (Required - since v4.0.0)
✨ 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
- MYSQL, SQLite support
- Client-Side hiding when disabled
🎨 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: 4.0
storage:
# Options: SQLITE, MYSQL, YAML
type: SQLITE
# MySQL Configuration (Only needed if type is MYSQL)
mysql:
host: localhost
port: 3306
database: advancedhunt
username: root
password: password
# Supported languages are en, de, bn, vi
language: en
command:
# Defines the main command and its aliases for the plugin.
# The first value is used as the primary command, all following values (separated by "|") are registered as aliases.
name: advancedhunt|ah|ahunt|treasure|treasures
# Enable Brigadier command integration for enhanced command completion.
# Brigadier provides native Minecraft command suggestions and validation.
# Disable this if you experience command-related issues or prefer legacy completion.
brigadier-integration: false
rewards:
# Commands matching these regex patterns will be blocked from being added or executed.
# Use ^ to match the start and $ to match the end of the command.
# Matches are case-insensitive.
command-blacklist:
- "^([^:]+:)?execute\\b"
- "^([^:]+:)?op\\b"
- "^([^:]+:)?deop\\b"
- "^([^:]+:)?kill\\b"
- "^([^:]+:)?summon\\b"
- "^([^:]+:)?setblock\\b"
- "^([^:]+:)?fill\\b"
- "^([^:]+:)?reload\\b"
- "^([^:]+:)?rl\\b"
- "^([^:]+:)?stop\\b"
- "^([^:]+:)?restart\\b"
- "^([^:]+:)?kick\\b"
- "^([^:]+:)?whitelist\\b"
- "^([^:]+:)?ban\\b"
- "^([^:]+:)?ban-ip\\b"
- "^([^:]+:)?pardon\\b"
- "^([^:]+:)?pardon-ip\\b"
- "^([^:]+:)?pex\\b"
- "^([^:]+:)?lp\\b"
- "^([^:]+:)?luckperms\\b"
- "^([^:]+:)?perm\\b"
- "^([^:]+:)?perms\\b"
- "^([^:]+:)?permission\\b"
- "^([^:]+:)?permissions\\b"
# If true, blacklisted commands will also be blocked from executing.
# If false, they will only be blocked when an admin tries to add them via the GUI.
block-execution: true
particle-settings:
enabled: true
view-distance: 32
# Particles for treasures not found by the current player
not-found:
enabled: true
particle: CRIT
count: 3
speed: 0.01
offset:
x: 0.3
y: 0.3
z: 0.3
# Particles for treasures already found by the current player
found-by-player:
enabled: true
particle: HAPPY_VILLAGER
count: 2
speed: 0.03
offset:
x: 0.3
y: 0.2
z: 0.3
# Particles for treasures found by another player in single-player-find collections
found-by-others:
enabled: false # Disabled by default for performance
particle: WAX_OFF
count: 2
speed: 0.3
offset:
x: 0.3
y: 0.2
z: 0.3
# Shows an action bar when the placer is in range of a treasure
proximity-settings:
enabled: true
range: 10
leaderboard:
# Maximum number of entries to display in the GUI leaderboard (per collection)
display-limit: 100
# How often to refresh the leaderboard cache in seconds (default: 300 = 5 minutes)
cache-refresh-interval: 300
hint:
# Enable/disable the hint feature
enabled: true
# Cooldown in seconds before player can request another hint
cooldown-seconds: 300
# Maximum distance in blocks to search for treasures
proximity-range: 50
# Apply cooldown if the player fails the minigame?
apply-cooldown-on-fail: true
# Apply cooldown to operators
apply-cooldown-to-operators: false
# Which coordinate to reveal: X, Z, or RANDOM (only X or Z)
reveal-coordinate: RANDOM
# Minigame settings for hints
minigames:
# Global setting to enable/disable minigames entirely
enabled: true
# Which minigame to use for hints (REACTION, MEMORY, or RANDOM)
type: RANDOM
# Settings for the Reaction minigame
reaction:
enabled: true
# Number of correct clicks required to win
required-clicks: 15
# Time in ticks (20 ticks = 1 second) before the target moves and counts as a miss
update-time: 20
# Settings for the Memory (Simon) minigame
memory:
enabled: true
# Number of rounds to complete to win
rounds: 5
# Time in ticks to show each color during the sequence display
display-time: 20
# Updates the plugin automatically when a new version comes out
updater:
# Update for AdvancedHunt plugin
enabled: true
# Update for dependency plugin
dependencies:
PacketEvents: false
NBT-API: false
PlaceholderAPI: false
sounds:
enabled: true
treasure-found:
enabled: true
sound: ENTITY_PLAYER_LEVELUP
volume: 1.0
pitch: 1.5
collection-completed:
enabled: true
sound: UI_TOAST_CHALLENGE_COMPLETE
volume: 1.0
pitch: 1.0
treasure-placed:
enabled: true
sound: BLOCK_NOTE_BLOCK_PLING
volume: 1.0
pitch: 2.0
treasure-broken:
enabled: true
sound: BLOCK_NOTE_BLOCK_SNARE
volume: 0.6
pitch: 0.8
treasure-already-found:
enabled: true
sound: BLOCK_NOTE_BLOCK_BASS
volume: 0.7
pitch: 0.5
treasure-claimed-by-other:
enabled: true
sound: ENTITY_ENDERMAN_TELEPORT
volume: 0.6
pitch: 0.8
block-protected:
enabled: true
sound: ENTITY_VILLAGER_NO
volume: 0.8
pitch: 1.0
place-mode-break-denied:
enabled: true
sound: ITEM_SHIELD_BLOCK
volume: 0.4
pitch: 0.9
place-mode-collect-denied:
enabled: true
sound: BLOCK_NOTE_BLOCK_BASS
volume: 1.0
pitch: 1.0
collection_unavailable:
enabled: true
sound: BLOCK_BEACON_DEACTIVATE
volume: 1.0
pitch: 1.0
fireworks:
# Enable or disable all custom fireworks
enabled: true
# Should the firework be silent (no launch/explosion sound)
silent: false
power:
# Minimum flight power (1 = low, 3 = very high)
min: 1
# Maximum flight power
max: 2
effects:
# Enable flickering effect
flicker: true
# Enable trail behind the firework
trail: true
# Possible firework effect types (used if random-type = true)
# Available: BALL, BALL_LARGE, STAR, BURST, CREEPER
# Will pick a random one
types:
- BALL
- BALL_LARGE
- STAR
- BURST
- CREEPER
colors:
# Main firework colors
# Available colors:
# AQUA, BLACK, BLUE, FUCHSIA, GRAY, GREEN, LIME, MAROON,
# NAVY, OLIVE, ORANGE, PURPLE, RED, SILVER, TEAL, WHITE, YELLOW
# Will pick a random one
list:
- AQUA
- BLUE
- PURPLE
- RED
- ORANGE
- YELLOW
- LIME
- WHITE
fade-colors:
# Enable fade colors after explosion
enabled: true
# Colors used for fading
list:
- WHITE
- SILVER
- GRAY
# Settings for data migration
# These settings are ONLY used when running '/ah migrate mysql'
# They define the TARGET database where data will be moved TO.
migration:
target:
host: "localhost"
port: 3306
database: "advancedhunt_target"
username: "root"
password: "password"
❤️ 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
Ченджлог
4.0.4Релиз26.1, 26.1.1, 26.1.2 · 11 июня 2026 г.
AdvancedHunt 4.0.4
Hello everyone,
today we are releasing AdvancedHunt 4.0.4! This update brings highly requested features including client-side treasure hiding, Minecraft 1.26.x support, and brand new minigames!
New Features
Client-Side Hiding
Treasures can now be hidden client-side once a player has found them. (Repleaces with barrier or air) This means collected treasures will no longer be visible to the player who found them. Thanks to tetralinear!
Minecraft 26.x Support
AdvancedHunt now fully supports Minecraft 26.x. The plugin has been tested and verified to work correctly on the latest Minecraft version.
New Minigames
We added brand new minigames for the hint functions.
Bug Fixes
- Fixed spawning firework when trying to collection a single find treausure
- Various stability improvements and internal fixes.
Also watch our new showcase video on YouTube https://www.youtube.com/watch?v=xT7ylR4qa6U
Thanks for your continued support!
Your XMC-Team
4.0.3Релиз1.21.9, 1.21.10, 1.21.11 · 4 апреля 2026 г.
Hello everyone, today we are releasing AdvancedHunt 4.0.3 what contains important bug fixes!
Changes
- Improved the treasure info view in the rewards GUI with clickable copy actions for the treasure UUID, NBT, block state, and a combined COPY ALL - DATA payload, which makes support and debugging much faster.
- Simplified /ah bypass so it now works as a direct toggle with no arguments, while still supporting explicit on and off values.
- Improved internal ACT parsing.
- Added a button to recive the UUID of the Treasures to use it in placeholders
Fixes
- Fixed legacy Skull_Item displaying
- Fixed treasure visibility restoring and rending
- Fixed legacy migration when the original live block snapshot is unavailable by preserving the migrated treasure with a generic STONE snapshot instead of dropping it entirely.
- Fixed legacy player-progress migration by adding deterministic collection-level fallback matching when exact old treasure coordinates no longer line up with migrated treasure data.
- Fixed chat-input capture reliability by moving the listener to LOWEST priority, which reduces conflicts with other chat listeners during admin prompts.
- Fixed modern XSeries/material behavior on 1.13+ servers by explicitly declaring api-version: 1.13.
- Fixed progress menu not beeing able to scroll.
- Fixed a caching bug with the progress menu
Your XMC-Team
4.0.2Релиз1.21.9, 1.21.10, 1.21.11 · 30 марта 2026 г.
Hello everyone,
in todays release are QOL Features and some Bug Fixes!
Changes
- Added a confirm menu, when using the advancedhunt collection delete command, to ensure, the player can remove the treasure blocks
- Updated all dependencies
- Added a message, when a depended plugin has a release not older than 3 days for secure reasons. It will not download before these 3 days.
- Added the Simply Chinese language back
- Added QOL Features from the pull request #6 (Thanks swag617)
Fixes
- Fixed some admin permissions not applying to all admin spesifc permissions
- Fixed a permission error for the collection info and list command
- Fixed a dependency bug for NBT-API
- Fixed plugin not working in versions below 1.21
Your XMC-TEAM
4.0.1Релиз1.21.9, 1.21.10, 1.21.11 · 1 марта 2026 г.
Hello everyone,
this update includes changes to ItemAdder-Plugin and Migration fixes.
Bug fixes
- Fixed that player data was not updated successfully
- Fixed ItemAdder Listener error
- Fixed missing config informations for languages
Your XMC-Team
4.0.0Релиз1.21.9, 1.21.10, 1.21.11 · 28 февраля 2026 г.
Hello everyone,
Today, we will release a very big update for the plugin. Version 4.0.0 will include MySQL, SQLite features, client side hiding for disabled collections and much more!
The plugin has been completely rewritten and now has a very stable version to work with and add many new things to it more easily.
New features and Improvements:
- Improved performance (Been tested with 2 players and over 1,000 -treasures and locally 1 player with 10,000 treasures)SQLITE & MySQL support!
- Added hiding treasures when collection is not available
- More particle customisability
- New memory hint mini-gameMessage rewards typeSerialised Item reward type
- Custom message upon specific reward
- 1.8.8-1.21.x Minecraft support
- Bedrock comparability support
- Rename collection support
- Removed required default collection
- Command to migrate between the new supported data types
- View and edit rewards from the list command menu
- Regex support for blacklisted commands
- Improved particle performance
- Reload command, works for almost everything now
- Command blacklist now supports Regex,
- Visual Hint particles
Pictures
Changes
- GUI menus have been redesigned
- All translation messages are now in a single file
- Reset collection schedule now uses Quartz Cron format
- Collection active window has changed
- Show Sub-command now uses PacketEvents API to only show to the command executor
Deprecated / Removed Features
- The following features have been deprecated or removed as part of the rewrite:
- Selected collection (no reason to keep this with new implementation)
- Default collection completion preset
- Rewards rarity system (still can give rewards chance and new message on reward command)
- Setting menu (everything is now setable in config)
- Item to /give command (replaced by item serialisation)
Please note that by upgrading from your old version to the new one, bugs may occur. If you encounter any of these, please contact the support. A backup will be taken!
Thanks Your XMC-Team
3.1.4-BETAБета1.21.9, 1.21.10, 1.21.11 · 30 ноября 2025 г.
Hello, today were just releasing a beta update for AdvancedHunt with some important bug fixes!
Bug Fixes
- Fixed saving wrong preset commands when preset name was 2 characters or lower
- Fixed missing text in DE language
- Fixed day in the reset not working
- Fixed bugged anvil GUIs
- Fixed not being able to switch between global and individual
- Fixed next and previous page not working in global and individual reward menu
- Fixed when changing language that pages not working right
Changes
- Changed the barrier item to an player head
- Remove the BETA tag from the reset system
XMC-Plugins
3.1.3Релиз1.21.9, 1.21.10, 1.21.11 · 27 октября 2025 г.
Hello everyone,
today we are finally releasing v3.1.3. The last update was a long time ago, but we're back.
Update Log
Bug Fixes
- Fixed the reset command
- Fixed plugin downloader bug
- Added date translation
- Fixed pistons breaking bug
- Fixed hint menu when hint count is less than 1
- Fixed showing cancel message when hint count is below 1
- Fixed some spelling issues
- Fixed place menu not scrollable
- Fixed item names and lore of treasures in the place menu
- Fixed dates not working
- Fixed some performance issues
- Fixed player head skulls not showing
- Fixed being able to take out barriers from menus
Changes
- Rarity messages can now be send with non give commands
- Settings PlayerFoundOneEggReward and PlayerFoundAllEggsReward has been removed
- Added console command Support
- Added ItemAdder support
- Allowing opening the reward menu in place mode
- Changed the settings menu items position
- Added a dot to all places in the leaderboard
- When creating a collection you now select it
- Added a view for required Requirements when you can't access the treasure
- Added support up to version 1.21.10
Future plans
We got a ton of suggestions what to add next. Sadly we the dev team currently don't have enough time for this project.
Plans we have to add are:
- MySQL support
- Hiding tresure for the players client-side after finding them
Theres features require a lot of code remake and a lot of time. This is why they aren't released now. For now we will try our best to add them but we don't think they will release in near future.
We hope for your understanding XMC-Team
3.1.1Релиз1.21.1, 1.21.2, 1.21.3 · 29 ноября 2024 г.
3.1.1 Bug fix Update
Fixes
- Updated missed config versions
- Fixed bug in plugin downloader
- Fixed bug with treasure on walls causing issues
- Fixed very rare bug in the inventory GUI menus
- Fixed bug with reset command
- Fix bug in player_name_[rank] placeholder
Improvements/Changes
- Beta change to allow rarity for non give commands
- Dependencies are now disabled by default for auto updating
- All methods use same colour method now
- Using AsyncPlayerChatEvent now
- Better random values due to single random instance
- Added Placeholder remaining_treasures_[Collection Name]
- Added Placeholder max_treasures_[Collection Name]
- Added Placeholder found_treasures_[Collection Name]
Migration Changes (Placeholders)
- found_eggs to found_treasures
- max_eggs to max_treasures
- remaining_eggs to remaining_treasures
Комментарии
Загружаем…