ValheimCraftingCompatibility
Compatibility for VikingCrafting 0.0.5 and WorkshopWorker 1.0.5. Prevents overlapping crafting handlers and separates their chest buttons while keeping WorkshopWorker automation.
About this mod Author’s original text
ValheimCraftingCompatibility
Version 1.0.0 — an independent compatibility plugin for VikingCraftingAndQuickDeposit
0.0.5 and WorkshopWorker 1.0.5.
This plugin addresses overlapping crafting and manual storage-input hooks. With
the supported original author DLLs loaded, VikingCrafting handles recipe costs
and manual fuel/ingredient pulls, while WorkshopWorker retains its interface,
automation, hotbar and unrelated hooks. Neither author's DLL or configuration
is rewritten. With either mod absent, the plugin makes no changes.
Install with r2modman
- Close Valheim and open the Valheim profile you use in r2modman.
- Ensure BepInEx and the original VikingCraftingAndQuickDeposit 0.0.5 and
WorkshopWorker 1.0.5 builds are installed. Restore earlier patched author
DLLs using the originals in the separate restoration/source package.
- If you previously copied the compatibility DLL manually, move that copy out
of the profile's BepInEx/plugins/ValheimCraftingCompatibility folder.
Keep only one loaded copy of each plugin; store backup DLLs outside plugins.
- In r2modman 3.2 and newer, open profile management using your profile name at
the bottom left and choose Import local mod. On older versions, look under
Settings > Profile > Import local mod.
- Select LocalPatch-ValheimCraftingCompatibility-1.0.0.zip without extracting
it. Complete the import and check the Installed/Local mod list for
ValheimCraftingCompatibility.
- Launch using r2modman's modded launch option. Check
BepInEx/LogOutput.log for both WorkshopWorker's normal loaded message and
COMPAT ACTIVE.
The LocalPatch author field identifies this local package separately from the
two author mods. r2modman manages its own installation folder, usually
BepInEx/plugins/LocalPatch-ValheimCraftingCompatibility. Let the manager keep
that folder name; the plugin does not require a particular folder name.
This ZIP contains only the compatibility DLL, package metadata, documentation,
source and fixture tests. It does not include the original author DLLs. Install
the required mods separately; do not rely on local import to fetch dependencies.
Keep the earlier restoration package for its original DLLs and migration guide.
Check the result
| Log status | Meaning |
| --- | --- |
| COMPAT ACTIVE | The guards passed and overlapping WorkshopWorker hooks were removed. Test gameplay below. |
| COMPAT STANDBY | One author mod is absent; no compatibility changes were made. |
| COMPAT NOT APPLIED | A compatibility check or patch operation failed. Read the logged reason. Disable WorkshopWorker's [Crafting] Enabled setting or disable one mod before crafting with both. |
The failure warning does not disable either author's crafting automatically.
Versions and SHA-256 hashes must match supported-builds.json.
An unknown build is rejected even if its version number is unchanged.
Verify that WorkshopWorker's normal controls appear, linked automation still
works, and one craft produces the expected item for exactly one recipe cost.
Repeat with carried, chest-only and split ingredients, upgrades and multiple
crafts. Check cancellation, exact-stock and insufficient-stock cases, plus
manual machine inputs. An invalid-type AddComponent warning or missing
WorkshopWorker interface means the author mod may not have initialized.
Verification and updates
Mono/HarmonyX fixture tests passed; expected signatures were checked against
the supplied original WorkshopWorker DLL. This separate plugin has not yet
been verified in Valheim or Unity. The recorded test results are in
verification/runtime-verification.json.
Updates to the author mods cannot overwrite this separate plugin. New builds
still require review and testing; see source/UPDATING.md.
Game, BepInEx and other-mod updates also require repeating the checks. Do not
bypass the guards by changing a hash without inspecting the new build.
A local import adds the patch to your own profile. Public Online-list visibility
requires publishing a package
Install & use Install: BepInEx plugin
- The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
- Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
- Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
- Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.
Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file. In multiplayer, the host and every client need the same mods installed.
Install these first, or the mod will not work: