ItemStats, Setbonus, Items Create Inventory - Barebones Framework

What it is

[[Designed for as a barebones framework for modders to flesh out!]]

 

Item Traits is a code + assets mod for Vintage Story 1.22+ whose real job is to be a modder’s starter kit in disguise: a small, complete, runnable example of three patterns people building content mods want over and over—

1. Item → stat — Wire wearables (or, with the same idea, any item) to real Entity.Stats / health math on the server, on named layers, in a way other mods can coexist with.
2. Item → extra inventory — Show how to hang a persistent, player-scoped inventory (here: 3 slots “on” a waist item) off WatchedAttributes, how to use an InventoryBasePlayer, how to open/close/sync with the engine, and how to put a slot grid in a GuiDialog. Access your inventory with (Ctrl + Shift + B)
3. Item set → set bonus — Show how to scan a loadout each tick, combine conditions (e.g. four clothing pieces + sword in hand), and apply a global pay-off—here Survival FreeMove (flight), not a fake client buff.
   
   

The Dragoon set, the sword, the self bleed, the belt lock, the panel, the hotkey are not “the end product” in the business sense; they are the reference implementation—working game content you can play today and gut, rename, and replace tomorrow. The mod is designed for modders to flesh out on their own: add your own items, your own stat numbers, your own 5-slot pack on a quiver, your own “full set = night vision + speed” or whatever, using this repo as the map, not a locked theme park.

Framework honesty: It is not a full generic “attribute engine for every block in the game” productized in one mod—that would be a different (and much larger) mod. It is a barebones framework in the sense the Kill Streak example uses: a tight, readable, server-first set of hooks and files you can read top-to-bottom and copy the shape of.

Where the truth lives (for your fork): Server ItemTraitsServerSystem = stats, set logic, set bonus, belt persistence, bleed. Client ItemTraitsClientGuiSystem = UI + client inventory mirror + hotkey. Data in ItemTraitsConstants + DragoonBeltInventory + patches/recipes. Reality for multiplayer: same as any code mod—everyone loads the mod; your forked item codes and set rules stay server-authoritative if you follow the same split.

What it is not: A locked “only Dragoon forever” product; a second universe simulator; a client-only fake stat mod; or a promise to maintain balance for your new items—that’s your job when you flesh it out.

What it is: You modify the item stats, set bonuses, and inventory allotments you want. This is just the framework for you to manipulate creatively.

The vision is modder-utility with a live demo, not a single static fantasy.

• To modders: “Here is all three recipes—stats, item-bound inventory, set bonus—in one repo, playing in Survival, with angry, readable code. Take the patterns; paint over the Dragoon names.”
• The shipped Dragoon content = proof of concept + playable test harness: if it feels good in a real world, your variant will probably not fight the engine as badly as if you started from zero.
• Intent behind “Dragoon” specifically: A themenail (blackguard look, cursed blade, “earn the sky”) that makes the set bonus emotionally obvious in a screenshot—you can swap the flavor to “void monks,” “dwarven forge,” or “scifi jetpack set” and keep the same three pillars.

In one sentence: The vision = a modder-facing toolkit, demonstrated end-to-end through one fleshed-out set, not “a lore DLC” first.

Modders

 

Piece	What it teaches you to flesh out
ItemTraitsConstants.cs	Centralize item codes, WatchedAttributes tree keys, StatLayer names, belt inv class name and slot count, numeric policy, sword tick damage if you keep a “cost” hook. Replace wholesale for your set.
ItemTraitsServerSystem.cs	Server tick: read character, apply/remove per-piece stat layers, set WatchedAttributes for UI, save belt from DragoonBeltInventory to entity, set bonus branch (e.g. FreeMove), optional damage (bleed) as a second “example hook.” This is the spine for “when all these codes are worn/held, do X.”
DragoonBeltInventory.cs	Minimal InventoryBasePlayer + From/ToTreeAttributes + HasAnyItems for gating. Template for “N slots on an item.”
ItemTraitsClientGuiSystem.cs	Client-only: Create/cache the client inv, sync from WatchedAttributes tree, OpenInventory + packet, GuiDialog, RegisterHotKey with correct (alt, ctrl, shift) order, E-screen detection. Template for “panel + hotkey for my item inventory.”
GuiDialogDragoonBelt.cs	Richtext + AddItemSlotGrid. Template for “honest text + slots beside vanilla.”
EntityHealthBonus.cs	Isolated +max HP that can be cleared by key; template for “one stat the generic stat layer list doesn’t cover the way you want.”
assets/ (patches, recipes, lang)	How to add your item variants, crafts, and strings. Swap domain itemtraits to yours if you fork as a new mod.

How to “flesh out on your own” in practice: Fork or duplicate, change codes in constants, add new InventoryBase classes if you want two different “pocket” items, duplicate or generalize the set scan in ItemTraitsServerSystem into EvaluateMySetRule() and call it from the same tick, and re-skin assets. The Dragoon content is the wiring diagram; your content is the ink.

Composability: Named stat layers and unique tree keys; document your fork’s keys for other mod authors.

Flavor

License / use
Free to use, copy, modify, and redistribute this mod and derived works for any purpose (including commercial packs), provided you credit the original author (Squidbat) in your readme, ModDB page, or in-repo credits so others can find the upstream author for questions, debugging, or merge requests. Provide link to my profile. Same caveat as above regarding formal licenses if you need one.

(((One known bug!! When you have your Dragoon Belt on and its inventory open, you put something in the inventory, try to take off the Dragoon Belt (it wont come off), it will spawn a second Dragoon belt on your cursor sometimes.)))

Github Link: https://github.com/19HarryHaller27/-Item-Stats-Setbonus-Items-Create-Inventory