Alegacy Quest Framework

Quest Engine for Vintage Story

Found a bug or have questions about how something works? Join our Discord and ask your questions there!

Alegacy Quest Framework is a full-featured quest and boss combat engine for Vintage Story. Originally started as a fork of VSQuest by G3rste, the project has since been completely rewritten and expanded into a standalone framework powering the alegacy.online server.

The mod includes quest system with branching NPC dialogues, real-time objective tracking, boss hunts with rotation and combat AI, solo trials with difficulty tiers, custom items with quality and stats, a journal, promo codes, quizzes, reputation, and more. All systems are modular — use what you need.

Everything is data-driven through JSON configs. No C# knowledge required — define quests, dialogues, items, bosses, and entire questlines purely through configuration files distributed as separate mod packs. Full documentation is available on GitLab. A dedicated visual desktop editor (desktop app) is included for creating and managing all content without touching JSON manually — featuring a node-based quest graph, item/boss editors, localization tools, validation, and patchnote generation. Note: the editor is in active development and does not yet cover all framework features.

Source code and documentation on GitLab. Licensed under a custom license.

⚠️ BEFORE YOU INSTALL

The mod depends on Arcanum Lib!

Quests from the original VSQuest mod are not compatible. This mod is under active development. It does not add content — it provides the framework to create content. Without quest packs installed, it does nothing. Singleplayer mode is not the primary target and may have bugs, the framework is designed and tested for dedicated servers.

Want a feature added? Describe it in our Discord and we'll consider it for future updates.

📦 EXAMPLE QUEST PACKS

These packs were created for the Alegacy server. They are balanced for our server environment and won't work properly elsewhere, but you can use them as learning examples.

• Alegacy Quest 2 — Full quest pack: 6 NPCs, 4 custom bosses, several mobs, 12+ unique items, 25+ quests with branching storylines, boss hunts, hollow trials, reputation system

The core system handles the full quest lifecycle: accepting from NPCs, tracking objectives in real-time, completing with rewards, managing cooldowns and prerequisites. All quest data is defined in JSON files within your mod's assets.

• › NPC Quest Givers — NPCs offer quests from pools, by priority, rotation, or only the active boss hunt. Configurable max available quests, chain cooldowns, single-at-a-time mode
• › Multi-stage Quests — Sequential stages with auto-progression. Each stage has its own objectives, title, and completion actions. Build long narrative campaigns as a single quest
• › 20+ Objective Types — Kill, gather, interact, reach waypoint, walk distance, craft, mine, fish, plant, wear items, check variables, time gates, temporal storms, sequences, and more
• › 50+ Actions — Give/take items, spawn entities, modify attributes, play sounds, show messages, start/complete other quests, open UIs, run commands, add journal entries, grant reputation
• › Reward System — Item rewards (fixed or random from weighted pool), action rewards, random item rewards with configurable select amount
• › Prerequisites & Cooldowns — Gate quests behind completed quests, player attributes, or time. Per-player cooldowns prevent farming
• › Event Hooks — Actions fire on accept, on each stage complete, on quest complete, and on fail. Chain quests together or trigger world events
• › Multi-domain Loading — Configs load from multiple mods simultaneously. Distribute quest packs as separate mods that all use the same framework
• › Per-player State — Independent progress tracking with full persistence. Supports both per-player and global quests

• › Branching Conversations — Tree-based dialogue with NPC speech and player choices
• › Conditional Branches — Show/hide options based on attributes, quests, variables
• › Inline Actions — Execute any quest action directly from dialogue via trigger
• › Full Localization — All text uses lang keys, supports any language

Two boss combat systems: rotating world bosses for group play, and solo challenges with competitive progression.

Boss Hunt (group):

• › Deterministic rotation with persistent state across restarts
• › Anchor blocks define spawn locations, tracker item shows distance
• › Relocation protection during combat, quest system integration

Hollow Trials (solo):

• › 3 difficulty tiers with escalating stats, solo enforcement
• › Weekly modifiers (negative/positive/combo), 7 challenge types
• › Void Shards currency + shop with randomized cases
• › Configurable quality tiers on rewards, progressive difficulty

Modular entity behaviors attachable to any entity via JSON. Each supports HP-threshold stages, cooldowns, animations, and sound effects.

Combat:

Defense & Phases:

Summons & Utility:

Conditions players must fulfill. Continuously checked while quest is active. Combinable, and sequence enforces strict ordering.

Executable commands that fire on quest events (accept, complete, fail) or from NPC dialogue triggers. Chainable with semicolons.

Special items that execute quest actions when used. They can have custom names, rich-text descriptions, stat attributes, durability, and multiple interaction modes. A fully configurable quality system lets you define your own tiers with custom names, colors, multipliers, and drop chances.

• › 15+ Stat Attributes — attackpower, walkspeed, critchance, critdamage, bossdamage, hungerrate, warmth, knockback, rangedaccuracy, maxhealth, and more
• › Custom Quality Tiers — Define any number of tiers with custom names, hex colors, stat multipliers, and per-item drop chance weights
• › Multiple Actions — Execute one or more actions per use. Different actions per tool mode (F-key selector)
• › Movement Locks — Prevent moving, equipping, dropping, or losing on death. Restrict to hotbar only
• › Auto-Trigger — Optionally execute actions on inventory pickup (once per item ID)
• › Durability & Repair — Items support durability with admin repair/destruct commands

Credits & Support

Authors: DreadMob · Flajakay

GitLab    Docs    Discord