QuestMaster - Quest System with GUI

## Key Features

### Beautiful GUI Interface

• Intuitive Menu System - Easy-to-navigate category-based quest selection
• Visual Progress Tracking - See your quest progress at a glance
• One-Click Quest Management - Start, view, and claim rewards directly from the GUI
• Organized Categories - Quests organized into different categories (Hunter, Miner, Builder, etc.)

### Multiple Quest Types

• KILL - Defeat specific mobs or entities
• BREAK - Break specific blocks
• PLACE - Place specific blocks
• CRAFT - Craft specific items
• COLLECT - Collect items from the world

### Daily & Weekly Quests

• Automatic Reset System - Daily and weekly quests reset automatically
• Replayable Content - Keep players engaged with recurring quests
• Flexible Configuration - Set any quest as daily or weekly

### Advanced Reward System

• Experience Rewards - Grant XP to players
• Money Rewards - Vault integration for economy support
• Item Rewards - Give custom items as rewards
• GUI Reward Claiming - Claim rewards directly from the quest menu
• Auto-Complete Option - Automatically complete quests when finished

### Completion Notifications

• Sound Effects - Play level-up sound on completion
• Title/Subtitle - Display completion message as title
• ActionBar - Show completion status in action bar
• Fully Configurable - Enable/disable each notification type

### Configuration & Customization

• Easy Quest Creation - Simple YAML configuration
• Custom Messages - Fully customizable messages
• Configurable Limits - Set maximum active quests per player
• Hot Reload - Reload configuration without restart

## Requirements

• Spigot/Paper 1.19.2 or higher
• Java 17 or higher
• Vault (Optional) - Required only for economy/money rewards

## Installation

1. Download the QuestMaster-1.0.0.jar file
2. Place it in your server's plugins folder
3. Restart your server
4. Configure quests in plugins/QuestMaster/quests.yml
5. Customize settings in plugins/QuestMaster/config.yml

## Commands

• /quest or /q - Open the quest GUI menu
• /questmaster or /qm - Admin commands

- /qm reload - Reload configuration and quests

## How to Use

### For Players:
1. Use /quest to open the quest menu
2. Browse quest categories
3. Click on a quest to start it
4. Complete objectives to progress
5. Claim rewards when completed

### For Server Admins:
1. Edit quests.yml to create custom quests
2. Configure quest types, targets, and rewards
3. Set quest categories for organization
4. Enable daily/weekly resets by setting reset-type
5. Customize messages and settings in config.yml

## Configuration Files

### quests.yml
Define all your quests here with:

• Quest ID, name, and description
• Quest type (KILL, BREAK, PLACE, CRAFT, COLLECT)
• Target material or entity
• Target amount
• Rewards (experience, money, items)
• Category
• Reset type (NONE, DAILY, WEEKLY)

### config.yml
Configure plugin settings:

• Maximum active quests per player
• Auto-complete settings
• Completion notifications
• Economy settings
• Custom messages

## Quest Example

quests:
kill-10-zombies:
name: "Zombie Slayer"
description: "Defeat 10 zombies"
type: KILL
target-entity: ZOMBIE
target-amount: 10
category: Hunter
reset-type: DAILY
rewards:
experience: 100
money: 50.0## Permissions

• questmaster.use - Use quest commands (default: true)
• questmaster.admin - Admin commands (default: op)
• questmaster.* - All permissions (default: op)

## Tips & Best Practices

• Organize quests into logical categories
• Use daily quests for repeatable content
• Balance rewards based on quest difficulty
• Test quests before publishing to players
• Use the reload command to test configuration changes

## Support

If you encounter any issues or have questions:

• Check the configuration files for errors
• Ensure all dependencies are installed
• Review server logs for error messages
• Make sure you're using a compatible server version

## License

This plugin is provided as-is. Feel free to modify and use it on your server.

---

Enjoy creating amazing quest experiences for your players!