📌 Recipe Pinner

Stop running back and forth between chests just to check how much Iron you need!

Recipe Pinner is a quality-of-life mod that lets you "pin" any crafting recipe to your HUD. It tracks materials in your inventory (and nearby chests!) in real-time, helping you focus on crafting, not memorizing numbers.

🌟 Key Features

• 📍 Pin & Forget: Hover over any recipe (Crafting Table, Cauldron) or Construction Piece (Hammer) and press Middle Mouse to pin it.
  • New: Now fully supports auto-unpinning when building structures with the Hammer!
• 📄 Pagination System: Pinned too many recipes? No problem! The list automatically splits into pages to keep your screen clean.
  • Includes stylish diamond-shaped indicators to show which page you are on.
• 📦 Smart Chest Scanner: Automatically counts items in nearby chests.
  • Green Text: You have enough in your Inventory.
  • Yellow Text: You have enough combined (Inventory + Nearby Chests). (If ChestScanner enable)
  • Red Text: Missing materials. Time to farm!
• 🎨 Fully Customizable: Change colors, font sizes, positions, opacity, and pins per page via config.
• 🧩 Multiple Layouts: Auto-detects MyLittleUI mod or lets you choose your style.

🖼️ Visuals & Layouts

The mod supports 3 different layout modes to fit your screen perfectly.

1. Vertical Mode (Standard)

Placed under the minimap. Good for vanilla UI.

2. Horizontal Mode (Map Side)

Perfect if you use MyLittleUI. Places pins to the left of the map.

3. Horizontal Mode (Bottom Right)

Keeps the top screen clean. Places pins near your ammo/hotbar.

If you don't like these 3 layouts, you can set your own layout using Configuration Manager.

⚙️ Configuration

I strongly recommend using Configuration Manager to edit settings in-game (Press F1).

You can tweak:

• Colors (Hex & RGBA)
• UI Position (X, Y coordinates) & Scales
• Pagination Settings (Pins per Page, Dot Size, Spacing)
• Fonts and Opacity

🔧 Installation

1. Download and install BepInEx.
2. Extract the RecipePinner.dll and RecipePinner_languages folder into Valheim/BepInEx/plugins/.
3. Done!

⚠️ IMPORTANT: Ensure the RecipePinner_languages folder is next to the .dll file for translations to work.

🎮 Controls

Default keys (Changeable in Config):

🌍 Supported Languages

Auto-detected based on your game language.

🇺🇸 English, 🇹🇷 Turkish, 🇩🇪 German, 🇷🇺 Russian, 🇪🇸 Spanish, 🇫🇷 French, 🇧🇷 Portuguese, 🇵🇱 Polish, 🇨🇳 Chinese, 🇯🇵 Japanese, 🇰🇷 Korean, 🇮🇹 Italian, 🇺🇦 Ukrainian.

Missing a language? You can easily add your language!

🌍 How to Add Your Language

1. Open your Valheim folder and navigate to: BepInEx/plugins/RecipePinner/RecipePinner_languages/
2. Create a new text file and name it YourLanguage.json (e.g., Italian.json).
3. Open the file with a text editor (like Notepad) and paste this template:

   {
     "pinned": "Recipe Pinned!",
     "unpinned": "Pin Removed",
     "list_full": "List Full!",
     "added_more": "Added More: {0}x",
     "decreased": "Decreased: {0}x",
     "cleared": "Pinned Recipes Cleared",
     "max_level": "Max Level Reached",
     "no_upgrade_cost": "No upgrade cost found"
   }
   

4. Translate the sentences on the right side.
   • Important: Do not change the {0}x part, as it shows the numbers!
5. Save the file.
6. To use it: Open the mod settings (F1) or config file, and set LanguageOverride to your file name (e.g., Italian).

Mirror

NexusMods

📞 Support & Feedback

Found a bug? Have a feature request? Ping me on Discord: kadrio or create an Issue on GitHub.

Enjoy crafting! 🛠️

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.