AdventurerQuestSystem v1.0.52

AdventurerQuestSystem​

Daily Quests, Adventurer Ranks, Configurable GUIs, Leaderboards and RPG Integrations​

Turn ordinary server activities into a rewarding long-term adventure.

AdventurerQuestSystem is an advanced quest system designed for RPG, MMORPG and survival servers.

Give your players fresh objectives every day, let them progress through eight adventurer ranks, compete on leaderboards and earn configurable rewards through a fully interactive GUI.

Whether your server uses vanilla mobs, MythicMobs, MMOItems, custom currencies or command-based rewards, AdventurerQuestSystem provides the tools needed to build a structured and engaging gameplay loop.

---

Why AdventurerQuestSystem?​

Many quest plugins only provide a list of tasks.

AdventurerQuestSystem creates a complete progression system around those tasks.

Players are encouraged to:

• Log in for newly refreshed quests
• Complete combat and collection objectives
• Progress through adventurer ranks
• Compete for leaderboard positions
• Spend currencies to refresh their available quests
• Return every day for new challenges and rewards

It is not simply a quest menu. It is a system designed to improve player activity, progression and long-term retention.

---

Main Features​

Daily Quest Rotation​

Automatically generate and refresh player quests at a configurable time.

The quest GUI can display a live countdown until the next refresh, allowing players to clearly see when new objectives will become available.

Administrators can configure:

• Daily refresh time
• Number of available quests
• Quest availability
• Quest selection weights
• Rank-based quest distribution
• Manual quest resets

This makes every new day an opportunity for players to receive a different set of challenges.

---

Eight Adventurer Ranks​

Players can progress through eight built-in adventurer ranks:

1. Bronze
2. Black Iron
3. Silver
4. Gold
5. Platinum
6. Mithril
7. Emerald
8. Diamond

Ranks are earned by completing quests and reaching configurable progression requirements.

Higher-ranked players can receive different quest selections through the weighted quest system, allowing difficult or valuable quests to appear more frequently for experienced adventurers.

Administrators can also manually change a player's adventurer rank.

---

Weighted Quest Selection​

Every quest can have its own selection weight.

Common quests may appear frequently, while rare and valuable quests can be configured with a lower appearance rate.

Quest weights can also be associated with adventurer ranks, making it possible to create progression such as:

• Entry-level quests for Bronze adventurers
• Intermediate objectives for Silver and Gold players
• Rare challenges for Mithril, Emerald and Diamond adventurers

This gives administrators greater control over quest difficulty, rarity and progression balance.

---

Interactive Quest GUI​

Players can open the quest interface using:

/aqs

The GUI can display:

• Quest name
• Quest description
• Quest type
• Current progress
• Required amount
• Quest status
• Reward information
• Adventurer rank
• Time until the next refresh
• Quest leaderboard
• Quest refresh options

Players can accept, inspect and cancel quests directly from the interface without needing to remember complicated commands.

GUI icons can also use CustomModelData, making the system suitable for servers with custom resource packs.

---

Configurable GUI Layout​

The graphical interface is not locked to one design.

Administrators can configure:

• GUI titles
• Inventory size
• Item slots
• Button materials
• Item names
• Item lore
• Decorative items
• CustomModelData
• Refresh buttons
• Leaderboard position
• Navigation elements
• Locked and unavailable displays

Create a quest menu that matches the visual identity of your server.

---

Multiple Quest States​

Every player quest has a clearly managed state:

• Available
• In Progress
• Completed
• Cancelled

Players may cancel an active quest through the GUI.

A cancelled quest remains unavailable until the next quest reset, preventing players from repeatedly cancelling objectives to search for easier tasks.

---

Multiple Quest Objectives​

AdventurerQuestSystem supports RPG-oriented quest objectives, including:

Combat Objectives​

• Defeat configured vanilla entities
• Defeat specific MythicMobs
• Track the required number of kills

Item Objectives​

• Collect or submit vanilla items
• Submit configured MMOItems
• Require specific item quantities

Exploration and Custom Objectives​

• Use supported region-based objectives
• Connect objectives to custom server content
• Trigger configurable commands as part of a reward flow

Quest definitions are stored separately from the main configuration, making large quest collections easier to organize and maintain.

---

Flexible Reward System​

Create rewards that match your server economy and progression.

Quest rewards can include:

• Vanilla Minecraft items
• MMOItems
• Economy currency
• PlayerPoints
• Console commands
• Multiple rewards from the same quest

Reward information is displayed to players before completing the quest, allowing them to understand exactly what they are working toward.

Item rewards can display their configured item names instead of raw material identifiers, creating a cleaner and more immersive interface.

---

Dual-Currency Quest Refreshing​

Players can refresh their quest selection using supported server currencies.

Available refresh methods can include:

• CMI economy currency
• PlayerPoints

Selecting the refresh button opens a separate confirmation interface where the player can choose which currency to spend.

This creates an additional currency sink and gives players more control over their daily objectives.

---

Quest Leaderboard​

Encourage competition with a built-in quest leaderboard.

The leaderboard can display the highest-performing adventurers and include:

• Player head
• Player name
• Current adventurer rank
• Completed quests by rank
• Total completed quests
• Leaderboard position

Players can compete to become the most accomplished adventurer on the server.

---

Quest Progress Scoreboard​

An optional scoreboard can display active quest progress without requiring players to repeatedly open the GUI.

The scoreboard can show:

• Active quest
• Current progress
• Required amount
• Completion status

The scoreboard system can be enabled or disabled through the configuration.

---

Configurable Sounds​

Add audio feedback to important quest events.

Separate sounds can be configured for:

• Accepting a quest
• Completing a quest
• Cancelling a quest
• Refreshing quests
• Receiving rewards
• Ranking up

Each sound can be changed or disabled according to the style of your server.

---

Fully Configurable Messages​

Player-facing messages are stored in a dedicated message configuration.

You can customize and translate:

• Quest acceptance messages
• Progress messages
• Completion messages
• Cancellation messages
• Reward messages
• Error messages
• Rank-up announcements
• Refresh notifications
• GUI text

This allows the plugin to be translated without modifying the plugin file.

---

Separate Configuration Files​

AdventurerQuestSystem separates major systems into dedicated YAML files instead of placing everything inside one large configuration.

Configuration sections can include:

• Main plugin settings
• Quest definitions
• GUI layouts
• Messages and translations
• Rank progression
• Sounds
• Rewards
• Database settings
• Scoreboard settings
• Integration settings

This structure makes the plugin easier to configure, translate and maintain.

---

Database Support​

Player progress can be stored using:

• SQLite
• MySQL

MySQL connections use a connection pool for more efficient database access, making the plugin suitable for both smaller servers and larger persistent communities.

Stored information can include:

• Player rank
• Active quests
• Quest progress
• Completed quests
• Cancelled quests
• Completion statistics
• Leaderboard data

---

Supported Integrations​

AdventurerQuestSystem is designed to work with popular RPG server plugins.

Main Integrations​

• MythicMobs
• MMOItems
• CMI Economy
• PlayerPoints
• PlaceholderAPI
• WorldGuard

Some integrations are optional and are only required when their related features are enabled.

---

Compatibility​

Compatibility with versions other than those explicitly listed is not guaranteed unless confirmed in an update.

---

Installation​

1. Stop your Minecraft server.
2. Install all required dependencies for the features you intend to use.
3. Place the AdventurerQuestSystem .jar file inside the server's plugins folder.
4. Start the server to generate the configuration files.
5. Stop the server before editing generated YAML files.
6. Configure quests, rewards, ranks, GUI layouts and database settings.
7. Start the server again.
8. Use /aqs to open the player quest interface.

When using MySQL, configure the database credentials before allowing players to use the system.

---

Suitable For​

AdventurerQuestSystem is ideal for:

• RPG servers
• MMORPG servers
• Survival RPG servers
• Adventure servers
• Dungeon servers
• MythicMobs-based servers
• MMOItems-based servers
• Long-term progression servers
• Servers seeking better daily player retention

---

Build Your Own Adventurer Guild​

Create daily challenges.

Reward meaningful progression.

Let players rise from Bronze to Diamond.

Turn routine combat, exploration and item collection into a connected progression system that gives every player a reason to return.

AdventurerQuestSystem — every quest is another step toward becoming a legendary adventurer.