Valheim
You are viewing a potentially older version of this package. View Latest Version
Install with App

Details

Date Uploaded
4 days ago
Downloads
13
Size
6KB
ADDatHost Valheim hosting
€1

BeastheimDvergrCompat

A one-trick prefab-name adapter. Registers dvergr_fermenter_tq as an alias for Tequila-Dvergr_Pieces' current teq_dv_ferm_fermenter, so recovered NewBeginings PlanBuild blueprints that still reference the old name resolve correctly. Nothing else.

Why this exists

The NewBeginings archaeological recovery extracted 11 historical player-built structures. Three of them (Grok, Sven, Vlad) place a piece originally registered by Tequila-Dvergr_Pieces 2.3.0 (the 2023-era version that built the historical world) under the name dvergr_fermenter_tq.

The current, 1.0.16-compatible release of that mod is 2.9.0. Decompiling both versions side by side showed every other piece kept its exact registered name across that gap — only the fermenter changed: the author moved it into its own dedicated asset bundle and renamed it to teq_dv_ferm_fermenter, sometime around the Bog Witch update. This is a mod-author content rename between versions, not a Valheim engine API break, so it's out of scope for this project's compatibility/LegacyCompat engine (which only migrates breaks against the game assembly, not one mod's own internal renames). Full investigation trail: docs/compatibility/DVERGR_FERMENTER_AND_UNKNOWN_PREFAB_INVESTIGATION.md in the main repo.

What it does (exactly, and only, this)

Legacy prefab ID (historical 2.3.0) Current prefab ID (2.9.0, what it's aliased to)
dvergr_fermenter_tq teq_dv_ferm_fermenter

On startup (once vanilla prefabs are available), it calls Jötunn's PrefabManager.CreateClonedPrefab("dvergr_fermenter_tq", "teq_dv_ferm_fermenter"). That clone is a fully real, hash-registered ZNetScene prefab (mesh, collider, ZNetView, inventory/fermenting logic — everything, inherited unmodified from the current piece) — but it is never added to any PieceTable, so it never appears in the Hammer build menu and is not player-craftable under the old name. The only thing it's for is letting PrefabManager.GetPrefab("dvergr_fermenter_tq") — the exact lookup PlanBuild's own blueprint-placement code performs — succeed instead of logging "No prefab found."

Explicitly out of scope

This mod does not, and should not, grow beyond the one mapping above. If another Dvergr_Pieces legacy-name mismatch ever surfaces, add one line to the Aliases array in Plugin.cs — same mechanism, same dependency already declared — rather than expanding this package's purpose. It is not a general prefab-aliasing framework, not a Dvergr_Pieces patch, and not a replacement for anything in compatibility/LegacyCompat.

Dependencies

  • BepInExPack for Valheim
  • Jötunn, the Valheim Library
  • Tequila-Dvergr_Pieces 2.9.0 (hard dependency — this mod does nothing without it, and BepInEx will correctly refuse to load if it's missing)
DatHost — Valheim server hosting, first month for one euro
DatHost — Valheim server hosting, first month for one euro
DatHost — Valheim server hosting, first month for one euro
DatHost — Valheim server hosting, first month for one euro
DatHost — Valheim server hosting, first month for one euro