AzuCraftyBoxes Fixes & Config 1.3.0

• Separately toggle nearby-chest use for building, crafting, and machines.
• Gives every player independent settings and configurable hotkeys; admin status is not required.
• Fixes crafts that start but fail to finish after nearby-resource state changes.
• Makes Build Camera free-cam placement consume the correct nearby materials exactly once.
• Applies Configuration Manager and config-file changes live.

This is the renamed and expanded continuation of AzuCraftyBoxesBuildingOnly. The Thunderstore package ID, DLL, plug-in GUID, and config filename intentionally remain unchanged so 1.3.0 updates the existing package and preserves player settings.

Per-player feature switches

The switches are independent, local to each player, and usable by non-admins. Two players beside the same chest can keep different choices.

AzuCraftyBoxes still controls range, eligible containers, YAML exclusions, permissions, its own enabled state, and its per-player Prevent Pulling Logic option. This add-on never approves a pull that AzuCraftyBoxes rejected.

Live changes and hotkeys

Configuration Manager changes take effect on the next relevant action. Saving the generated config file while the game is running also reloads the local values.

Every shortcut is configurable. Set a shortcut to None to disable that hotkey.

Craft-completion fix

AzuCraftyBoxes can defer one crafting ingredient until the craft completes. If the nearby-resource choice changes or a craft is cancelled at the wrong point, its global pending state can become stale and the crafting timer may finish without completing the item.

Version 1.3.0 treats each craft as one transaction:

• Captures that player's crafting toggle when the craft actually starts.
• Keeps the same choice through requirement checks, ingredient withdrawal, and completion.
• Clears stale pending-consumption state before a new craft and after completion, cancellation, or closing the crafting panel.
• Resets AzuCraftyBoxes' temporary recipe-scan guard even if another patch throws an exception.

This targets the stuck-started-craft path without changing recipes or crafting speed.

Build Camera material-consumption fix

Version 1.3.0 marks the exact successful placement transaction used by Valheim and Build Camera Custom Hammers Edition. It snapshots the required amounts before AzuCraftyBoxes runs and audits the amounts afterward.

• If the normal path consumed everything, the fix does nothing.
• If Build Camera/AzuCraftyBoxes missed part of the withdrawal, only the missing remainder is removed.
• It uses the player's inventory first and then only AzuCraftyBoxes-approved nearby containers.
• It respects container access, exclusions, range, and AzuCraftyBoxes' Leave One rule.
• It cannot intentionally charge more than one recipe.

Build Camera is optional and is not declared as a dependency.

Inventory items appearing again

This plug-in does not call Inventory.AddItem and does not move items into a player inventory. No safe AzuCraftyBoxes fix was added for that separate symptom.

The likely cause is an inventory expansion mod exposing or moving items from hidden/special slots or rows while you empty the visible inventory. If it happens again:

1. Record which item returned and what action caused it.
2. Save the client BepInEx log and current mod list.
3. Check every equipment, quick, food, ammo, and extra slot supplied by the inventory mod.
4. Do not launch the character without its inventory mod until all special slots are emptied into normal chests.

Those details are needed before patching because guessing at an inventory transfer could duplicate or destroy items.

Multiplayer installation

Install the same version on:

• The dedicated server or host
• Every connecting client

ServerSync requires the plug-in and a compatible version but synchronizes no gameplay toggle or hotkey. Each client controls only its local player's three features. The dedicated server has no local player, so its local toggle values are inert.

Compatibility

Do not install this together with ValheimCompatibilityFixes; both contain the same AzuCraftyBoxes gate. It can be installed with the separate BreedingUpgradesChickenEggFix.

Checked against:

• BepInExPack Valheim 5.4.2333
• AzuCraftyBoxes 1.8.15
• Valheim 0.221.4 API
• Build Camera Custom Hammers Edition 1.2.10 (optional)

The package was compiled and statically validated against those versions. A live copied-world test is still required before using it on a main server.

Update from 1.2.0

1. Remove or disable version 1.2.0 on the server and every client.
2. Install AzuCraftyBoxesBuildingOnly-1.3.0.zip everywhere.
3. Do not keep both DLL versions.
4. Existing 1.2.0 config values and hotkeys are preserved.

For a manual installation, place AzuCraftyBoxesBuildingOnly.dll in BepInEx/plugins/AzuCraftyBoxesBuildingOnly/.

Config

Generated at:

BepInEx/config/local.valheim.azucraftyboxesbuildingonly.cfg

See CONFIG_REFERENCE.md for the full behavior and migration reference.

Required copied-profile test

1. Craft an item using only nearby-chest materials and confirm the timer finishes and creates exactly one item.
2. Cancel a one-ingredient craft, then craft another item and confirm both inventory and chest amounts are correct.
3. Toggle crafting through Configuration Manager during separate crafts and confirm no craft becomes stuck.
4. Place the same piece normally and through Build Camera free-cam; each must consume exactly one recipe.
5. Repeat with two non-admin players beside the same chest using opposite settings.
6. Check client and server BepInEx logs for Harmony or AzuCraftyBoxes Fixes & Config errors.

Uninstall

Remove this package from the server and every client, then restart. AzuCraftyBoxes returns to its normal behavior. The add-on stores no world objects or item data.

Complete source is included under src/ and released under the MIT License.

Changelog

1.3.1

• Correct the AzuCraftyBoxes 1.8.15 crafting-state type lookup from AzuCraftyBoxes.ConsumptionManager to AzuCraftyBoxes.Util.Functions.ConsumptionManager.
• Restore the intended stale deferred-consumption cleanup for one-ingredient crafts.
• Make the pending-consumption property a required runtime member so future incompatibilities disable the add-on safely instead of silently skipping the advertised crafting fix.
• Remove the resulting HarmonyX AccessTools.TypeByName warning during startup.

1.3.0

• Rename the visible plug-in and README title to AzuCraftyBoxes Fixes & Config while retaining the existing Thunderstore package ID, plug-in GUID, DLL name, and config filename for a clean update.
• Treat each started craft as one transaction and preserve its crafting-toggle choice until completion.
• Clear stale AzuCraftyBoxes deferred one-ingredient consumption state before and after crafting, cancellation, or closing the crafting panel.
• Guarantee cleanup of AzuCraftyBoxes' temporary recipe-scan guard after errors.
• Mark the exact successful placement transaction used by normal building and Build Camera Custom Hammers Edition.
• Audit building-resource consumption after AzuCraftyBoxes runs and remove only a missing remainder from the player or eligible nearby containers.
• Respect AzuCraftyBoxes container access, range, exclusions, pull rules, and Leave One behavior in the placement fallback.
• Document that this plug-in never inserts items into player inventories; unexplained returning items need an inventory-mod/log diagnosis rather than a speculative transfer patch.

1.2.0

• Replace the one shared server-controlled mode with independent per-player building, crafting, and machine switches.
• Make every gameplay switch available to non-admin players and intentionally exclude it from ServerSync.
• Add configurable local F8, F9, and F10 hotkeys; any shortcut can be rebound or set to None.
• Apply Configuration Manager changes immediately and reload local config-file edits while the game is running.
• Keep required-mod/version enforcement on the server without synchronizing player preferences.
• Fix chest-funded Build Camera placement by keeping the building context active through Player.UpdatePlacement, where Valheim actually consumes resources.
• Cover TryPlacePiece, every current PlacePiece overload, and the full machine interaction/hover paths used by AzuCraftyBoxes 1.8.15.
• Migrate legacy Full, BuildingOnly, and Disabled values to the equivalent three local switches and remove obsolete lock/mode entries.
• Add a two-client same-zone test matrix and updated source/build documentation.

1.1.0

• Require the package on the dedicated server and every client through version checking.
• Synchronize Lock Configuration, Mod Enabled, and Mode from the server.
• Keep the F8 key assignment local while making authorized mode changes global.
• Block non-admin clients from overriding a locked server mode.
• Live-reload and broadcast dedicated-server config-file changes.
• Fail closed if AzuCraftyBoxes' bundled ServerSync cannot be initialized.
• Correct the multiplayer installation and configuration documentation.

1.0.0

• Add Full, BuildingOnly, and Disabled modes for AzuCraftyBoxes.
• Default to nearby-container use for structure placement only.
• Add an F8 runtime switch between Full and BuildingOnly.
• Preserve AzuCraftyBoxes container maintenance and its own enable/permission decisions.
• Add compatibility notes and a copied-profile test checklist.
• Include complete Thunderstore listing, configuration and source-build references plus high-resolution icon masters.