Changelog

1.0.0 — Full Release

Added

• Added Equips +, Hearthkeeper's optional dedicated Equipment and Extra-slot system.
• Added dedicated Head, Shoulders, Chest, Legs, Utility, Trinket, Main Hand, and Off Hand slots.
• Added a configurable 1–8 Extra slots, with 6 enabled by default when Equips + is active.
• Added independently rebindable Main Hand, Off Hand, and Extra-slot hotkeys.
• Added native-style HUD previews for dedicated hand and Extra-slot items.
• Added character-selection preview support for Hearthkeeper-equipped gear and weapons.
• Added dedicated-slot persistence across save/load, world changes, death, and tombstone recovery.
• Added native-path support for dedicated-item equipping, consumable use, ammunition, repair, and upgrades.
• Added dedicated-inventory carry weight, including compatible nested-container weight such as Adventure Backpacks.
• Added an Equips + startup safety notice with an in-popup option to stop showing future notices.
• Added Fuel Chest as a per-chest role for automatic-refueling supply.
• Added configurable Valheim-inspired chest-label colours.
• Added independent configurable Activity Glow colour and brightness.
• Added support for 1–8 fixed Extra-slot HUD positions.
• Added compact K/M display formatting for large inventory and hotbar stack counts.
• Added configuration migration support for the current MaddCatter365.Hearthkeeper plugin identity and renumbered configuration sections.
• Added consolidated developer diagnostics under Hearthkeeper's Diagnostics setting.

Changed

• Hearthkeeper now targets the current MaddCatter365.Hearthkeeper plugin identity.
• Equips + is disabled by default so existing players opt into the dedicated inventory deliberately.
• Extra slots are general-purpose storage, while Equipment cells enforce dedicated item-type rules.
• Dedicated equipment now uses Valheim's native equip behavior wherever possible instead of maintaining separate equipment state.
• Dedicated consumables, ammunition, weapons, shields, bows, torches, and tools use native Valheim behavior where supported.
• Dedicated equipment contributes to normal player carry weight.
• Chest-label lettering and receiving-chest glow now use separate colour controls.
• Automatic refueling now supports the Fuel Chest role independently of ordinary automatic-storage acceptance.
• Configuration sections were reorganized and migrated while preserving newer user-edited values.
• Diagnostic and developer logging was consolidated into the Squirrel diagnostic system and remains disabled by default.

Fixed

• Fixed dedicated Equipment panel cell mapping after the Valheim 1.0.17-era inventory work.
• Fixed invalid items entering Equipment cells through native occupied-cell swap behavior.
• Fixed dedicated Equipment and Extra-slot persistence through normal save and reload flows.
• Fixed dedicated equipment presentation after world-to-menu-to-world transitions.
• Fixed character-selection preview handling for dedicated equipment and hand-held items.
• Fixed native upgrade handling for items stored in Hearthkeeper's dedicated inventory.
• Fixed dedicated repair integration.
• Fixed dedicated ammunition selection and item-use routing.
• Fixed dedicated inventory carry-weight accounting.
• Fixed Fuel Chest interaction with crafting, Restock, feeding, consolidation, and automatic storage.
• Fixed Equipment-slot interaction so invalid item types are rejected consistently.
• Fixed several development-only informational messages so they appear only when Diagnostics is enabled.

Compatibility

• Validated against Valheim 1.0.20 during final 1.0.0 regression testing.
• Tested Hearthkeeper multiplayer ownership and storage behavior.
• Tested Adventure Backpacks 2.4.0, including equipped backpack behavior and nested carried weight.
• Tested AreaPickup 1.0.1 alongside Hearthkeeper storage, livestock feeding, and processing-device behavior.
• Retained native Valheim behavior for equipment, crafting, repair, upgrades, item use, ammunition, containers, fires, and processing devices wherever practical.

Safety

• Equips + warns players to manually empty Hearthkeeper's dedicated inventory before disabling the feature or removing the mod.
• Items left in the dedicated inventory are retained rather than intentionally deleted when Equips + is disabled.
• Equipment cells now reject invalid reverse swaps before Valheim can move the displaced item into the dedicated slot.
• Existing configuration and persistent-data migration paths preserve newer user values and legacy fallback data where appropriate.

0.5.0 — Phase 1 Complete

Added

• Native Valheim-style inventory and chest controls with compact action buttons and tooltips.
• Store Matching, Store All, Sort Inventory, Sort This Chest, and Consolidate Chests.
• Per-chest Reserve, Crafting / Restock Supply, automatic-storage, and Livestock Feed rules.
• Personal Restock with remembered slots and automatic refill support.
• Equipment and Quick Slots compatibility support.
• Chest naming with front/lid surface labels.
• Receiving-chest glow.
• Configurable stack sizes with compact K/M count display.
• Configurable chest sizing with horizontal and vertical scrolling.
• Automatic refueling for supported fires, torches, and processing devices.

Changed

• Consolidation now prioritizes the chest already holding the greatest quantity of each item.
• Restock defaults to refilling marked stacks whenever they are not full.
• Diagnostics and configuration layout were simplified.
• Chest UI layout, scrolling, labels, and button placement were refined.
• Stack-size configuration moved out of the experimental section.

Fixed

• Ghost zero-count stack issues seen during earlier development.
• Feed chests interfering with consolidation and ground-storage behavior.
• Restock behavior around inventory closing and eligible supply chests.
• Chest-rule flyout persistence after closing containers.
• Tooltip initialization failures caused by unsupported texture hit-testing.
• Wide and tall chest scrolling reliability.
• Chest-label placement, occlusion, and lid behavior.
• Compatibility protections for Equipment and Quick Slots inventory cells.

Notes

• This release marks the completion of Hearthkeeper Phase 1.
• Phase 2 is planned as the next major development milestone.

0.1.14 Part1-LabelSurfaces-Fix1 (2026-09-29)

• Corrects the wooden chest front reference independently of text rotation.
• Uses actual readable mesh surfaces, or oriented mesh bounds for protected meshes, instead of interaction colliders for label placement.
• Attaches lid text to the selected surface transform with an independent upward-facing reading frame.
• Preserves font, glow, size settings, occlusion, NativeAttached and all gameplay.
• Adds internal calibration notes and one diagnostic per prefab; in-game placement still needs testing.

0.1.14 Part1-CompactButtons-Polish2-TooltipFix1 (2026-09-28)

• Removes the alpha-hit-test assignment rejected by native compressed/unreadable textures.
• Contains tooltip initialization/text errors while preserving button interaction.
• Preserves Polish2 visuals, layout, wording, FloatingLegacy and all gameplay services.
• Debug rebuild, 20 compiled wiring checks and 6 fault-injection checks pass; live test pending.

0.1.14 Part1-CompactButtons-Polish2 (2026-09-28)

• Separates the two player buttons around the vanilla display without changing size or anchoring.
• Warms custom chest-icon foreground to #E89928; preserves artwork and frames.
• Standardizes all seven native mouse-hover bindings and approved short labels.
• Debug rebuild and 17 compiled UI wiring checks pass; in-game validation remains pending.

0.1.14 Part1-Backbone3-ButtonVisuals-Test2 (2026-09-28)

• Five approved chest-side gold line icons, replacing the copied repair foreground.
• Native ash background/states and validated Text-body tooltips with approved wording.
• Preserves column/flyout layout, player-side buttons and all gameplay services.
• Debug rebuild passed; native hover/click behavior still requires in-game verification.

0.1.14 Part1-Backbone3-CompactButtons-Test1 (2026-09-28)

• Compact square native repair-style main action buttons with icons and shortcut tooltips.
• Chest column stays inside the panel at its inner-right edge; old oversized backing and reserved width are removed.
• Sort This Chest moves to the main column, retaining its operation; remaining flyout controls are unchanged.
• Debug rebuild, matching PDB and source checkpoint. Core inventory/storage behavior remains unchanged from Fix1. See COMPACT_BUTTONS_TEST1_NOTES.md.

0.1.14 Part1-Backbone3-Fix1 (2026-09-28)

• Registers the missing inventory reservation/transaction patch class and disambiguates Inventory.Load hooks.
• Uses inspected EAQS 3.1.3 placement predicates to refill accepted special cells without bypassing restrictions; preserves storage-removal protection.
• Retires departed R identities so chest/world returns do not drag personal homes to unrelated cells.
• Corrects TMP initialization overriding sizing, single-line physical sizing, inherited model scale and inactive-mesh bounds.
• Moves per-prefab label geometry to internal constants; retains visibility/colour/modest size/range as public controls and cleans retired config keys.
• Preserves native font, pale-blue glow, occlusion, Feed, Preserve-X, naming and scrolling. 123 logic, 12 config and 19 artifact checks pass. Live visual/compatibility/multiplayer tests remain pending.

0.1.14 Part1-Backbone3 (2026-09-28)

• Moves L protection to persistent item identities and R to one maintained item plus a reserved empty home; migrates older marks.
• Makes L/R mutually exclusive; moves R to top-center; adds native placement/move/swap/load guards.
• Feed forces Crafting / Restock Supply OFF and leaves it OFF after Feed is disabled; preserves Backbone2 ground pickup behavior.
• Hardens timed Feed exclusions at candidate, transfer and arrangement boundaries; adds automatic transfer/eligibility and optional animal-feed diagnostics.
• Migrates Sorting config to Consolidation without discarding persisted values; adds 1.5-second manual cooldown.
• Uses the valid native TMP font for inactive-created world text, surface placement, lid parenting, per-prefab profiles, pale blue glow, throttled occlusion and angle/distance fade.
• Preserves shared Preserve-X, naming input, viewport and EQS integration. 114 logic checks and 9 real BepInEx migration checks pass. In-game visual/Harmony testing and real host/guest validation remain pending.

0.1.14 Part1-Backbone2 (2026-09-27)

• Defaults Restock threshold to 100%, keeping one managed stack per marked slot and multi-chest aggregation.
• Queues UI-blocked due scans for immediate refill on close and restarts the personal timer.
• Renames the existing withdrawal permission Crafting / Restock Supply.
• Removes the independent ground-pickup button; Feed OFF restores normal pickup and Feed ON blocks it locally.
• Adds hard host checks to the timed warehouse scheduler and execution entry point only.
• Adds per-slot Restock diagnostics and clones native TMP text for markers to avoid missing-default-font warnings.
• Retains Preserve-X semantics; 81 deterministic checks pass. In-game validation remains pending.

0.1.14 Part1-Backbone1 (recovery checkpoint, 2026-09-27)

• Adds the complete Part 1 module structure on top of stabilization.3.
• Rebinds scroll callbacks across changing chest sizes and adds fixed native chest actions.
• Adds explicit naming submit/cancel handling and chest-attached front/lid inscriptions.
• Adds persistent Alt-click slot locks, Restock marks, a shared protection helper and inventory adapter API.
• Adds manual/optional automatic one-stack-per-marked-slot Restock using existing eligibility/reserve rules.
• Adds per-chest ground pickup rules; Feed forces pickup off on that chest.
• Packaged immediately on first successful full-project compile. Runtime validation and visual tuning remain pending; no Part 2 work included.

0.1.14 stabilization.3 (intermediate test, 2026-09-26)

• Gives wide chest grids a native-style horizontal scrollbar and correct full content width.
• Anchors slots from the top-left instead of centering an oversized grid into a clipped viewport.
• Reserves separate scrollbar gutters and reaches the last row and column through bounded scrolling.
• Uses the actual masked viewport for gamepad selection visibility on both axes.
• Restores original UI transforms when Hearthkeeper is disabled or unloaded.
• Retains the existing chest panel footprint and all stabilization.2 storage behavior.
• Adds nine deterministic viewport checks; 56 total pass. Live Unity visual/input validation remains pending.

0.1.14 stabilization.2 (intermediate test, 2026-09-26)

• Replaces distance-first consolidation with per-item, highest-starting-quantity-first routing.
• Fills matching accepting chests consecutively in rank order; distance breaks equal-count ties.
• Keeps Preserve-X stock in its source chest, retaining its matching-item identity.
• Allows mixed-item chests to receive one item and donate another; revisits item groups when transfers free additional slots.
• Applies the same ranking to timed Auto-Sort, retaining its Feed-chest exclusions.
• Carries forward all stabilization.1 fixes. Chest viewport resizing and pickup-radius mod compatibility are still pending.

0.1.14 stabilization.1 (intermediate test, 2026-09-26)

• Includes the local open chest in manual Consolidate while keeping other players' open chests excluded.
• Excludes Feed chests only from timed Auto-Sort consolidation and arrangement.
• Uses native amount-and-cell transfers with actual moved-count accounting; avoids copy-first partial-transfer duplication.
• Enforces Preserve-X in shared withdrawal helpers and avoids automatic placement into empty external equipment cells.
• Fixes the cached text-input visibility race and protects rename confirmation/cancellation frames.
• Adds manual Consolidate diagnostics and a distinct startup build label.
• Retains the HUD layout; new HUD, locks, equipment, restock, search, and label polish remain later milestones.

0.1.14 Test Build

• Restores the functional Chest Rules button beside the chest so the flyout can be opened and closed.
• Removes the nonfunctional button-shaped Chest Rules heading from inside the flyout and closes the resulting empty space.
• Moves Store Matching and Sort Inventory into a vertical group to the right of the player inventory so the chest window cannot cover them.
• Prevents Valheim's inventory-close routine from responding to E or I while the chest-name prompt is active.

0.1.13 Test Build

• Removes zero-quantity item records after protected or automatic chest removals and cleans up existing zero stacks encountered by those paths.
• Removes the redundant Chest Rules toggle button; the attached rules panel now opens with the chest interface.
• Blocks normal player controls while the chest-name text prompt is active.

0.1.12 Test Build

• Fixed nearby crafting and building access so the locally opened eligible chest can be counted and consumed from.
• Fixed AutoFeed so food is delivered through the creature's consumption callback instead of spawning a loose item that the player could pick up.
• Fixed Reserve-protected amount transfers so a fully reserved stack cancels the transfer instead of allowing a zero-quantity move transaction.
• Restored the internal plugin and assembly version to match the build version.
• Replaced the package license with the MaddCatter365 Noncommercial Mod License.

0.1.11

• Added readable Nordic-styled lettering for custom chest names displayed on closed chests.
• Added a warm cream label color with a dark offset outline for improved readability.
• Retained the front-face label placement and configurable display range.
• Removed the incompatible material-emission glow call for improved Valheim-version compatibility; the receiving-chest point light remains available.

0.1.7

• Added configurable automatic refueling for standard fires, hearths, and torches.
• Added separate automatic fuel and input-material loading for standard processing devices.
• Added configurable supply range, cycle interval, device budget, per-device transfer limit, refill thresholds, and target levels.
• Added F9 to exclude or re-include the supported device under the crosshair.
• Restricted automatic refueling to player-built, accessible, network-owned devices and eligible standard containers.
• Made all automatic fuel and input withdrawals respect chest reserves.

0.1.6

• Made Store Matching process the local player's open matching chest directly before searching closed warehouse chests.
• Continued excluding containers opened by other players.

0.1.5

• Added an optional timed automatic sorting cycle with configurable minutes.
• Automatic cycles consolidate matching stock and arrange eligible chests.
• Automatic sorting waits while inventory or chest interfaces are open.

0.1.4

• Added optional Equipment and Quick Slots 3.1.2 integration through its public runtime API.
• Protected equipment, quick, and custom slots during Store Matching, Store All, and Sort Inventory.
• Kept Equipment and Quick Slots a soft dependency rather than a requirement.

0.1.3

• Added Store All for the currently open chest while protecting hotbar and equipped gear.
• Allowed the Store Matching hotkey during ordinary gameplay with inventory closed.
• Suppressed hotkeys while typing, using menus or console, teleporting, dead, or in a cutscene.
• Made personal sorting preserve equipped items and added Store All to chest glow feedback.

0.1.2

• Added Valheim-styled attached controls and a compact Chest Rules panel.
• Renamed Sort Warehouse to Consolidate Chests.
• Added configurable receiving-chest glow and retained movable legacy panels as a fallback.

0.1.1

• Added safe configurable chest dimensions with a 7x4 minimum default and larger vanilla tiers.
• Added prefab-specific sizes and persistent growth-only protection against silent shrinking.
• Added draggable fallback panels with saved positions.

0.1.0

• Initial private test build for Valheim 1.0.12.
• Added matching ground and player storage, crafting/building access, sorting, reserves, manual locks, livestock feeding, configurable ranges, standard-container discovery, and optional stack resizing.