Kindle

Recipe search and sorting, favorites, batch crafting, a recipe tracker, salvage and an optional Cart Workbench.

Version 0.1.23. Requires Crucible 0.3.26 / Crucible.UI 0.3.19. Changes are in CHANGELOG.md.

Features

• Recipe search (accent-insensitive), category buttons (Ammo, Weapons, Bows, Armor, Shields, Tools, Food, Materials), sorting, per-character favorite recipes and a list or grid view, with keyboard and gamepad actions.
• Batch crafting: pick an amount; Kindle checks materials and inventory space, and keeps the amount while it crafts.
• Recipe tracker: track recipes per character and see material and station readiness and a craft countdown in a fixed HUD.
• Salvage tab: break items back into materials by the salvage rules (a share of the recipe), with inventory checks. With Inscribe installed, salvage shows Inscribe names, inscription details and rarity backgrounds, inscribed Magic and Rare items can be salvaged and may give a rune back (chance shown); Epic Loot rarity colors are shown when Epic Loot is installed. With Burrow installed, the tab also lists gear in nearby chests and marks each row "From a chest". It uses the chests Reach crafting may use: the same range, wards, privacy, allow and deny lists, and the per-player Reach toggle. Chests another player has open, and chests held by another transfer, are skipped. Favorites, equipped items and the other salvage rules still refuse a chest item. The hotbar rule applies only to your own inventory. Materials go into your inventory, and what does not fit drops at your feet. A chest item that moved is not salvaged. Without Burrow, the tab lists only your inventory.
• Repair On Station Open (off by default): opening a usable station runs the existing free repair-all action for its eligible carried gear.
• Cart Workbench (cheat, off by default): use a cart as a crafting station.
• Salvage rules are in Kindle.Salvage*.yml files that you can edit, or edit in Almanac's data pages.

Requirements

• BepInExPack Valheim 5.4.2351
• Jotunn 2.30.2
• Crucible 0.3.26 or a later 0.3.x, which includes Crucible.UI 0.3.19 (the shared Meadworks interface kit)

Installation

• Mod manager (recommended): install Kindle with r2modman, Gale or the Thunderstore Mod Manager; the dependencies above are installed for you.
• Manual: install BepInExPack Valheim, then Jotunn and Crucible, then copy the plugins/Kindle folder from this package into BepInEx/plugins/.
• Install it on your own game; the server and other players do not need it (see Multiplayer).

Configuration

• Settings file: BepInEx/config/com.meadworks.kindle.cfg, under Recipe List, Batch Crafting, Repair, Recipe Tracker, Salvage, Cart Workbench and Server. Edit it in game with Almanac (the Meadworks settings book) or any ConfigurationManager.
• Salvage / Nearby Chests is on by default. On a server the host's value applies. In single player your own value applies. Turning it off lists only your inventory.
• Personal settings are your own. When the server runs Kindle, its values win for server-synced settings, and it can lock personal settings with Server / Locked Player Settings; locked settings show as read-only.
• Cheats: Craft Speed (1, normal speed, by default), Instant Crafting (off by default; every craft and batch finishes at once) and Cart Workbench (off by default). In multiplayer they stay locked unless the server allows them; on a server without Kindle they read 1 and off.
• Converter: imports your OpenKeep crafting settings after a preview, with a backup first.

Multiplayer

• Client-optional: install it on your own game; the server and other players do not need it. If the server also runs it, versions are checked and the server can lock individual settings.
• Kindle does not stop players without Meadworks from joining: an admin can set Crucible's Network.AdmissionMode to AllowVanilla, and it works when every other installed mod allows it.

Compatibility

• Steps aside: when OpenKeep (2.0 or newer) or Crafting Search is installed, Kindle turns itself off and says so.
• Converter imports: OpenKeep settings (see Configuration).
• Optional Meadworks integrations: Burrow supplies nearby chest counts, favorite protection and salvage from those chests (without it Kindle counts and salvages only your own inventory); Mantle's inventory layout is respected; Inscribe decorates salvage entries.

Notes

• Gamepad: supported through the shared Crucible.UI controller navigation and configurable pad chords.
• Languages: English, Spanish, Simplified Chinese, Russian, French, German and Korean (non-English text is machine-assisted).
• Listed under Thunderstore's AI Generated category; tested in-game.
• Source: Corresponding Source for this exact version, free of charge: https://github.com/ExtraPotions/Meadworks/tree/main/Kindle

Changelog

See the Changelog tab (CHANGELOG.md).

Credits and license

Recipe, batch, tracker, cart and salvage logic adapts OpenKeep 3.0.0 by Gerald Glasgow (GPL-3.0-or-later); YAML helpers adapt ValheimModLibs by Gerald Glasgow (GPL-3.0-or-later); recipe sorting and matching adapt CraftingSearch 1.0.2 by Ab5oluteZer0 (MIT).

Original code: GPL-3.0-or-later. Original artwork and documentation: CC BY-NC-SA 4.0. Retained source and runtime dependency notices are in THIRD_PARTY_NOTICES/; see LICENSE_SCOPE.md.

Author: expDARE.

0.1.25

• Refresh Repair All tooltips when counts, eligibility, ownership or translations change.

0.1.24

• Guard recipe, station and salvage paths when item or inventory data is unavailable.
• Leave Virtual Workbench Key unbound for new entries while preserving saved keys.
• Refresh tracker counts every 1.25 seconds while keeping explicit invalidation immediate.

Changelog

0.1.23 (2026-10-21)

• Thunderstore republish of the release 8 build; no code changes.

0.1.22 (2026-10-21)

• Requires Crucible 0.3.26 / Crucible.UI 0.3.19.

• Salvage materials that have already merged into the inventory stay there if adding the stack fails part way. Only the units that did not land drop at your feet.

• German, Russian, Chinese and Korean text on the crafting screen uses the game's own words for recipes, stations, repair, inventory, chests and the related controls.

0.1.21 (2026-10-21)

• Requires Crucible 0.3.25 / Crucible.UI 0.3.18.
• Salvage tab: also lists gear in nearby chests, marked "From a chest" in Burrow's container color (needs Burrow). It uses the chests Burrow's Reach crafting uses: the same range, wards, privacy, chest allow/deny lists and per-player Reach toggle; chests another player has open and chests held by another transfer are skipped. Favorites, equipped items and every other salvage rule are refused as for carried gear; the hotbar rule still applies only to your own inventory. Salvaging a chest item takes it out through Burrow's durable chest hold (the chest is claimed or handed over by its owner first, the slot must still hold the listed item, and nothing changes if it moved). The materials go into your inventory, and what does not fit drops at your feet. Without Burrow, Kindle lists only your inventory, as before.
• New setting Salvage / Nearby Chests (default on; host value applies on a server, your own in single player). English, Spanish and French text.

0.1.20 (2026-10-20)

• Requires Crucible 0.3.24 / Crucible.UI 0.3.17.
• Salvage tab: favoriting or unfavoriting an item in Burrow shows in the open tab within a quarter second. A favorite is listed dimmed with "Favorite items are not salvaged", and an unfavorited item can be salvaged again. Before, the list kept the old state until the inventory changed. Favorites are still read only through Burrow's optional capability; without Burrow nothing is a favorite, as before.
• Faster inventory: with the recipe search and category rows shown, the recipe list is no longer moved and moved back every frame while the inventory is open (that rebuilt the recipe list's layout and the inventory canvas each frame). The list is laid out again only when a row, a setting or the list itself changes. No visible change.
• Salvage tab: the chosen item's rarity backdrop on the large detail icon stays shown. With the slower redraw it flashed for one frame each second, because Inscribe's crafting-panel update cleared it every frame and Kindle only put it back on a redraw.

0.1.19 (2026-10-20)

• Requires Crucible 0.3.23 / Crucible.UI 0.3.16.
• Burrow's Trash Uses Salvage works: Kindle now provides the two salvage capabilities Burrow asks for (meadworks.crafting.salvage_can and meadworks.crafting.salvage_item), so a stack dropped on the trash can is salvaged through the Salvage tab's own rules instead of destroyed. Before, Kindle never registered them and the trash can always destroyed.
• Faster inventory: away from a repairing station, the grayed Repair button no longer turns off and on every frame while the inventory is open (it rebuilt the crafting panel each frame). Its tooltip is refreshed with the repairable count instead of every frame. No visible change.
• Faster Salvage tab: the chosen item's name, description, tooltip, returns and Salvage button are redrawn only when the item, its stack, the inventory, the station, a setting or the second changes. Before, the game's recipe update hid them every frame and Kindle redrew them, rebuilding the full item tooltip each time.
• The crafting amount row fits its text: Craft and the -, amount and + controls are as tall as the Craft caption plus padding (at least 30), centered where the game's taller button was. The game's size comes back when batch crafting is off.
• Salvage of found gear: Require Known Recipe now counts gear nobody crafted (Inscribe loot and chest gear, trader stock, drops) as known, and every recipe when the world unlocks all recipes or no-cost is on. Paws of the Bear and other found gear of a recipe you never learned were hidden from the Salvage tab. Returns stay the recipe's real materials; Deep North upgrade-station tokens are never refunded.
• The Salvage tab lists gear that cannot be salvaged right now (equipped, favorite, excluded, recipe unknown, another mod's data, no station) dimmed, with the reason in its tooltip and on the Salvage button, instead of leaving it out.
• New setting Crafting Stations / Use Distance Multiplier (default 1.5, range 1 to 3, host value applies on a server, your own in single player): you can use a crafting station from that many times the game's distance. It applies at once. English, Spanish and French text.

0.1.18 (2026-10-19)

• Requires Crucible 0.3.22 / Crucible.UI 0.3.15.
• Simpler in-game settings: the MeadWorks menu (F8) shows Kindle's eight essential settings; everything else stays in Almanac and the config file, and the OpenKeep import rows and salvage data lists are marked as file settings. Favorite Recipe Key (was F) and Salvage Key (was Backspace) are unbound by default; middle click, the star button and the Salvage button do the same jobs. Gamepad Sort Button now defaults to Back instead of the left stick press, which the game uses as its multi-craft modifier. A saved value that still equals the old default moves to the new default once (the cfg is backed up first); any value you chose is kept. No setting keys change.

Batch 3

• Salvage returns socketed gems by Inscribe's Gem Recovery chance for the item's tier (meadworks.crafting.salvage_gems); a message says how many were lost. Without Inscribe nothing changes.
• Virtual Workbench (host setting, off by default): Virtual Workbench Key (your own key, default J) reopens the crafting station you used last from anywhere it is still loaded. It is that real station, so its level, extensions, roof and fire rules apply; crafting takes only carried materials, as at the station. Nothing is built or copied, only the use-distance check is relaxed for that station, and turning the host setting off closes the menu. Cart stations are not remembered. English, Spanish and French text.

0.1.17 - batch 4E gameplay fixes (2026-10-19)

• Crafting window: the vertical Enhance/Salvage panel is removed; Repair All and the horizontal tabs stay, and Salvage no longer shows leftover Enhance rows.
• Settings audit: affected settings apply live.
• Requires Crucible 0.3.21 / Crucible.UI 0.3.14.

0.1.16 - current-build preview refresh

Release stamps and dependency floors for the tested current UI/settings work. This is an intermediate build; expanded 4D and queued 4E are not completed. Exact checks and known limits ship in installer build evidence.

0.1.15 (2026-10-18)

• Use typed salvage confirmations with fresh inventory validation and shared notice presentation for existing actions.

• Use the shared typed confirmation service for clearing recipe favorites while retaining the existing validation and native fallback. The shared HUD layout editor can position and resize the recipe tracker without changing its enabled setting.

• Require Crucible 0.3.19 / Crucible.UI 0.3.12 for the shared UI/API integration. Broader 4D qualification is pending.

0.1.14 (2026-10-18)

• Keep recipe search, category, sorting and batch controls on the native crafting tabs when another mod's crafting tab is selected. Uses the shared Crucible 0.3.18 tab selection contract. Qualification evidence and limits are recorded in the combined failure-batch report.

• Added Repair / Repair On Station Open, a default-off local option that honors existing server locks. A successful usable station opening runs the same free repair-all action as the Repair button for eligible carried and equipped gear. Repeated use while the same station remains open, failed interactions and other actors do not trigger it. Focused local native qualification passed.

0.1.13 (2026-10-15)

• First release on Thunderstore.