QuestTracker
Multi-category quest system with GUI menu, rewards, and Discord leaderboards
Item · Movement · Combat · GUI · Economy · Discord webhooks
⚡ What does it do?
QuestTracker gives your players a rotating selection of quests across three categories — item collection, movement, and combat. Players open a GUI menu, pick a quest, complete the objectives, and earn money, points, and bragging rights on the leaderboard. Weekly leaderboards post automatically to Discord.
One active quest per category, scaling difficulty (Easy/Medium/Hard), and abandon cooldowns keep progression engaging without overwhelming players.
✨ Features
- Three quest categories:
• Item — Collect crops, ores, logs (tracks harvesting, excludes player-placed blocks, checks crop growth)
• Movement — Run, swim, crouch, jump, parkour challenges
• Combat — Kill specific mobs or bosses
- GUI quest menu — Clean chest UI with category tabs, quest selection by difficulty, and active quest progress display.
- Scaling rewards — Easy ($1k + 1pt), Medium ($5k + 3pt), Hard ($20k + 7pt). All values configurable.
- One quest per category — Players can have up to three active quests (one per category) simultaneously.
- Quest rotation — 3 random quests per difficulty per category. Refreshes on completion.
- Abandon cooldown — 24-hour cooldown (configurable) on the entire category after abandoning a quest.
- Leaderboards — In-game paginated leaderboards by category or total points. Monthly winners tracked.
- Discord integration — Weekly leaderboard posts to Discord via webhook with embedded formatting.
- PlaceholderAPI — 40+ placeholders for scoreboards, holograms, and other plugins.
- Smart tracking — Crop harvesting checks full growth. Ores track as raw variants. Player-placed blocks excluded from collection. Movement tracking toggles based on active quest.
- Statistics — Total points, per-category points, quests completed/abandoned. Leaderboards.
Commands
- /quest — Open quest menu
- /quest progress — View active quest progress
- /quest abandon <category> — Abandon a quest (24h cooldown)
- /quest leaderboard [category|total] — View rankings
- /quest stats — Your stats
- /quest reload — Reload config and quests
- /quest admin list — All loaded quests
- /quest admin reset <player> — Reset player data
- /quest admin setpoints <player> <amount> — Set points
- /quest admin testdiscord — Test webhook
Permissions
- questtracker.use — All player commands and GUI (default: everyone)
- questtracker.admin — Admin commands (default: op)
- questtracker.reload — Reload config (default: op)
- questtracker.stats — View own stats (default: everyone)
- questtracker.stats.others — View others' stats (default: op)
⚙️ Quest Example
Code (YAML):
# quests.yml example
quests:
mine_diamonds:
name
:
"Diamond Hunter"
category
: ITEM
difficulty
: HARD
type
: COLLECT_ITEM
target-item
: DIAMOND
target-amount
: 64
reward-money
: 20000
reward-points
: 7
Requirements
- Paper/Spigot/Bukkit 1.19+
- Java 17+
- VersionAdapter (required)
- Vault + economy plugin (optional — for money rewards)
- PlaceholderAPI (optional — for 40+ placeholders)
Links