Astral Quests | Community Quest System v1.0

​

Transform your server with a complete quest experience​

AstralQuests is a premium, performance-focused quest plugin built for modern Paper and Folia servers. It gives players meaningful daily goals, long-term weekly challenges, and cooperative server-wide community events — all wrapped in polished GUIs with mini-caps titles, boss-bar tracking, and rich reward previews.

Whether you run a survival SMP, economy server, or hub network, AstralQuests adds retention loops players actually enjoy: streaks, leaderboards, rerolls, and events that bring the whole server together.

Media​

---

What makes AstralQuests different?​

• Folia-safe from the ground up per-player scheduling, no unsafe global player mutations
• Works standalone or with AstralCore soft-depends on AstralCore, Vault, and PlaceholderAPI
• 190+ quests included 82 daily, 54 weekly, 32 community, 25 milestones
• Healthy community scheduler automatic events with cooldowns, quiet hours, AFK filtering, and min-player gates
• Premium GUIs mini-caps titles, color-coded lore, progress bars, reward lists, click-to-track boss bars
• Participant-only community rewards only players who contributed receive payouts
• Developer API hook custom objectives and rewards into your own plugins

---

Quest Systems​

---

Player Features​

• /quests main menu with Daily, Weekly, Community, History, Leaderboards, Stats, and Streaks
• Quest tracking — click any quest to pin a boss bar showing live progress
• Quest history — view recently completed quests with timestamps
• Beautiful item lore — objectives, difficulty, progress bar, and full reward breakdown
• Action-bar milestones at 25%, 50%, 75%, and 100%
• 1 daily reroll per day (OP/bypass exempt) — blocked after completing a daily quest

---

Admin Features​

• /quests admin reload — hot-reload all configs
• /quests admin triggercommunity <id|RANDOM> — start any community quest or roll random
• /quests admin stopcommunity — stop active event (lists all quest IDs + highlights active)
• /quests admin assign <player> [weekly] — force-assign quests
• /quests admin debug — startup diagnostics report
• Full tab-completion for community quest IDs

---

Integrations​

---

Default Quest Library​

82 Daily Quests — mining, combat, fishing, farming, exploration, crafting, economy, and more

54 Weekly Quests — large-scale goals for dedicated players

32 Community Quests — cooperative server events (mine blocks, kill mobs, earn money, travel distance, etc.)

25 Milestones — lifetime achievements (first quest, 100 completions, 30-day streak, Nether visit, etc.)

All quests are fully editable in YAML. Add, remove, or rebalance without touching code.

---

Configuration​

Every system is configurable:

• config.yml — resets, rerolls, streaks, community scheduler, feedback
• daily-quests.yml / weekly-quests.yml / community-quests.yml / milestones.yml
• menus.yml — GUI layout and slots
• messages.yml — MiniMessage-supported strings
• rewards.yml — economy balancing caps
• anti-exploit.yml — creative/spectator/world filters
• leaderboards.yml — board types and refresh interval
• storage.yml — SQLite (default) or MySQL/MariaDB

---

Performance​

• HikariCP connection pooling
• Async database reads/writes
• Objective listener activation only for quest types currently in use
• Movement sampling with configurable tick interval
• Profile cache with dirty-tracking autosave

---

Commands​

/quests Open main menu
/quests daily Daily quest menu
/quests weekly Weekly quest menu
/quests community Active community event
/quests history Completed quest history
/quests leaderboard Server leaderboards
/quests reroll [daily|weekly] Reroll quests
/quests stats Player statistics
/quests streak Streak info
/quests admin reload Reload configuration
/quests admin triggercommunity <id|RANDOM>
/quests admin stopcommunity
/quests admin assign <player> [weekly]
/quests admin debug

Aliases: /quest, /aq

---

Permissions​

astralquests.use Basic access
astralquests.daily Daily quests
astralquests.weekly Weekly quests
astralquests.community Community quests
astralquests.reroll Reroll quests
astralquests.reroll.free Bypass reroll limits (OP/admin)
astralquests.extra.daily +1 daily quest slot
astralquests.extra.weekly +1 weekly quest slot
astralquests.admin Full admin access

---

PlaceholderAPI​

%astralquests_daily_completed%
%astralquests_weekly_completed%
%astralquests_current_streak%
%astralquests_quest_points%
%astralquests_community_progress%
%astralquests_community_contribution%

---

Developer API​

AstralQuestsAPI api = Bukkit.getServicesManager().load(AstralQuestsAPI.class);
api.addProgress(player, ObjectiveType.BLOCK_BREAK, "STONE", 1);
api.assignQuest(player, "daily_mine_stone", QuestCategory.DAILY);

Events: QuestAssignedEvent, QuestCompletedEvent, QuestRewardEvent, DailyQuestResetEvent

---

Requirements​

• Paper 1.21.x (Java 21+)
• Folia supported
• SQLite included (no external DB required)
• Optional: Vault, PlaceholderAPI, AstralCore

​