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

Trait Acquirer

by Arkhael · for Vintage Story

Allows you to acquire additional traits through gameplay

54KDownloads
1.19.8Latest game version
Vintage Story ModDBSource

About Trait Acquirer

From Vintage Story ModDB

Allows you to acquire additional traits through gameplay

Adds trait manuals that can be found in various game structures or purchased from the Treasure Trader to acquire the exclusive crafting recipes from each class.

Also adds two server commands to add or remove any extra traits, though this has no effect on class traits.

Config allows setting permission level for the commands as well as disabling the manuals altogether.

 

To make your own items that add and remove Extra Traits the item needs the class "traitacquirer.ItemTraitManual" and the attribute "traitdata" containing the arrays "add" and "remove" with all lowercase trait names in the relevant array for what you want. See the source for the trait-manual.json that does this for the mod.

New 0.9.4: Trait Exclusivity & ListTraits Command

Traits can be made exclusive with one another by adding to the trait the "ExclusiveWith" array containing the trait codes for exclusive traits. This can be added to new traits or patched onto the default ones as needed.

Example:

{
  "file": "game:config/traits",
  "op": "addmerge",
  "path": "/-",
  "value": {
    "code": "testExclusive",
    "type": "mixed",
    "attributes": {},
    "exclusivewith": ["clothier", "technical"]
  }
}

Be warned that the prevention mechanism is unable to be bypassed so items that add mutually exclusive traits will be unusable, it does take into account removals however so removing an exclusive trait at the same time as you add the other is possible.

All currently loaded traits can be listed alphabetically with the "/listtraits" command, this is a lot of text even with just the default 26. Will be replaced in future with a handbook page that lists trait properties as well as exclusivities to make it easier to keep track from in-game. Replaced with the custom handbook pages in 0.9.6

New 0.9.5: Trader & Loot Configurability

Quite simple really (Though implementing it isn't), trader price and stock for manuals is configurable and as are the odds and rates of their appearing in the gear randomizer. Currently all manuals are treated the same to not bloat the config file or require too much work as the manuals aren't anywhere close to their final form.

New 0.9.6: Handbook Update

A new Handbook tab has been added which contains automatically generated pages for each trait giving details as to what effects it has, which traits it is exclusive with and the code needed for use with the commands. It also generates a page for each type of trait: Positive, Mixed and Negative. This page links to all of the traits in that type for easier navigation.

Also in this update are:
Fixes for the application of trait effects, as well as a simplification of the code that does this to hopefully improve stability in multiplayer
Improvement of the commands, including a new flag to allow forced bypassing of the exclusivity rules (Note that if you have a non-compatible trait until it is removed you will not be able to gain new traits without forcing it)
Updating trader patches for 1.20, this unfortunately breaks the trader patches on older versions of the game so if you're running 1.19 and desperately want the patches to work use the old ones from 0.9.5 instead, the error messages from the patch won't break anything else just the trader stuff

 

ToDo:

Class Manual Models and Textures

Particle & Sound effects when using a manual

More manuals to acquire the non-crafting traits through gameplay, likely with custom traits to balance addition and removal of powerful traits.

Configurable prices and drop rates for manuals

In-game class changing items

Handbook page listing traits and their details

Proper Documentation on making new content intended for this mod

Randomizer item to make acquiring traits more interesting <== Currently Working On

Issue Tracker

 

Compatability Confirmed with:

Division of Labour https://mods.vintagestory.at/divisionoflabor 
More Class Traits https://mods.vintagestory.at/show/mod/15539 
Combat Overhaul https://mods.vintagestory.at/combatoverhaul 

Incompatible (Cannot load traits, not is unusable) with:

Gardenerz https://mods.vintagestory.at/show/mod/11187 

 

Shoutout to the TraitLearner mod for having and achieving the idea in an earlier version. I considered taking over maintenance of it but the mod system has changed so much since then it was easier to just start from scratch.
https://mods.vintagestory.at/show/mod/1119

Highlights

From source data

Game versions

Built for Vintage Story 1.19.8.

Footprint

Rated a light load on a server.

Trait Acquirer 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 Trait Acquirer 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 Trait Acquirer 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.19.8

Verified at the source

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

Trait Acquirer, answered

Generated from the mod’s own source data.

Do my players need to install Trait Acquirer?

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

Is it free?

Yes. Trait Acquirer 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 Trait Acquirer on a Vintage Story server.

Deploy in about a minute from $4.00 a month, then add Trait Acquirer in one click.