MineQuests
The Ultimate Quest System for Your Minecraft Server
✦ 13 Quest Types ✦ Party System ✦ Leaderboards ✦ Multi-Database ✦ GUI Menu ✦
⚡ Overview
MineQuests is a feature-rich, fully configurable quest system designed to bring your server to life. Give your players meaningful goals, track their progress, and reward them — all through an intuitive GUI and powerful YAML configuration.Whether you run a survival, RPG, or minigame server, MineQuests provides the tools to keep your players engaged and coming back for more.
✨ Features
- 13 Quest Types — Block Break, Mob Kill, Fishing, Playtime, Crafting, Block Place, Enchanting, Breeding, Consuming, Traveling, Trading, Damage Dealt, and Shearing
- Interactive GUI Menu — Beautiful paginated quest menu with sorting, filtering by category, and visual progress bars
- Party System — Players can team up, share quest progress, and complete group objectives together
- Leaderboards & Statistics — Track quest completions, playtime, and more with server-wide rankings
- Flexible Rewards — Money (Vault), items, experience, permissions (LuckPerms), and custom commands
- 5 Difficulty Levels — Easy, Medium, Hard, Expert, and Legendary with configurable display
- Quest Prerequisites — Chain quests together so players must complete one before unlocking the next
- Advanced Requirements — Level, permission, money, inventory items, playtime, and quest completion count
- Automated Resets — Daily, weekly, and monthly quest resets with player notifications
- Rich Notifications — Action bar, boss bar, toast notifications, custom sounds, and particle effects
- Server Announcements — Broadcast quest completions, first completions, and milestone achievements
- Quest Book — Give players a physical quest book item that opens the menu on right-click
- Multi-Database Support — YAML (default), SQLite, and MySQL with async operations and HikariCP pooling
- PlaceholderAPI Support — Display quest data anywhere with built-in placeholders
- Hex Color Support — Full hex color codes (&#RRGGBB) on 1.16+ servers
- Developer API — Custom events (QuestStartEvent, QuestCompleteEvent, QuestAbandonEvent, QuestProgressEvent) for addon development
- Fully Configurable — Every message, GUI element, sound, and behavior can be customized
Commands
Player Commands:
Code (Text):
/quest - Open the quest menu
/quest list - List all available quests
/quest start <id> - Start a quest
/quest abandon <id> - Abandon an active quest
/quest info <id> - View quest details
/quest active - View your active quests
/quest stats - View your statistics
/quest book - Receive a quest book
/quest leaderboard [type] - View the leaderboard
/quest party create - Create a party
/quest party invite <player> - Invite a player
/quest party leave - Leave your party
/quest party kick <player> - Kick a party member
/quest party info - View party details
Code (Text):
/questadmin reload - Reload configuration and quests
/questadmin reset <player> - Reset a player's quest data
/questadmin give <player> <quest> - Force-start a quest for a player
/questadmin complete <player> <quest> - Force-complete a quest
Permissions
Code (Text):
minequests.use - Basic quest access (default: true)
minequests.menu - Open quest GUI (default: true)
minequests.book - Receive quest book (default: true)
minequests.stats - View statistics (default: true)
minequests.party - Use party system (default: true)
minequests.leaderboard - Access leaderboards (default: true)
minequests.admin - Admin commands (default: op)
️ Supported Storage
- YAML (Default) — File-based, no setup required. Great for small servers.
- SQLite — Lightweight embedded database. Good for small-medium servers.
- MySQL — Full database with connection pooling. Ideal for networks and large servers.
Soft Dependencies
- Vault — For money-based rewards and requirements
- PlaceholderAPI — For displaying quest data with placeholders
- LuckPerms — For permission-based rewards
PlaceholderAPI Placeholders
Code (Text):
%minequests_active_total% - Number of active quests
%minequests_completed_total% - Total quests completed
%minequests_current_progress% - Current quest progress (%)
%minequests_playtime% - Total playtime (minutes)
%minequests_playtime_hours% - Total playtime (hours)
Quest Types
- Block Break — Mine or break specific blocks
- Mob Kill — Kill specific mobs or creatures
- Fishing — Catch fish
- Playtime — Play on the server for a set amount of time
- Craft — Craft specific items
- Place Block — Place specific blocks
- Enchant — Enchant specific items
- Breed — Breed specific animals
- Consume — Eat or drink specific items
- Travel — Travel a set number of blocks
- Trade — Trade with villagers
- Damage Dealt — Deal a set amount of damage
- Shear — Shear sheep
⚙️ Compatibility
- Minecraft Versions: 1.8 - 1.21+
- Server Software: Spigot / Paper
- Java: 8 or higher
Screenshots
Spoiler: Quest Menu
![[IMG]](//proxy.spigotmc.org/dc673f4ce706cca8bf7e703cbb345cddbd1f6af7/68747470733a2f2f692e696d6775722e636f6d2f4e4d454637684b2e706e67)
Spoiler: Quest Progress
![[IMG]](//proxy.spigotmc.org/af1bb5b5ea70607fcec3012c104a9ea721df08da/68747470733a2f2f692e696d6775722e636f6d2f50394f50464b562e706e67)
Spoiler: Leaderboard
![[IMG]](//proxy.spigotmc.org/4d26faacf72402592bf55e905ae94845ea1aa02a/68747470733a2f2f692e696d6775722e636f6d2f504241734d327a2e706e67)
Installation
- Download the plugin JAR file.
- Place it in your server's plugins folder.
- Restart (or reload) your server.
- Edit config.yml and quests.yml to your liking.
- Run /questadmin reload to apply your changes.
Support
Need help? Have a suggestion? Found a bug?
Join our Discord: Click Here
Open a ticket on this resource page.
Need help? Have a suggestion? Found a bug?
Join our Discord: Click Here
Open a ticket on this resource page.
Made with ❤️ for the Minecraft community.
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.8, 1.9, 1.10
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
MineQuests is a free Minecraft Java mod. Compatible with Minecraft 1.8, 1.9, 1.10, 1.11 and newer. Downloaded 15 times (via Spigot). Download it and open it directly in the game.