Advancement-Hunt

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<br>- Starts with default or previously set task count<br>- Initiates the 10-minute timer | | /advancedhunt stop | None | Stops the current game | advancementhunt.play | /advancedhunt stop | - Cancels current task<br>- Clears progress<br>- Can be used anytime during game | | /advancedhunt advancement | <number> | Sets the number of tasks to complete | advancementhunt.play | /advancedhunt advancement 5 | - Must be > 0<br>- Recommended: 1-10 tasks<br>- Can be set before starting game | | /advancedhunt status | None | Shows current game status | advancementhunt.play | /advancedhunt status | Displays:<br>- Current task<br>- Tasks remaining<br>- Time remaining<br>- 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

- Multi-Game Support: Tasks unlock based on completed prerequisites - Multi-Game Support: 10-minute timer per task keeps gameplay exciting - Multi-Game Support: Title messages and chat notifications - Multi-Game Support: 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*