Advancement Hunt

A challenging minigame plugin that transforms Minecraft advancements into an exciting time-based challenge!

---

📖 Description

Advancement Hunt turns vanilla Minecraft advancements into an engaging minigame where players race against time to complete randomly assigned tasks. Starting from basic challenges like mining stone, players progress through increasingly difficult tasks, all while racing against a 10-minute timer per task!

Key Features:

• 🎯 Progressive task system
• ⏲️ Time-based challenges
• 🔄 No task repetition
• 📊 Multiple difficulty tiers
• 👥 Multi-player support

---

📥 Installation

1. Download Advancement-Hunt.jar
2. Place in your server's plugins folder
3. Restart server
4. Ready to play!

---

🎮 Commands

Command	Parameters	Description	Permission	Example	Notes
/advancedhunt start	None	Starts a new advancement hunt game	advancementhunt.play	/advancedhunt start	- Cannot start if already in a game - Starts with default or previously set task count - Initiates the 10-minute timer
/advancedhunt stop	None	Stops the current game	advancementhunt.play	/advancedhunt stop	- Cancels current task - Clears progress - Can be used anytime during game
/advancedhunt advancement		Sets the number of tasks to complete	advancementhunt.play	/advancedhunt advancement 5	- Must be > 0 - Recommended: 1-10 tasks - Can be set before starting game
/advancedhunt status	None	Shows current game status	advancementhunt.play	/advancedhunt status	Displays: - Current task - Tasks remaining - Time remaining - Progress so far

---

🎯 Task Categories

🌱 Basic Tasks

• Mine Stone
• Upgrade Tools
• Sleep in Bed

🪨 Gathering Tasks

• Smelt Iron
• Plant Seed
• Form Obsidian

⚔️ Combat Tasks

• Kill a Mob
• Shoot an Arrow
• Throw a Trident

🏰 Advanced Tasks

• Enter the Nether
• Find Fortress
• Summon Iron Golem
• Trade with Villager
• Breed an Animal
• Use Totem of Undying

---

🎮 How to Play

1. Set your challenge:

/advancedhunt advancement 5

2. Begin the hunt:

/advancedhunt start

3. Complete tasks before time runs out!

   • Each task has a 10-minute limit
   • Tasks follow progression (basic → advanced)
   • No repeating tasks

4. Check progress anytime:

/advancedhunt status

---

⚙️ Requirements

• Server: Paper/Spigot 1.20.x
• Java: 17+

---

🔍 Additional Info

Task Progression Example

Mine Stone → Upgrade Tools → Kill a Mob → Shoot Arrow
Mine Stone → Smelt Iron → Form Obsidian → Enter Nether

Features in Detail

• Progressive System: Tasks unlock based on completed prerequisites
• Time Management: 10-minute timer per task keeps gameplay exciting
• Visual Feedback: Title messages and chat notifications
• Tab Completion: Easy command access
• Multi-Game Support: Different players can run separate games

---

🤝 Support

Found a bug or need help? report on our Discord Server!

---

Made with ❤️ for the Minecraft community