SmeagsMods-HearthHarvest icon

HearthHarvest

A shared Valheim kitchen and garden request board with recipes, progress and optional read-only nearby storage snapshots.

Last updated 2 days ago
Total downloads 41
Total rating 0 
Categories Building AI Generated
Dependency string SmeagsMods-HearthHarvest-0.1.7
Dependants 0 other packages depend on this package

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2351 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.

Preferred version: 5.4.2351

README

Hearth & Harvest

A shared kitchen and garden request board for your Valheim village.

Version 0.1.7

Includes a scene-teardown registration fix: shared hammer build tables no longer retain destroyed board prefab references across logout/rejoin. Restart Valheim completely after updating. This prevents this source of recipe/inventory exceptions; it does not repair previously damaged inventories or restore lost items. Ready for user acceptance testing. Includes a redesigned wood-and-parchment panel with an engraved title plaque. Request details and ingredient stock are split into tabs to keep the form readable. Physical Meal Requests/Garden Requests headings and single-line shortage rows remain. Actual group multiplayer is still unverified.

Install in a disposable world first. Actual group multiplayer, gamepad controls and arbitrary third-party lock implementations remain unverified. Nothing has been published automatically.

Features

  • Build Hearth & Harvest Board with your hammer: 20 Wood, 5 Fine Wood, 2 Resin. Uses the native sign's station and placement behavior.
  • Press Use on the board to open it. Up to 24 kitchen and garden requests per board.
  • Search loaded food, uncooked-food and mead-base recipes. Choose a target output quantity; ingredient counts round up to whole recipe batches.
  • Manual garden requests, progress, Done flags, notes and ingredient checkboxes. Changing target quantity clears ingredient checks and Done so a larger order cannot look completed accidentally.
  • Save changes commits to the shared board. Reload, Close, Escape or leaving interaction range discards unsaved edits. Save conflicts reload the current board rather than silently overwriting another player's work.
  • Optional read-only stock tracking automatically refreshes the nearest accessible board while you are in interaction range, at most once every 10 seconds. Refresh nearby supplies also refreshes explicitly. Each snapshot reads accessible loaded placed containers within 15m, up to 128, and shows ingredient counts. It never takes, moves, reserves, deletes or crafts anything. Busy containers and CofferForge soft/hard locks are excluded. Vanilla privacy and ward access are respected.

Installation

Requires BepInExPack Valheim. Install on all clients and the server. Place the included HearthHarvest folder under BepInEx/plugins, or import this ZIP through your mod manager. Everyone must use the same version. Board data is stored in the board's world ZDO, not in a cloud service.

Boundaries

  • Requests and checkboxes are manual. Harvesting and cooking do not automatically advance them.
  • Recipes are the installed game's direct recipe definitions. It does not recursively calculate flour, oven conversions, fermentation, ingredient alternatives or quality upgrades. One-of-many-ingredient recipes are excluded. Unknown/removed recipes keep their request and note, without fabricated ingredient counts.
  • Nearby counts are a local loaded snapshot, not a server-wide inventory, not reservations and not a guarantee against concurrent changes. The physical board shows snapshot age and marks it stale after 15 seconds. Auto-refresh stops outside interaction range; use the button for an immediate refresh after chest changes. Unsupported third-party lock implementations may need an adapter; disable the snapshot if using another private-storage system. It is off via EnableReadOnlySnapshot config if needed.
  • The rustic wall board has wood framing, bent iron nails, pinned parchment and native spice-rack herb bundles tied to frame pegs on both edges. The large-print charcoal summary shows the next two saved meals, one garden request, progress, a short note and the two largest outstanding ingredient shortages as Item x Quantity (the quantity missing), with +N more for additional entries. Requirements aggregate remaining meal quantities across the board. Unknown stock shows needed totals, never fabricated missing counts. Old snapshots are labeled LAST SHORTAGES and STALE. Open the panel for full requests and ingredient details. Unsaved panel edits do not appear on the physical board. Requests are shared; stock snapshots are local to each viewer and only include storage they can access. Paper text is hidden beyond 12m and private-board details are hidden from unauthorized viewers.
  • Removing the board removes its requests with it. Back up your world before removing the mod. Do not load a valued world without mods defining its placed pieces.
  • Typical vanilla ward permissions govern viewing/editing. Anyone who can access the board may edit it. No per-request ownership or admin roles in this version.

Panel layout

Choose a request on the left. Use Request details for quantity, progress and notes, or Ingredients & stock for recipe requirements, ingredient checkboxes and nearby supply counts. Garden requests keep their detail form without an irrelevant ingredient tab. Save changes commits both tabs together; switching tabs does not save or discard edits.

Controls

Use: open. Escape/X: close without saving. Save changes: commit all local edits. Reload: discard local edits and load current state.

Suggested first test

In a backed-up disposable world, build the board, add a meal request and garden request, then save. Confirm the wall papers update. Put an ingredient in an unlocked nearby chest, stand in reach and allow 10 seconds for the stock count to refresh. Walk away to check the stale label. With two distinct clients, test shared saves and a simultaneous edit before using it for your main community orders.

Credits

SmeagsMods. Original procedural frame and parchment geometry with generated artwork based on the approved concept. Package cover is illustrative; the in-game icon depicts the actual model. Native spice-rack herb meshes, sign geometry, fonts, item sprites and materials are referenced at runtime from the user's installed game, not redistributed as asset files.