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.