# ProgressionNPCWork<\/p>\n
– ProgressionNPCWork is a single, merged Paper plugin that bundles four systems into one clean workflow:<\/p>\n
– ProgressionNPC \u2192 persistent NPCs with admin tools, skins, and equipment<\/p>\n
– ProgressionQuest \u2192 YAML-driven quests with NPC dialogue + clickable chat actions<\/p>\n
– ProgressionShop \u2192 NPC-bound buy\/sell shops with GUI<\/p>\n
– ProgressionNPCCompanion \u2192 quest companions (followers) with optional combat + escort targets + gear transfer<\/p>\n
Everything is stored in simple files under plugins\/ProgressionNPCWork\/, so you can manage content with commands, in-game editors, or raw YAML.<\/p>\n
# Highlights<\/p>\n
– One plugin, four core RPG systems (NPCs, Quests, Shops, Companions)<\/p>\n
– NPC dialogue + quests shown directly in chat (with clickable Accept \/ Turn-in)<\/p>\n
– Quest safety rules: accept\/turn-in only works after talking to the correct NPC<\/p>\n
– Main-quest chains (Hauptquest) + standalone side quests (Nebenquest)<\/p>\n
– Loot turn-in parsing (supports multiple items + optional cmd=…)<\/p>\n
– Companion system:<\/p>\n
– smooth follow behavior (does not reposition just because you rotate)<\/p>\n
– optional combat assist (never targets players)<\/p>\n
– escort goal support (auto-despawn when target is reached)<\/p>\n
– Shift + Rightclick companion to open an equip GUI<\/p>\n
– auto-return companion gear on quest end\/fail (and on next join if anything is left behind)<\/p>\n
– ### Shop system:<\/p>\n
– file-based shops (shops\/*.yml)<\/p>\n
– buy + sell entries<\/p>\n
– supports ProgressionAPI item specs (if available)<\/p>\n
– uses ProgressionEconomy for actual money handling (if installed)<\/p>\n
### Why you\u2019ll love it<\/p>\n
– You can build a real MMO-style quest hub fast: create NPC \u2192 add dialogue \u2192 create quest \u2192 activate \u2192 done.<\/p>\n
– Players get a clear flow: talk \u2192 accept \u2192 deliver items \u2192 turn in, with minimal commands.<\/p>\n
– It\u2019s built for server iteration: edit YAML, run reload commands, keep moving.<\/p>\n
– You can create escort \/ companion quests without custom scripting.<\/p>\n
### Features
\n– NPC System (ProgressionNPC)<\/p>\n
– NPC creation\/removal\/listing<\/p>\n
– \u201cLook at players\u201d toggle<\/p>\n
– \u201cAnimations \/ AI\u201d toggle + anchor control (keeps NPC at its position)<\/p>\n
– Teleport NPC to you<\/p>\n
– NPC equipment GUI (armor + main\/offhand)<\/p>\n
Skin system:<\/p>\n
– save Mojang skin by player name<\/p>\n
– assign saved skin to NPC<\/p>\n
Protection:<\/p>\n
– NPCs can\u2019t be damaged<\/p>\n
– interactions are controlled (no vanilla villager trading)<\/p>\n
### Quest System (ProgressionQuest)<\/p>\n
– Quest definitions stored as YAML (quests\/ – NPC dialogue lines stored per NPC (npcs\/ – Clickable quest actions in chat under the dialogue:<\/p>\n – [Accept] \u2192 runs \/pv quest accept – [Turn-in] \u2192 runs \/pv quest turnin – Quest prerequisites (quest chains) via requires_completed<\/p>\n Turn-in rules:<\/p>\n – must talk to the correct NPC (context system)<\/p>\n – optional \u201cvisit NPCs before turn-in\u201d requirement<\/p>\n Rewards:<\/p>\n – XP reward (grants real XP)<\/p>\n – Item rewards (grants real items)<\/p>\n – Coins reward is currently displayed (quest economy payout is not implemented here)<\/p>\n Quest book:<\/p>\n configurable questbook.yml (title\/author\/CMD\/pages\/layout)<\/p>\n – \/pv give questbook<\/p>\n ### Shop System (ProgressionShop)<\/p>\n – Shops loaded from shops\/*.yml<\/p>\n – Each shop is tied to an npcId<\/p>\n – GUI-based buy\/sell<\/p>\n – Buy supports item spec (ProgressionAPI) or vanilla material definition<\/p>\n – Sell supports match rules (e.g., material-based)<\/p>\n – Optional background filler + navigation\/back button settings<\/p>\n – Economy integration:<\/p>\n – requires ProgressionEconomy to actually buy\/sell<\/p>\n ### Companion System (ProgressionNPCCompanion)<\/p>\n – Companion can be enabled per quest (companion.enabled)<\/p>\n – Optional combat support (companion.combat)<\/p>\n – Optional escort system:<\/p>\n – set a target location + radius<\/p>\n – when player + companion reach it, it marks reached and despawns the companion<\/p>\n Template NPC support:<\/p>\n – companion can copy name\/skin\/equipment from a chosen NPC template (companion.templateNpcId)<\/p>\n Gear transfer:<\/p>\n – Shift + Rightclick your companion \u2192 open equip GUI<\/p>\n – saved per-player\/per-quest<\/p>\n – auto-returned on quest end\/fail (and recovered on join if left over)<\/p>\n ### Setup<\/p>\n – Install<\/p>\n – Put the jar in your server\u2019s plugins\/ folder.<\/p>\n – Required dependency<\/p>\n – ProgressionAPI (hard depend)<\/p>\n – Optional dependencies (recommended)<\/p>\n – LibsDisguises + ProtocolLib (needed for player-skin disguises on NPCs\/companions)<\/p>\n – ProgressionEconomy (needed for shop buy\/sell to actually work)<\/p>\n ### First start<\/p>\n – The plugin generates files into:<\/p>\n – plugins\/ProgressionNPCWork\/config.yml<\/p>\n – plugins\/ProgressionNPCWork\/settings.yml<\/p>\n – plugins\/ProgressionNPCWork\/ui.yml<\/p>\n – plugins\/ProgressionNPCWork\/messages.yml<\/p>\n – plugins\/ProgressionNPCWork\/colors.yml<\/p>\n – plugins\/ProgressionNPCWork\/questbook.yml<\/p>\n – plugins\/ProgressionNPCWork\/tool_prices.yml<\/p>\n – plugins\/ProgressionNPCWork\/shops\/ (creates an example shop if empty)<\/p>\n – plugins\/ProgressionNPCWork\/templates\/ (quest + npc templates)<\/p>\n ### Compatibility<\/p>\n – Platform: Paper (uses Paper Brigadier command registration)<\/p>\n – Minecraft: api-version: 1.21 (built against Paper 1.21.11 API)<\/p>\n – Java: 21<\/p>\n – Depends: ProgressionAPI<\/p>\n – Softdepends: ProtocolLib, LibsDisguises, ProgressionEconomy<\/p>\n ### Basic workflow<\/p>\n – Create an NPC<\/p>\n – \/pnpc npc create – (Optional) Give it a skin<\/p>\n – \/pnpc skin save – \/pnpc skin set – Add dialogue lines for that NPC<\/p>\n – Select NPC (admin, in-game): Shift-rightclick the NPC (or use selection tools)<\/p>\n – Add dialogue:<\/p>\n – \/pv chat create – Create a quest<\/p>\n – Main quest chain:<\/p>\n – \/pv hauptquest create – Side quest:<\/p>\n – \/pv nebenquest create – Edit quest content<\/p>\n – \/pv quest edit – Set task text, loot requirement, visited NPC requirements, rewards, companion settings<\/p>\n – Activate the quest<\/p>\n – \/pv quest end – Player gameplay loop<\/p>\n – Player rightclicks the NPC \u2192 dialogue shows \u2192 quests appear with clickable buttons<\/p>\n – Accept \u2192 do task \u2192 turn-in<\/p>\n – (Optional) Add a shop to an NPC<\/p>\n – Create\/edit shops\/ – Bind shop to NPC:<\/p>\n – \/pshop bind ProgressionNPCWork is currently a merged Paper plugin that combines NPC, quest, shop, and companion systems under \/pnw and already includes dialogue book UI, reload\/config features, Bedrock support, and companion logic.<\/p>\n","protected":false},"featured_media":125376,"template":"","meta":{"_minecraft_slug":"progressionnpcwork","_minecraft_project_id":"XO4LCKLm","_minecraft_author":"Thurindir","_minecraft_license":"MIT","_minecraft_downloads":36,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"progressionnpcwork.zip","_minecraft_size_bytes":560325,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T21:46:59.991963Z","_minecraft_date_created":"2026-03-09T23:22:16.002118Z","_minecraft_date_modified":"2026-03-15T16:14:45.145266Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/progressionnpcwork","_minecraft_icon_attachment_id":125376,"_minecraft_imported_at":"2026-06-07T08:47:27+00:00","_minecraft_import_hash":"dc32422ec25c600024e75b27c34a6300","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,844,89,127,869,92],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-125375","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-economy","mod_category-game-mechanics","mod_category-paper","mod_category-transportation","mod_category-utility","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n