Recipe Pinner

Your crafting companion for Valheim

Pin recipes. Track materials. Group projects. Craft smarter.

Stop running back and forth between chests just to remember how much Iron, Wood, Resin, or Black Metal you still need.

📌 What Is Recipe Pinner?

Recipe Pinner is a quality-of-life mod for Valheim that lets you pin crafting recipes and building pieces directly to your HUD.

It tracks required materials in real time, shows what you already have, can include nearby chest contents, and gives you a clean overview of everything you are trying to craft or build.

With Recipe Pinner, you can:

• Pin crafting recipes and Hammer building pieces to your HUD.
• Track required materials from your inventory.
• Optionally include nearby chest contents with Chest Scanner.
• See a combined Gathering List for all pinned recipes.
• Group multiple pins into named projects.
• Manage all pins from the new My Pins panel.
• Automatically unpin recipes after crafting or building.
• Customize layout, colors, icon sizes, hotkeys, and more.

Less menu checking. Less guessing. More building, crafting, and exploring.

🔄 Updating From Older Versions

If you are updating from an older version, especially 1.2.x, please review your config after launching the game.

Version 1.3.0 reorganizes config categories to make settings easier to understand. Because the category names changed, some existing config values may need to be re-applied.

Recommended:

• Launch the game once after updating.
• Open the config with Configuration Manager.
• Review layout, hotkeys, Chest Scanner, and Gathering List settings.
• Make sure the RecipePinner_languages folder is next to RecipePinner.dll.

Your existing pinned recipe data is still supported, and 1.3.0 adds new saved data for groups and ordering.

⭐ Key Features

📍 Pin Recipes And Building Pieces

Hover over a crafting recipe or Hammer build piece and press the Pin hotkey.

By default:

• Mouse Wheel Click pins or increases count.
• Left Shift + Mouse Wheel Click decreases or removes a pin.

The unpin modifier is now configurable with HotkeyUnpin.

🧩 My Pins And Pin Groups

Version 1.3.0 adds a new My Pins panel and Pin Groups.

Use them to view active pins, remove pins, select multiple pins, create named groups, expand groups, adjust member counts, and disband groups back into individual pins.

Groups are ideal for armor sets, building projects, portal kits, food prep, and other multi-recipe goals. A group appears as one HUD pin with a merged material list and a stacked-cards group icon.

Duplicate pins can also be split between groups or kept as individual pins, so one recipe can belong to more than one project.

When a group needs many different materials, its HUD pin switches to a compact grid to save space. If the list is still too long, the remaining materials collapse into a +N cell. A group pinned on its own always shows every material, which turns it into a permanent gathering list. Both limits are configurable.

📋 Gathering List And Chest Scanner

The Gathering List shows the combined total of all materials required by your active pins.

Chest Scanner can include nearby chest contents in material counts.

Color meaning:

• Green: enough materials in your inventory.
• Yellow: enough materials when nearby chests are included.
• Red: missing materials.

Default Gathering List key: F8

Chest Scanner is disabled by default and only reads nearby chest contents. It does not move items.

🖥️ Smart HUD Layout

Each pin can show a colored accent bar so you can quickly tell whether the recipe is ready to craft.

Recipe Pinner can reposition pins depending on what you are doing.

• Normal HUD layout while exploring.
• Bottom-right layout while inventory or containers are open.
• Horizontal layout support for MyLittleUI users.
• Better placement while sailing.
• Automatic pages when you pin more recipes than fit on one HUD page.

💾 Safer Saves And Ordering

Pinned recipes, Pin Groups, group member counts, and pin/group order are saved together. Version 1.3.0 also improves save reliability with safer temp-file replacement and backup behavior.

🌍 Languages And Customization

Recipe Pinner includes language files for every Valheim-supported language. Some translations were AI-assisted, so please report incorrect or awkward translations.

Almost everything is configurable: hotkeys, layout mode and position, HUD scale, fonts, colors, background opacity, recipe/material/group icon sizes, pin limit and pins per page, compact group behavior, Gathering List columns, My Pins panel size and position, Chest Scanner range and interval, and whether recipes auto-unpin after crafting or building.

🕹️ How To Use

Pin Something

1. Open a crafting station or Hammer build menu.
2. Hover over a recipe or building piece.
3. Press Mouse Wheel Click.

The recipe appears on your HUD with its required materials.

Add More Of The Same Recipe

Press the Pin hotkey again on the same recipe.

Recipe Pinner increases the count and updates the required materials.

Decrease Or Remove A Pin

Hold Left Shift and press Mouse Wheel Click over the recipe or building piece.

You can change Left Shift in the config with HotkeyUnpin.

Create A Group

1. Open your inventory.
2. Open the My Pins panel.
3. Click Group.
4. Select at least two pins.
5. Confirm and enter a group name.

The selected pins become one grouped project with a merged material list.

Manage A Group

In the My Pins panel, expand a group to view its members.

You can adjust member counts, remove members, delete the group, or disband it back into individual pins.

🎮 Controls

Default controls are configurable.

Clearing all pins asks for confirmation: press the key once to arm it, then again within two seconds.

The My Pins panel also includes an info button that shows current keybindings in-game.

🖼️ Layouts And Screenshots

⚙️ Configuration

Using Configuration Manager is strongly recommended.

Recommended config manager:

Official BepInEx ConfigurationManager

Press F1 in-game to edit settings.

🔧 Installation

Mod Manager

Install with Thunderstore Mod Manager or r2modman.

This is the easiest option and handles dependencies automatically.

Manual Installation

1. Install BepInExPack Valheim.
2. Download Recipe Pinner.
3. Place RecipePinner.dll inside your Valheim/BepInEx/plugins/RecipePinner/ folder.
4. Place the RecipePinner_languages folder next to RecipePinner.dll.
5. Launch the game.

Your folder should look like this:

BepInEx/
└── plugins/
    └── RecipePinner/
        ├── RecipePinner.dll
        └── RecipePinner_languages/
            ├── English.json
            ├── Turkish.json
            └── ...

Important: RecipePinner_languages must stay next to RecipePinner.dll.

🌍 Languages

Recipe Pinner auto-detects your Valheim language.

You can also force a language with the LanguageOverride config option.

Version 1.3.0 includes language files for every Valheim-supported language.

Note: Some translations may be imperfect because they were AI-assisted. If you find a bad translation, please report it.

You can also fix one yourself: open the matching .json file in BepInEx/plugins/RecipePinner/RecipePinner_languages/, edit the text on the right side of each line, and save. Leave placeholders like {0} untouched, since they are replaced with numbers and key names at runtime.

❓ FAQ

🧭 Future Ideas

These are features I may consider for future updates:

• Group readiness bar: split a group's accent bar into one segment per member, so a single glance tells you which recipes in the project are already craftable. The third recipe in the group lights up the third segment.
• Chest Scanner support in the readiness bar: turn the accent bar yellow when a recipe is craftable only with nearby chest contents, matching how material counts already behave.
• Pinned recipe highlight: draw a border around pinned recipes inside the crafting panel so you can see what is already pinned at a glance. This one may not be feasible.
• Hold-to-pin quantity preview: hold the Pin hotkey to see how many copies you are about to pin before releasing.
• Pin keybind hint: show the Pin control in the crafting menu's hint bar, next to Move and Use, so new players can discover the pin key without opening the config.
• Material gathered notification.
• Auto-sorting craftable pins to the top.
• Visual chest highlighting for required materials.
• More compatibility improvements with other UI and crafting mods.
• VNEI compatibility.

🤖 AI-Assisted Development

Starting with version 1.3.0, Recipe Pinner is marked as AI-Generated on Thunderstore for transparency. In practice, I think AI-Assisted describes the situation more accurately, but the 1.3.0 update used enough AI-assisted coding that the Thunderstore label felt like the more honest choice.

Earlier versions also used AI assistance, but in a much more limited way: mainly to help locate the relevant parts of the Valheim/BepInEx APIs and referenced Valheim game DLLs, understand which classes or methods were useful for the mod, investigate possible bugs, and reason about edge cases.

Version 1.3.0 was different. I originally tried to build the new systems without heavy AI help, but I could not get them to a release-ready state on my own. In the Work in Progress section, I had said the update might be released within about a month; it is now close to three months, and this is the main reason it took longer. Development started well, but as My Pins, Pin Groups, expanded group management, save/order handling, and release-blocker fixes grew more complex, I started getting stuck and chose to rely on AI assistance much more than before.

That does not mean the mod was released without human review. The final decisions, testing, in-game validation, release judgment, and responsibility for the mod are still mine. I reviewed the changes, tested the behavior in Valheim, and validated the release manually before publishing.

Thank you for using Recipe Pinner.

☕ Support My Work

If Recipe Pinner makes your Valheim life easier, you can support development here:

🔗 Mirrors

• Hexium
• NexusMods

💬 Support And Feedback

Found a bug, translation issue, or compatibility problem?

Contact me on Discord:

kadrio

Or create an issue on GitHub:

GitHub Issues

Pin it. Group it. Gather it. Build it.

See you in Valheim.

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.