HarnessPrefabs
Scans vanilla Valheim and loaded prefab-adding mods for existing prefabs that are not normally available in the Hammer build table, then lets the server decide which ones become public build pieces and which ones stay admin-only.
It does not add new prefabs. It helps you harness the prefabs that are already there.
Dvergr barrel(enhanced lod) can be used as a fermenter. Fermenting time is configurable.
Trailership can be used by default. It would be available at plains. It is slightly slower(configurable) then longship but has bigger containersize.
Why Use It
- Open useful vanilla and modded prefabs without shipping another hard-coded prefab dump.
- Keep normal players on curated public build tabs while giving admins debug-only review tabs.
- Replace MoreVanillaBuildPrefabs-style public unlocks with YAML policy files you can review, copy, and override.
- Use MVBP-informed defaults for categories, requirements, placement flags, snap fixes, and icon behavior where those defaults are known.
- Keep the server as the source of truth through ServerSync, so clients receive the active prefab policy and localization text.
- Avoid Hammer clutter from runtime-only objects such as effects, projectiles, ragdolls, creatures, humanoids, and item drops.
What It Does
HarnessPrefabs builds a safe review workflow around hidden prefabs:
- Discover buildable-looking prefabs from Valheim and loaded mods.
- Ignore prefabs that are unsafe for Hammer placement, such as characters, item drops, spawners, runtime effects, projectiles, ragdolls, and similar controller objects.
- Seed defaults from reviewed MoreVanillaBuildPrefabs data when a prefab is known there.
- Classify the rest into public or admin categories based on components and prefab shape.
- Write reference YAML files for review.
- Apply only the overrides you choose to write.
- Sync the active policy from the server to clients.
This makes it useful both as a MoreVanillaBuildPrefabs replacement for curated public pieces and as an admin review tool for larger modpacks.
Hammer Tabs
Public tabs use existing Valheim categories where possible:
MiscCraftingBuildingBuildingStonecutterFurniture
Admin-only tabs are added only for admin clients while Valheim debugmode is enabled:
Harness NatureHarness StructuresHarness Props
The client-side Show Harness Tabs config can hide Harness admin tabs even while debugmode is on.
Default Classification
Known MVBP public pieces default to public access. Known MVBP admin-style nature and prop pieces default to Harness admin tabs.
General classification uses prefab components and names:
Harness Nature: plants, pickables, trees, logs, rocks, ore rocks, crops, and natural static prefabs.Harness Structures: walls, floors, arches, pillars, stairs, gates, doors, containers, portals, beds, crafting stations, fires, ships, carts, destructibles, and other build-like interactives.Harness Props: decor, static props, banners, rugs, tables, chairs, statues, treasure, CreatorShop-style props, clutter, fragments, and LOD-like objects.
Runtime objects are intentionally ignored. Prefabs named fx_*, vfx_*, or sfx_*, MVBP effect defaults, and prefabs with components such as TimedDestruction, Aoe, CamShaker, Projectile, or Ragdoll are not written to reference files and are not added to Hammer tabs.
Prefabs with ItemDrop, Humanoid, or Character anywhere in their hierarchy are ignored.
Policy Files
HarnessPrefabs stores policy files under:
BepInEx/config/HarnessPrefabs/
Editable override files:
prefabs.yml
prefabs_*.yml
Generated review files:
prefabs.reference.yml
prefabs.full.yml
prefabs.yml is created automatically. Extra files such as prefabs_public.yml or prefabs_admin.yml are loaded after the base file and can override the same prefab entries.
Do not edit prefabs.reference.yml or prefabs.full.yml directly. Copy entries from them into prefabs.yml or prefabs_*.yml.
Minimal Overrides
Override files use a top-level YAML list. You can copy only the fields you want to change:
- prefab: blackmarble_1x1
enabled: true
category: BuildingStonecutter
requirements:
- BlackMarble: 2
- prefab: GoblinTotem
enabled: false
enabled: true exposes a prefab. Public categories expose it to normal clients. Harness categories expose it only to admins in debugmode.
Missing fields keep the generated default.
Full Review Schema
Run this in the in-game console to write a full scaffold:
harnessprefabs:full
The full scaffold includes fields that are useful for review:
- prefab: barrell
enabled: true
category: Furniture
displayName: Barrel
description: ""
craftingStation: Workbench
requirements:
- FineWood: 2
- Iron: 1
flags: false, false, false, true # clipEverything, clipGround, allowedInDungeons, canBeRemoved
components: [Piece, WearNTear] # review metadata only
components is a reference hint from discovery and is ignored as an edit field.
Localization
Server-synced localization files live under:
BepInEx/config/HarnessPrefabs/localization/
English.yml is created automatically as a template. Add language files with Valheim language names such as Korean.yml, German.yml, or Turkish.yml.
Use localization tokens in prefab policy entries:
- prefab: barrell
enabled: true
category: Furniture
displayName: $ph_piece_barrell
description: $ph_piece_barrell_desc
$ph_piece_barrell: "Barrel"
$ph_piece_barrell_desc: "A decorative barrel."
English is applied first as fallback, then the client's selected language is layered over it.
Icons And Placement
HarnessPrefabs uses Jotunn RenderManager to generate missing Hammer icons. The render path follows the MVBP-style isometric snapshot setup and handles known special cases such as PickableItem random item previews.
For prefabs with awkward or sparse colliders, HarnessPrefabs applies placement-only ghost helpers based on reviewed MVBP defaults. These helpers affect Hammer preview placement without adding extra helper colliders to the final placed object.
Prefab Tweaks
The 2 - Prefab Tweaks config section contains optional synchronized tweaks:
Trailership VikingShip Speed Ratio: scales Trailership movement relative to VikingShip. Default is 0.66; accepted range is 0.5 to 1.0.Enable Bed Patches: off by default. Adds bed/spawn behavior to supported MVBP-style bed prefabs.Fermenter Patch Duration Percent: 0 disables the dvergrprops_barrel fermenter patch. 1 to 100 enables it and sets fermentation duration as a percentage of the vanilla fermenter.
Bed and fermenter tweaks are intentionally marked unsafe because disabling the mod later can affect placed-world state such as spawn points or fermenting contents.
Strengths
- Curated defaults with local control: MVBP knowledge is used as a starting point, but YAML remains the final policy.
- Admin review without player clutter: Harness tabs exist only for admins in debugmode and can be hidden client-side.
- Server-authoritative policy: active overrides and localization can be synchronized to clients.
- Modpack friendly discovery: prefabs are grouped by owner where possible, making large reference files easier to review.
- Safer Hammer scope: runtime effects, creatures, item drops, and spawner/controller objects stay outside the build table.
- Focused compatibility: Jotunn handles category integration and icon rendering instead of private UI hacks.
Suggested Workflow
- Start the server or single-player world with HarnessPrefabs installed.
- Let it generate
prefabs.reference.yml.
- Copy wanted entries into
prefabs.yml or a prefabs_*.yml file.
- Use public categories for normal-player pieces.
- Use Harness categories for admin-only review/build pieces.
- Run
harnessprefabs:full only when you need display names, descriptions, flags, or component metadata for deeper review.
Github
Original code from
https://github.com/searica/MoreVanillaBuildPrefabs
The mod's repo
https://github.com/sighsorry1029/HarnessPrefabs
