SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedQuality of life & UI

Progression Framework

by TechnoGoth · for Vintage Story

Framework for adding questing, unlocking traits through training, and enhanced traders

20KDownloads
1.22.1Latest game version
Vintage Story ModDBSource

About Progression Framework

From Vintage Story ModDB

Framework for adding questing, unlocking traits through training, and enhanced traders

Quests, training, and evolving traders for Vintage Story modders.

Progression Framework is a content-empty mod that provides three reusable systems for other mods to build on: a quest engine, a training/profession engine, and an evolving-trader engine. Drop JSON into your mod's asset folders and the framework discovers it at load time.


✨ For Players

This mod adds nothing on its own it was built for the Seafarer mod to provide quests, training, and unlocks.

What it gives you in-game

  • Training Ledger (L) — A tabbed dialog showing your training progress and active quests.
  • Quest log — Quests track automatically as you talk to NPCs and turn in items.
  • Evolving traders — NPC stock and dialogue change as you complete work for them.

🧩 For Modders — Overview

The framework scans every loaded mod domain for content at AssetsFinalize. Drop JSON into the conventional paths below and you have working content.

<table> <thead> <tr> <th>Subsystem</th> <th>Path</th> <th>Notes</th> </tr> </thead> <tbody> <tr> <td>Quests</td> <td>&lt;yourmod&gt;:config/quests/.json</td> <td>First-loaded wins on collisions.</td> </tr> <tr> <td>Training</td> <td>&lt;yourmod&gt;:config/training/.json</td> <td>Recognised filenames: professions.json, xp.json, config.json.</td> </tr> <tr> <td>Tradelists</td> <td>&lt;yourmod&gt;:config/tradelists/.json</td> <td>Looked up by stem from EntityEvolvingTrader JSONs.</td> </tr> <tr> <td>Dialogue</td> <td>base-game NPC conversation system</td> <td>Quests subscribe to dialogue triggers.</td> </tr> </tbody> </table>

Registered identifiers

These names are stable for cross-mod use: entity class EntityEvolvingTrader, item class ItemTrainingBook, hotkey progressionframeworkledger, network channel progressionframework:questsync, Harmony id progressionframework.


📋 Adding a Quest

Save a JSON file under your mod's config/quests/. The code is its identifier; npc is the entity code that gives it. delivery objectives count items the player turns in to that NPC; rewards fire when the threshold is hit.

<pre style="background: #1e1e1e; color: #d4d4d4; padding: 0.75em 1em; overflow-x: auto; border-radius: 4px;">{ "code": "harvest-help", "npc": "mymod:trader-farmer", "scope": "server", "autoEnable": true, "objectives": [{ "code": "deliver-wheat", "type": "delivery", "items": [{ "item": "game:grain-spelt", "quantity": 1 }], "required": 32, "rewards": [{ "type": "addSellingItem", "itemCode": "game:scythe-copper", "itemType": "item", "stacksize": 1, "stockAvg": 1, "stockVar": 0, "priceAvg": 8, "priceVar": 1 }] }] }</pre>

Quest titles, descriptions, and group names go through your mod's lang/en.json using the titleLangKey, descriptionLangKey, and groupLangKey fields.


🎓 Adding Training

A profession contains one or more trainings; each training has levels; each level grants a trait. Save the list at config/training/professions.json.

<pre style="background: #1e1e1e; color: #d4d4d4; padding: 0.75em 1em; overflow-x: auto; border-radius: 4px;">[ { "code": "gardening", "color": "#4F7F3C", "trainings": [{ "code": "gardener", "levels": [{ "level": 1, "xp": 100, "title": "Gardener", "trait": "green-thumb" }] }] } ]</pre>

XP sources go in config/training/xp.json. The craft kind grants XP whenever a matching grid recipe completes; book when an ItemTrainingBook is read; dialogue when a registered dialogue trigger fires.

<pre style="background: #1e1e1e; color: #d4d4d4; padding: 0.75em 1em; overflow-x: auto; border-radius: 4px;">[ { "type": "craft", "training": "gardener", "recipe": "mymod:flowerpot-
", "xp": 5 }, { "type": "book", "training": "gardener", "item": "mymod:trainingbook-gardener", "xp": 100 } ]</pre>

🔒 Gating a Recipe with a Crafting Trait

Once a training level grants a trait (green-thumb in the example above), any grid recipe variant with requiresTrait: "green-thumb" only matches when the player has earned that trait. A common pattern is to ship two variants &mdash; one ungated with extra ingredients (so untrained players can still build it the hard way), one trait-gated with a simpler ingredient list.

<pre style="background: #1e1e1e; color: #d4d4d4; padding: 0.75em 1em; overflow-x: auto; border-radius: 4px;">[ { "ingredientPattern": "S,F,R", "ingredients": { "S": { "type": "item", "code": "mymod:schematic-greenhouse" }, "F": { "type": "item", "code": "game:firewood", "quantity": 5 }, "R": { "type": "item", "code": "game:rope", "quantity": 4 } }, "width": 1, "height": 3, "shapeless": true, "output": { "type": "block", "code": "mymod:greenhouse-frame", "quantity": 1 } }, {

Read the full description on Vintage Story ModDB →

Highlights

From source data

Game versions

Supports 17 Vintage Story versions, the newest being 1.22.1.

Footprint

Rated a light load on a server.

Progression Framework on Nxeon

From our catalogue
One-click install
Supported on Nxeon Vintage Story servers. We download it from Vintage Story ModDB, place it, and restart the server.
Server side
Required on the server
Server load
light
Smallest plan we suggest
Vintage Story — 1 GB (1 GB RAM). This follows our own load rating above, not a benchmark.

Run Progression Framework on a Vintage Story server

Pick a server or deploy a new one above; it is installed in one click.

What kind of mod it is

From the catalog
Listed on Vintage Story ModDB as “Utility”

Quality of life & UI

Small conveniences, tweaks and interface improvements players notice straight away.

Runs on your server

From source side support

Vintage Story ModDB lists Progression Framework as required on the server. Check its Vintage Story ModDB page to see whether players need it too.

Compatibility

Game
Vintage Story
Runs on
Serverrequired on the server
Game versions
1.22.1 and 16 earlier

Verified at the source

  • ✓Vintage Story ModDBOfficial listing, checked 2026-09-24Open ↗
  • ✓AuthorTechnoGoth, as published on Vintage Story ModDB
  • ✓LicenseNot published by the sourceFree

Progression Framework, answered

Generated from the mod’s own source data.

Do my players need to install Progression Framework?

Vintage Story ModDB lists Progression Framework as required on the server. Check its Vintage Story ModDB page to see whether players need it too.

Is it free?

Yes. Progression Framework is free to download from Vintage Story ModDB.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run Progression Framework on a Vintage Story server.

Deploy in about a minute from $4.00 a month, then add Progression Framework in one click.