About Simple Weight Mod
From Vintage Story ModDBAdds weight for items and blocks, slows and then prevents movements if is overburden.
Adds physical weight to items and blocks. Carrying too much slows you down — or stops you completely. Weights can be defined explicitly, with wildcard rules, or auto-generated by the built-in categorizer.
Config file: ModConfig/weightmod.json
Defining weights
WEIGHT_RULES — wildcard rule list
Each rule has three fields: Pattern, Weight, and Kind ("item", "block", or "bonus"). Rules are evaluated in order; the first match wins.
Pattern syntax:
game:ingot-copper — exactgame:ore- — prefix-bountiful — suffixore — contains
{ "Pattern": "game:crystalizedore-poor-", "Weight": 43, "Kind": "item" } { "Pattern": "-bountiful-hematite-*", "Weight": 104, "Kind": "item" } { "Pattern": "game:backpack", "Weight": 2000, "Kind": "bonus" }</pre> Kind: "bonus" means the item adds carry capacity (backpacks, baskets, mining bags) instead of weighing the player down.
Legacy dictionaries (still supported)
- WEIGHTS_FOR_ITEMS / WEIGHTS_FOR_BLOCKS — item or block code → weight. Processed after WEIGHT_RULES.
- WEIGHTS_BONUS_ITEMS — bonus-carry items (backpacks, clothing).
Auto-categorizer (Weight Oracle)
Out of the box WEIGHT_RULES already ships with curated values for vanilla ores, ingots, metal plates and bonus carriers (backpacks, baskets, sacks, mining bag). The oracle fills in everything that isn't covered — useful when you have modded items or just don't want to enumerate the whole game by hand.
Enable with USE_WEIGHT_ORACLE: true. On first launch the mod walks every item and block that has no weight yet, drops it into a broad bucket (tool, weapon, armor, ore, metal, wood/stone/metal/glass block, food, clothing, misc) and writes a weight into the config. Then it flips WEIGHT_ORACLE_DONE: true and stops.
The classification is intentionally coarse: oak, birch and maple planks land in the same bucket and get the same weight; granite and basalt do too. Shape adjustments are applied on top (stairs/slab ×0.5, wall ×0.8, fence/gate ×0.3, stackable ×0.8). For variant-specific weights, add a WEIGHT_RULES entry — rules are processed first and win over oracle output. Manually-defined values are never overwritten.
Tune the auto-generation with:
- BASE_WEIGHTS_BY_CATEGORY — base weight per bucket.
- MATERIAL_MULTIPLIERS — multiplier per material family (wood, stone, metal, cloth, leather, glass, gem).
Player settings
<dl style="margin: 0;"> <dt style="font-weight: bold; margin-top: 14px;">MAX_PLAYER_WEIGHT</dt> <dd style="margin: 4px 0 0 0; padding-left: 0;">Max weight at full health, no bonuses. Overloaded players can't move or jump.</dd> <dt style="font-weight: bold; margin-top: 14px;">WEIGH_PLAYER_THRESHOLD</dt> <dd style="margin: 4px 0 0 0; padding-left: 0;">Current/max ratio at which walk speed starts to drop (0 < value ≤ 1).</dd> <dt style="font-weight: bold; margin-top: 14px;">RATIO_MIN_MAX_WEIGHT_PLAYER_HEALTH</dt> <dd style="margin: 4px 0 0 0; padding-left: 0;">Floor for health-based capacity scaling. With0.4, capacity never falls below MAX_PLAYER_WEIGHT × 0.4, even at minimum health.</dd> <dt style="font-weight: bold; margin-top: 14px;">ACCUM_TIME_WEIGHT_CHECK</dt> <dd style="margin: 4px 0 0 0; padding-left: 0;">Minimum seconds between weight recalculations. Skipped if health and inventories didn't change.</dd> <dt style="font-weight: bold; margin-top: 14px;">HOW_OFTEN_RECHECK</dt> <dd style="margin: 4px 0 0 0; padding-left: 0;">Full re-evaluation interval, in seconds.</dd> <dt style="font-weight: bold; margin-top: 14px;">PERCENT_MODIFIER_USED_ON_RAW_WEIGHT</dt> <dd style="margin: 4px 0 0 0; padding-left: 0;">If true, the percent stat modifier (weightmodweightbonus) applies to raw weight instead of the bonus.</dd>Highlights
From source dataGame versions
Built for Vintage Story 1.16.5.
Footprint
Rated a light load on a server.
Simple Weight Mod 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 Simple Weight Mod 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 Simple Weight Mod 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.16.5
Verified at the source
- ✓Vintage Story ModDBOfficial listing, checked 2026-09-24
- ✓AuthorKenigVovan, as published on Vintage Story ModDB
- ✓LicenseNot published by the sourceFree
Simple Weight Mod, answered
Generated from the mod’s own source data.
Do my players need to install Simple Weight Mod?
Vintage Story ModDB lists Simple Weight Mod as required on the server. Check its Vintage Story ModDB page to see whether players need it too.
Is it free?
Yes. Simple Weight Mod 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.

Run Simple Weight Mod on a Vintage Story server.
Deploy in about a minute from $4.00 a month, then add Simple Weight Mod in one click.












