ProgressionNPCWork

Initial Release

This is a combined plugin that bundles four modules in a single JAR: ProgressionNPC, ProgressionQuest, ProgressionShop, and ProgressionCompanion.

NPC Module

- Fully custom NPC entities stored in YAML, independent of Citizens - Mojang skin fetching via MojangSkinFetcher with local SkinStore cache - LibsDisguises soft-dependency for NPC disguise support - NPC equipment GUI for configuring held items and armor - NPC protection listener to block griefing interactions - NpcApi registered to Bukkit ServicesManager for cross-plugin NPC queries

Quest Module

- Quest definitions loaded from YAML files in the quests folder - QuestStore — loads and caches all quest configs at startup - PlayerQuestStore — per-player active, completed, and visited-NPC state - QuestService — NPC visit tracking, clickable quest action buttons in chat after NPC dialogue - QuestEditor — in-game quest creation and editing via chat input sessions - ChatSessionManager / TalkContextManager — stateful player input handling - QuestPermissionService — permission-based quest access control - QuestBookUtil — generates a written quest log book for the player - TalkSignListener — sign-triggered NPC dialogue Bedrock player support via Floodgate forms (FloodgateNpcForms) - ProgressionQuestInfoProviderApi — publishes quest data to ProgressionAPI New quest architecture (this release): >- ObjectiveType — typed objectives: KILL_MOB, COLLECT_ITEM (legacy loot-field quests auto-converted in memory at load time, no file changes required) >- QuestObjective + ObjectiveParser — structured objective parsing from YAML >- QuestStage — multi-stage quest support, stages advance sequentially on completion >- RepeatType + RepeatService — daily, weekly, and cooldown-based repeat logic >- ObjectiveProgress + ProgressDisplay — per-objective progress tracking and formatted display

Shop Module

- NPC-linked shops opened on NPC right-click - Multi-page shop GUI with configurable layout - Per-entry buy and sell support with item matching via MatchCriteria - Tool price integration (ToolPrices / ToolPriceService) for dynamic pricing based on ProgressionTools - ProgressionApiItems bridge for custom item resolution in shop entries

Companion Module

- Assign NPCs as persistent combat companions - Companion combat listener tracks attack events and assists the owner - Companion healing with configurable heal amounts (CompanionHealingUtil) - Armor XP awarded to companions on hit - Ranged ammo tracking for bow-using companions - Equipment GUI for companion gear management - ProgressionToolsHook for companion tool interaction - Companion lifecycle managed across login/logout Unified command: /pnw with legacy aliases covering NPC, quest, and shop sub-commands