Vertical Mode

Placed under the minimap. Good for vanilla UI. This is what the default Auto-Detect mode uses when MyLittleUI is not installed.

Horizontal Mode

Useful for MyLittleUI users. Places pins near the map side. When the layout setting is left on Auto-Detect and MyLittleUI is installed, this layout is triggered automatically.

Bottom Right Horizontal Mode

Keeps the top of the screen cleaner and works well when inventory or containers are open.

My Pins Panel

Manage, remove, group, disband, and inspect your active pins from the inventory screen.

Pin Groups

Group multiple recipes into one named project with a merged material list.

Expanded Group Members

Expand a group in My Pins to manage individual members and group claim counts.

Compact Group Layout

When a group needs many different materials, its HUD pin switches to a compact grid to save space.

Overflow Cell

If a compact group is still too long, the remaining materials collapse into a single +N cell.

Controls Info Panel

View current keybindings and basic usage instructions from inside the My Pins panel.

MyLittleUI Compatibility

Recipe Pinner can automatically adjust its layout when MyLittleUI is installed.

Inventory Open

When inventory is open, pins can move to a cleaner bottom-right layout.

Gathering List

The Gathering List shows combined material requirements across all pins.

Chest-Side Gathering List

The Gathering List snaps next to an open chest, so you can see what you still need while moving items around.

Chest Scanner

When Chest Scanner is enabled, nearby chest materials can be included in the displayed counts.

HUD Pages

When you pin more recipes than fit at once, they split into pages. Cycle through them with the page hotkey.

Sailing

Recipe Pinner can move pins while sailing to reduce HUD overlap.

No. Recipe Pinner only tracks recipes and materials. You still craft and build normally.

No. It only reads nearby chest contents and includes them in the displayed material counts.

No. Chest Scanner is disabled by default. You can enable it from the config if you want nearby chest contents to count toward requirements.

Yes. Hammer build pieces can be pinned like crafting recipes.

The pin count increases, and the displayed material requirements update for the new count.

By default, hold Left Shift and press Mouse Wheel Click over the recipe or build piece. You can change the modifier with HotkeyUnpin.

Open your inventory and use the My Pins button. From there, you can view, remove, group, disband, and manage pins.

Yes. Starting with 1.3.0, you can create named Pin Groups from the My Pins panel.

Yes. Recipe Pinner supports per-group member claim counts, so duplicate pins can be split between groups or kept as individual pins.

Yes. Use Disband to turn group members back into individual pins.

Groups with many different materials switch to a compact grid, and that grid is capped so one large group cannot stretch every pin next to it. The materials that do not fit are collapsed into a +N cell.

You can raise the row cap with GroupCompactMaxRows, or change when compact mode starts with GroupCompactThreshold. Both apply immediately. A group pinned on its own never shows +N.

No. Each character has its own pins, saved separately. Switching characters loads that character's own list.

Yes. AutoDetect can adjust the HUD layout when MyLittleUI is installed to reduce overlap with other UI elements.

Yes. MyPinsButtonPosition sets where it sits and MyPinsButtonSize how big it is, and both apply the moment you change them - open the config while the inventory is on screen and you can watch the button move. X grows to the left and Y grows upward. If another mod rearranges the crafting panel, this is the setting that gets the button out of its way.

Yes, in two places, and only while something of its own is open. While the My Pins panel or one of its dialogs (group name, confirmation, controls info) is on screen, Recipe Pinner blocks player input and keeps the inventory from closing - so that typing a group name does not swing your axe, and so that a key press does not close the window out from under a confirmation prompt. Both stop the moment the panel or dialog closes.

This is worth knowing because it is the most likely place for a conflict with another mod that takes over input or the inventory window. If something behaves oddly, close My Pins and any open dialog and try again. If the problem only happens while one of them is open, it is an interaction with this mod - please report it and name the other mod.

Yes. Hotkeys can be changed from the config. Using Configuration Manager is recommended.

Version 1.3.0 reorganized the config categories to make settings easier to find. If a setting moved to a new category, its old value may not have carried over.

If you are coming from 1.2.x, it is worth launching once, opening the config, and glancing over the layout, hotkey, Chest Scanner and Gathering List sections. Nothing is broken if you skip it - you may just be running a default you did not choose.

Version 1.3.0 includes language files for every Valheim-supported language, but some translations were AI-assisted. Please report incorrect or awkward translations.

1.3.2

Added

• Pin a recipe more than once and each material row now also shows what a single one costs, in brackets. Ten stone axes need fifty wood, so the row reads 8/50(5) — the total stays red while (5) turns green as soon as you can afford one axe. Turn it off with ShowSingleUnitRequirement.
• Hovering the My Pins button now shows its name above it, the way Valheim's own Compendium, Skills and Trophies buttons do.

Changed

• The My Pins button has moved. It used to sit in the crafting panel's header, on top of the crafting station's own picture; it now sits to the left of the tab row, and its default size is 30 rather than 40.

  • Note: if you never changed MyPinsButtonPosition or MyPinsButtonSize, the new placement is applied for you once, on your first launch after updating. If you had set either one yourself, nothing moves. Either setting puts the button wherever you want it, including back where it was.

Fixed

• Fixed the delete button on a pinned recipe removing a group instead, when a group had been given exactly the same name as that recipe. Both buttons now always act on the row they belong to, and group names stay unrestricted.
• Fixed a language file the mod cannot read failing silently. When fewer than half the expected lines are read, it now warns with the file name and the count, so a broken translation no longer looks exactly like a working one.
• Fixed every launch reloading the translations, the recipe cache and the UI once at the main menu, because startup registered a language change that had not happened.

1.3.1

Added

• Added a group_name_empty localization key for the empty-group-name message, translated in all 36 shipped language files.

Changed

• ContainerGatheringListPosition now sets the gap between the chest window's top-right corner and the Gathering List's top-left corner, instead of an offset from the screen centre. The default is (90, 2).

  • Note: Values saved under the old meaning have a negative X. Those are recognised and replaced by the new default, so the panel does not move for anyone updating. Set a positive X to choose your own spacing.

• Reduced the work done every frame while the Gathering List is open. The material list, its colours and text, its layout rebuilds, its placement setup and the inventory tally behind every pin's material counts are now recalculated only when something actually changes.

Fixed

• Fixed recipes that share an internal name pinning as a single entry whose counter simply climbed instead of pinning separately. Jewelcrafting gems are the clearest case: a gem's separate recipes now pin as separate entries, each with its own materials and its own auto-unpin.

  • Note: gem pins saved before this update need to be unpinned and pinned again once to separate them. Every other pin is unaffected and loads unchanged.

• Fixed the Gathering List sitting in the wrong place beside an open chest at any game UI scale other than 80 — drifting away from the chest window at smaller scales, and ending up behind the inventory panel at larger ones. It is now placed from the chest window itself and follows it at every scale and resolution.

• Fixed opening or closing the inventory sending the pinned-recipe HUD back to page 1. The same cause was also tearing the HUD down twice every time it was rebuilt.

• Fixed the Confirm button doing nothing at all when the group name field was left empty. It now says the name cannot be empty and keeps the dialog open with what you typed.

• Fixed an upgrade recipe with no item data throwing an error out of the crafting hook. Such a recipe is now refused, both when pinning and when auto-unpinning, instead of producing a pin with an empty name.

• Fixed the layout width and spacing settings accepting zero or negative values, which left the HUD unusable with no explanation. Widths now accept 50-1000 and spacings 0-200.

• Fixed the Controls ("i") button playing its click sound twice.

• Fixed a "Cannot create canvas" warning that could repeat every frame while the game HUD was unavailable.

1.3.0

Added

• Added Pin Groups: select multiple pins and combine them into a named group with a merged resource list and a stacked-cards group icon.

• Added a new My Pins management panel, accessible from the inventory screen, for viewing, selecting, grouping, disbanding, and removing pins.

• Added expandable sub-item views in the My Pins panel for managing individual group members.

• Added per-group member claim counts, allowing recipes to belong to multiple groups or remain partially available as individual pins.

• Added persistent group/order support: Pin Groups, group member counts, and pin/group ordering are now saved and loaded alongside existing pinned recipe data.

• Added Compact Group Layout (GroupCompactThreshold): groups with many unique materials automatically switch to a compact grid layout to save HUD space. The threshold applies immediately without restarting, and the grid's column count is derived from your configured pin width.

• Added GroupCompactMaxRows: controls how many grid rows a compact group pin shows before the remaining materials collapse into a +N cell. Changes apply immediately without restarting.

• Added a full-list mode for lone groups: a group pinned on its own drops the +N cell and shows every material, turning it into a permanent gathering list.

• Added confirmation and group-naming dialogs with input locking so game controls do not interfere while typing.

• Added a Controls Info panel, accessible via the info button in the My Pins panel, showing keybindings and usage instructions.

• Added configurable Unpin modifier (HotkeyUnpin): hold it while pressing the Pin hotkey over a recipe or build piece to decrease/remove that pin.

• Added a dedicated building auto-unpin setting (AutoUnpinAfterBuilding), separate from crafting auto-unpin behavior.

• Added configurable column count for the Gathering List grid, with automatic panel resizing in horizontal layouts.

• Added new HUD icon size settings for recipe, material, and group icons.

• Added new My Pins panel/button configuration options.

• Added missing language files to the RecipePinner_languages folder so every Valheim-supported language now has a translation file.

  • Note: Some translations may be imperfect because they were AI-assisted. Please report any incorrect translations.

Changed

• Building-piece auto-unpin is now controlled by its own AutoUnpinAfterBuilding setting instead of sharing the crafting auto-unpin setting.

• Improved building auto-unpin handling for placed building pieces.

• Improved recipe/build hotkey handling so invalid contexts no longer trigger unintended pin/unpin behavior.

• Improved save/load reliability for pinned recipes and pin order.

• The clear-all hotkey now asks for confirmation instead of wiping every pin on a single press: press it once to arm, then again within two seconds.

• Improved Gathering List positioning and layout behavior in horizontal HUD layouts.

• Improved HUD/Gathering List behavior when pins are hidden or when the Gathering List is shown by itself.

• Improved MyLittleUI AutoDetect compatibility, including better vertical placement when MyLittleUI status lists are disabled.

• Improved MyLittleUI config parsing so only exact Enable = true/false values in the relevant sections are read.

• Improved localization parsing, including support for common escaped characters and different line endings.

• Reorganized config categories for clearer ordering and grouping.

  • Note: Because config category names changed, some users may need to review or reapply existing config values.

Fixed

• Fixed recipes with multiple output variants (for example Bronze 1x and Bronze 5x) always pinning the first variant. The hovered row is now matched exactly instead of by display name, so the 5x recipe pins its own 5x material cost. This also affects mods that add 1x/5x crafting options.
• Fixed the mod overwriting your pin save file with empty data while it was disabled. With EnableMod = false, two consecutive saves could permanently erase every pinned recipe.
• Fixed cleared pins not being saved immediately after using the clear-all hotkey.
• Fixed auto-unpin results being lost when the game closed without a clean exit.
• Fixed pins loading without validation after switching characters within the same session.
• Fixed pin saves to use an atomic temp-file replace with a .bak backup instead of writing directly to the final save file.
• Fixed duplicate save entries producing duplicate pin order and UI entries.
• Fixed impossible edited-save upgrade pins such as ★999 being accepted.
• Fixed MaximumPins reductions not trimming, rebuilding, and paginating pins consistently.
• Fixed pagination/page-size behavior when MaximumPins < PinsPerPage.
• Fixed Recipe Pinner hotkeys firing behind non-crafting inventory panels such as Skills, Trophies, and Compendium.
• Fixed the unpin combination acting or logging outside valid recipe and build contexts.
• Fixed possible crashes, null-reference edge cases, or missing display data when recipes, build pieces, modded resources, Gathering List slots, pin slots, or resource slot UI components contain incomplete data.
• Fixed RefreshRecipeCache forcing the HUD visible for a frame even when the overlay was hidden.
• Fixed HUD visibility becoming inconsistent after clearing all pins while the overlay was hidden.
• Fixed player death/null-player UI handling so pinned HUD overlays hide together with the rest of the game HUD.
• Fixed shutdown save-path warnings when the mod is destroyed after the player name has already been cleared.
• Fixed Gathering List positioning when HUD pins are hidden: pagination spacing no longer leaves an empty offset, so the Gathering List can move into the first pin position correctly.
• Fixed an issue in horizontal layout mode where the Gathering List retained an incorrect offset and gap because anchors were not reset correctly in gathering-list-only mode.
• Fixed Gathering List placement in MyLittleUI vertical AutoDetect mode when its status lists are disabled.
• Fixed Chest Scan runtime toggling so enabling or disabling it through a mod manager takes effect without restarting the game.
• Fixed stale container references not being cleared when Chest Scan is disabled.
• Fixed container cleanup so destroyed containers are removed from tracking more reliably.
• Fixed Chest Scan re-enable behavior so active containers are scanned again after toggling the feature back on.
• Fixed inventory item count recalculation occurring every frame during Chest Scan; it is now only evaluated when a container scan trigger condition is met.
• Fixed the LanguageOverride config value flowing into a file path without sanitizing.

1.2.4

• Fixed Gathering List positioning issues across all layout modes when pins are hidden via toggle (F7).
• Fixed Gathering List not repositioning to chest location when pins are hidden and a chest is opened.
• Fixed Gathering List visibility being reset when changing config settings while only the Gathering List is visible.
• Fixed an issue where the Gathering List wouldn't update inventory amounts while pins were hidden (F7 mode).
• Fixed a potential bug where clearing all pins while a chest is open could cause the Gathering List panel to remain orphaned on the screen.
• Fixed reflection initialization log reporting inaccurate success/fail counts.
• Fixed inconsistent logging in MyLittleUI config reader.
• Added value range (8-40) to font size config entries to prevent invalid values.
• Removed dead code and cleaned up leftover code artifacts.
• Refactored UIManager into partial classes for better code organization.

1.2.3

⚠️ IMPORTANT NOTE FOR EXISTING USERS: Due to layout improvements, the default position for the Gathering List while a chest is open has changed. Please delete your old .cfg file or manually update the InventoryGatheringListPosition setting to x: -400, y: 320 in the config file properly align it.

Developer Note: When I released version 1.2.0, I didn’t have the chance to thoroughly test the mod, and while trying to fix some issues, I ended up breaking other things. If you encounter any bugs, please don’t hesitate to report them via Discord (kadrio) or GitHub. Thank you for your patience!

• Fixed Gathering List incorrectly multiplying material amounts when the same recipe was pinned multiple times.
• Fixed Gathering List opening empty on the first pin instead of waiting for 2+ pins.
• Fixed Gathering List not clearing its data when all pins were removed.
• Fixed an issue where the Gathering List's position while a chest is open.
• Please report bugs.

1.2.2

• Optimized memory usage and eliminated unnecessary log outputs by ensuring the game's containers are no longer tracked in the background when the Chest Scanner feature is disabled.
• A new “Work in Progress” section and new features for “Future Plans” have been added to the README file.
• No need to delete config file.

1.2.1

• README file fixed only. No need to delete config file.

1.2.0

• ⚠️ IMPORTANT: The configuration structure has been heavily overhauled. Please delete your old com.Kadrio.RecipePinner.cfg file before launching the game!
• 🌍 LOCALIZATION UPDATE: Added new translation keys for the Gathering List (gathering_title, gathering_opened, gathering_closed, gathering_empty, gathering_hint). The 13 default languages are already updated, but if you use a custom language file, please update it!
• Added a new 'Gathering List' panel (Toggle: F8) that aggregates total required materials across all pinned recipes.
• Added automatic visibility logic for the Gathering List (auto-opens when 2+ recipes are pinned, auto-closes when below 2).
• Added a 'Craft Readiness Indicator' to pins, displaying a colored accent bar (green = ready to craft, red = missing materials).
• Added Auto-Unpin functionality that automatically removes recipes from the screen after crafting or building them.
• Inventory/Chest Awareness: When opening your inventory or a chest, the pins will now automatically temporarily switch to the existing 'Bottom Right Horizontal' layout so they don't block the screen.
• The Gathering List will also reposition itself next to the chest panel for easy comparison.
• Implemented real-time live-updating for the Gathering List while interacting with chest contents.
• Improved UI aesthetics by dynamically aligning all pin heights on each page to match the longest panel, preventing jagged layouts and ensuring a clean, uniform look.
• Optimized overall performance by significantly reducing unnecessary UI rebuilds and per-frame calls.
• Improved general codebase stability through extensive cleanup.

1.1.4

• In the 1.1.3 update, I put in an old DLL lol (sorry).

1.1.3

• Fixed upgrade recipes (★3, ★4) showing incorrect material amounts — now correctly calculates costs based on upgrade level.
• Optimized container scanning with a movement cooldown to prevent excessive scans.
• Reduced memory allocations by reusing container snapshot buffers instead of creating new lists each scan.
• Improved dictionary access efficiency across TogglePin, AutoUnpinHook, and AutoUnpinBuildHook using TryGetValue pattern.
• Removed unused legacy PinnedRecipe.cs file.

1.1.2

• Added full support for tracking Item Upgrades (pinning directly from the Upgrade tab).
• Added smart auto-unpin logic to correctly distinguish between crafting new items and upgrading existing ones.
• Added new localization keys (max_level, no_upgrade_cost) for upgrade notifications.
• Optimized internal logic with reflection caching to improve performance and reduce overhead.
• Note: Users with custom language files must update them to include new keys to avoid missing text.

1.1.1

• Updated installation instructions in README. No code changes.

1.1.0

• Added pagination system to handle large numbers of pins (configurable 'PinsPerPage').
• Added visual pagination indicators (diamond dots) with configurable size, spacing, and opacity.
• Added 'Cycle Page' hotkey (Default: LeftAlt) to switch between pages.
• Fixed critical issue where auto-unpinning did not work for construction/hammer placement (added Player.PlacePiece hook).
• Fixed 'Save path invalid' and 'ObjectDB null' warnings in logs during startup/shutdown.
• Optimized UI rendering with dirty-check mechanism to improve performance.
• Updated configuration handling.

1.0.2

• Fixed an issue where using the Middle Mouse Button to remove/deconstruct build pieces would accidentally pin the recipe. Pinning is now restricted to hovering over HUD icons only.

1.0.1

• Fixed README images

1.0.0

• Initial Release