📌 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.

⚠️ IMPORTANT FOR v1.2.0 UPDATE: The configuration structure has been heavily overhauled. Please delete your old com.Kadrio.RecipePinner.cfg file before launching the game to let a fresh config generate!

🌟 Key Features

• 🛍️ Master Gathering List (NEW): Press F8 to view a combined total of all required materials across ALL your pinned recipes! Auto-opens when you pin multiple items and smartly aligns next to open chests for effortless material gathering.
• 🚦 Craft Readiness Indicator (NEW): A sleek color-coded accent bar next to each pin tells you instantly if you can craft it (Green = Ready, Red = Missing materials).
• 📍 Pin & Forget: Hover over any recipe (Crafting Table, Cauldron) or Construction Piece (Hammer) and press Middle Mouse to pin it. Automatically unpins when you craft or build the item!
• 📦 Smart Chest Scanner: Automatically counts items in nearby chests. (You must enable it in the configuration to use it.)
  • Green Text: You have enough in your Inventory.
  • Yellow Text: You have enough combined (Inventory + Nearby Chests).
  • Red Text: Missing materials. Time to farm!
• 🔄 Dynamic UI Repositioning: Pins intelligently slide to the bottom right when you open your inventory or a chest, keeping your screen clutter-free.
• 📄 Pagination System: Pinned too many recipes? No problem! The list automatically splits into pages with stylish diamond-shaped indicators. You can navigate between pages by pressing the ALT key.
• 🎨 Fully Customizable: Change colors, font sizes, positions, opacity, and pins per page via config.

⚙️ Configuration

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

You can tweak:

• Colors (Hex & RGBA for Headers, Missing Mats, Accent Bars)
• Controls
• UI Position (X, Y coordinates) & Scales
• Pagination Settings (Pins per Page, Dot Size, Spacing)
• Fonts and Opacity
• Gathering List Automation

🔧 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 RecipePinner.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.

⚠️ Note: If you can't find your language in the app, please let me know so I can add it in the next update; or you can add it yourself:

🌍 How to Add Your Language

1. Open your Valheim folder and navigate to: BepInEx/plugins/RecipePinner/RecipePinner_languages/
2. Create a new JSON 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",
     "gathering_title": "GATHERING LIST",
     "gathering_opened": "Gathering List Opened",
     "gathering_closed": "Gathering List Closed",
     "gathering_empty": "No Recipes Pinned",
     "gathering_hint": "Open/Close: {0}"
   }
   

4. Translate the sentences on the right side.
   • Important: Do not change the {0}x or {0} parts, as they show the numbers and hotkeys!
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).

🔮 Future Plans & Roadmap

I’m actively thinking about how I can make this mode even better! Here are some features I’m considering adding in future updates:

• 📦 Visual Chest Highlighting: If the Chest Scanner is enabled, visually highlight or mark the specific chests in your base that contain the pinned materials, so you know exactly which box to open!
• VNEI Compatibility

Mirror

NexusMods

📞 Support & Feedback

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

Enjoy crafting! 🛠️