About Trait Acquirer
From Vintage Story ModDBAllows 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 dataGame 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 catalogQuality of life & UI
Small conveniences, tweaks and interface improvements players notice straight away.
Runs on your server
From source side supportVintage 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














