# StormQuests **Adds quest boards, NPC village quests, party-shared objectives, quest journals, rewards, quest points, and a point shop.** StormQuests is a quest system for Paper servers built around accepted quests, visible progress, NPC-driven village work, party sharing, reward scaling, and optional integration objectives from the wider Storm plugin ecosystem. It is designed for survival, RPG, and village-focused servers where quests should feel like live world activity instead of a static checklist. ## Features - Public quest board through `/quests`. - GUI quest board through `/questboard`. - Accepted quest tracking and progress through `/quest`. - Action-bar quest tracking with `/quest track ` and `/quest track off`. - Quest reward previews through `/quest rewards [id]`. - Quest chain previews through `/quest chain [id]`. - Quest points and a quest point shop. - Quest journals with readable objective text and generated location hints. - Solo quests and party-shared quests. - Repeatable quests with cooldowns. - Completed-quest prerequisites for progression chains. - StormMMO skill requirements for higher-level quests when StormMMO is installed. - Player-aware reward previews using StormMMO power-level scaling. - Quest accept and completion cutscenes with titles, subtitles, sounds, and delays. - In-game admin quest editor. - Admin create, clone, delete, toggle, validate, objective, and command-reward tools. - Built-in bundled quest seeding. - New-player starter quest flow with intro presentation. - Runtime-generated quest locations, tagged containers, quest items, hostile packs, and escort NPCs. - Automatic cleanup of generated quest runtime data on completion, abandon, reset, or NPC purge. - NPC village quest roles with deterministic names, gear, glow highlighting, protection, local patrols, and role-specific dialogue. - Village trader offers that unlock as village quest chains are completed. - Village favour display and role gates for generated village-specific quests. - Safe village quest NPC placement that searches for standable ground and avoids managed court, jail, reconstruction, and scene worlds. - Coalesced async save queue for normal gameplay progress. - SQLite storage by default, with YAML, MySQL, and MariaDB support. - Bukkit service API for managed external quests and progress credit. - Bukkit events for quest progression and shop purchase integrations. - Paper and StormServer-compatible build support from the shared codebase. ## Quest Objectives StormQuests supports many objective types, including: - `kill_entity` - `mine_block` - `place_block` - `craft_item` - `collect_item` - `deliver_item` - `travel_distance` - `visit_biome` - `visit_world` - `visit_location` - `search_container` - `quest_item` - `npc_interact` - `npc_escort` - `npc_deliver_item` - `stormmmo_xp_gain` - `stormmmo_level_reach` - `stormeconomy_action` - `stormdisguises_action` - `stormfactions_action` - `blockledger_action` - `stormcontracts_action` - `threatmeter_level_reach` - `commandfoundry_action` - `teamwork_cooperation` - `lifesaver_protection` - `lifesaver_save` - `alignment_action` - `external_progress` Objective text is rendered in player-friendly form in `/quest info`, `/quest progress`, quest tracking, and quest journals. ## Village Quest NPCs StormQuests requires NPCs and uses linked NPCs for village quest characters. When VillageGrowth is available, occupied villages with completed or detected houses can receive role-based quest NPCs around safe village anchors. VillageMemory can provide village names, parts, and resource hooks for richer village-specific work. Village NPC roles include: - Administrator - Farmer - Warrior - Cook - Archer - Builder - Trader - Healer These NPCs can offer local work, referral chains, role-specific deliveries, village favour progression, and unlocked trader stock. If VillageGrowth is unavailable, automatic village quest NPC spawning pauses and `/stormquests npcs status` reports the reason. ## Bundled Quests StormQuests ships with bundled quest content for early progression, village support, travel, recovery, combat, delivery, escorting, faction work, investigation, contract noticeboards, danger checks, disguise practice, home setup, and report-back objectives. Examples include: - `newcomers-first-steps` - `lost-villager-escort` - `village-supplies` - `smiths-restock` - `community-lanterns` - `watch-at-the-gate` - `trusted-hands` - `danger-at-the-crossing` - `coin-for-the-coffer` - `mask-at-the-hedgerow` - `charter-at-the-crossroads` - `homeward-bound` - `supply-the-banner` - `ledger-at-the-gate` - `noticeboard-bounty` Bundled quests use prerequisites to form a simple progression path from the starter quest into village work, artisan tasks, faction support, investigation, utility goals, and higher-risk adventure branches. ## Rewards Quest rewards can include: - Quest points. - StormEconomy money. - StormMMO XP. - Alignments actions. - Safe command rewards. StormMMO reward scaling can increase money and MMO XP rewards based on player power level. Reward previews use the same scaling path as actual reward delivery, so players see what they will actually receive. Reward commands are security-sensitive. StormQuests includes a blocked-command list for authentication and account-sensitive commands, and managed external quests cannot bypass validation. ## Quest Points And Shop Players earn quest points from completed quests. Quest point shop rewards can include: - Point costs. - Cooldowns. - Purchase limits. - Permission requirements. - Command rewards. Commands: - `/quest points` - `/questshop [page]` - `/questshop buy ` ## Commands Player commands: - `/quests [page]` - `/quest info ` - `/quest accept ` - `/quest abandon ` - `/quest progress [id]` - `/quest rewards [id]` - `/quest chain [id]` - `/quest complete ` - `/quest track ` - `/quest track off` - `/quest points [player]` - `/questboard` - `/questshop [page]` - `/questshop buy ` Admin commands: - `/stormquests editor` - `/stormquests status` - `/stormquests audit` - `/stormquests storage` - `/stormquests save` - `/stormquests backup` - `/stormquests reload` - `/stormquests reset [quest]` - `/stormquests points ` - `/stormquests npcs status` - `/stormquests npcs purge` - `/stormquests npcs spawnnow` - `/stormquests premadenpcs` - `/stormquests create [display name]` - `/stormquests delete ` - `/stormquests clone

` - `/stormquests toggle ` - `/stormquests validate ` - `/stormquests addobjective ` - `/stormquests addcommand ` `/stormquests premadenpcs` is kept as a compatibility alias for the quest NPC cleanup and eligible-village refresh flow. ## Permissions Normal player access is granted by default through `stormquests.defaults`. Player permissions: - `stormquests.quests` - `stormquests.quest` - `stormquests.shop` - `stormquests.points.others` Admin permissions: - `stormquests.admin` - `stormquests.admin.command` - `stormquests.admin.editor` - `stormquests.admin.audit` - `stormquests.admin.storage` - `stormquests.admin.save` - `stormquests.admin.backup` - `stormquests.admin.reload` - `stormquests.admin.reset` - `stormquests.admin.points` - `stormquests.admin.premade` - `stormquests.admin.npcs` ## Storage StormQuests supports: - SQLite - YAML - MySQL - MariaDB SQLite is the default: - `plugins/StormQuests/stormquests.db` Stored data includes quest definitions, objectives, prerequisites, rewards, cutscenes, shop rewards, player progress, completed quests, cooldowns, quest points, tracked quests, runtime metadata, generated quest data, and audit records. ## Integrations StormQuests requires: - **NPCs** for linked quest NPCs, visible village roles, patrol behaviour, protection, trader offers, escorts, and NPC interaction objectives. Optional integrations include: - **VillageGrowth** for eligible village discovery, village centres, completed-building counts, and village quest NPC spawning. - **VillageMemory** for village names, village parts, and bounded village resource benefits. - **StormParty** for nearby party-shared quest progress. - **StormEconomy** for money rewards and economy-action objectives. - **StormDisguises** for disguise apply and clear objectives. - **StormMMO** for XP rewards, skill requirements, level objectives, and power-based reward scaling. - **Teamwork** for cooperation objectives. - **Lifesaver** for protection and save objectives. - **Alignments** for action objectives and quest-completion alignment rewards. - **StormFactions** for faction creation, claims, bank, member, and power objectives. - **BlockLedger** for case-work objectives. - **StormContracts** for contract post, track, progress, claim, and payout objectives. - **ThreatMeter** for danger-level objectives. - **CommandFoundry** for home, kit, and teleport utility objectives. - **ThunderPerms** for permission checks when available. Optional integrations stay inert when their plugin is missing or disabled. The relevant objectives simply wait for the matching integration signal instead of breaking the quest system. ## External Quest API StormQuests exposes a Bukkit service API for other plugins. The API can: - Inspect quests and shop rewards. - Inspect active quest progress. - Inspect the tracked quest. - Inspect and modify quest points. - Accept, complete, and abandon quests. - Buy shop rewards. - Register owner-prefixed managed external quests. - Credit `EXTERNAL_PROGRESS` objectives. - Remove external quests. - Check storage health. This lets other plugins safely add managed quest hooks without directly mutating StormQuests storage. ## Notes StormQuests is built for servers that want questing to be part of normal survival play. Players can find villages, speak with NPCs, follow chains, track objectives, share progress with nearby party members, earn rewards, spend quest points, and unlock more work over time. The plugin focuses on safe integration behaviour, readable player-facing objective text, recoverable generated runtime content, and admin tools for maintaining custom quests on live servers.

Published on	May 26, 2026
Downloads	0

StormQuests

Release 0.1.0

AugmentedThunder released StormQuests version 0.1.0 on Yesterday 1:46 PM

Information

Platforms

Dependencies

Release
0.1.0