🛠️ BalrondHammerSorter - Mod Documentation

🛠️ Overview

BalrondHammerSorter is a Valheim mod that completely overhauls your hammer’s build menu. It gives you full control over how build pieces are organized, displayed, and accessed. Best used along side mods like :

• Sears Catalog.

This mod provides:

• 📁 Advanced tab sorting and custom renaming
• 🧩 Three additional custom tabs
• 🗂️ Complete piece reordering within any tab
• ⚙️ Seamless support for both vanilla and modded build pieces

🔧 All customization is handled via a single JSON configuration file.

💡 If you use other building mods, simply merge their prefabID names into your config to include them automatically.

🌟 Key Features

• 🗂 Full Tab Customization

  • Renamed tabs to better reflect their content and divide them best i could:
    • Misc
    • Crafting
    • Walls & Doors (includes windows)
    • Floors & Stairs
    • Beams & Poles
    • Roofs & Lights
    • Furniture
    • Rugs & Banners

• ➕ Additional Tabs

  • Includes 3 extra tabs for expanded categorization.

  ⚠️ *Note: No you can't add more tabs with this.

• 🧩 Piece Sorting

  • Define the precise order of every build piece within each tab.

• 🚀 Convenient Shortcuts

  • Press N while holding the hammer to instantly select the Repair tool.
  • Press O while holding the hammer to reload your configuration file without restarting the game(may take few seconds for it to show up you may need to take off the hammer and equip it again).

  ⚠️ *Note: In future works its planned to have those shortcuts set via config

• ⚙️ Auto Sorting

  • Any pieces not included in your config will be automatically sorted and placed in the appropriate tab. A simple script that checks the name of prefabID and picks best suited tab to add it otherwise it ends in MISC.

  ⚠️ *Note: The auto sorting is made for the default setup if you decided to change name of tabs and divide them different way you will need to input all the pieces in config

• 📝 Console Logging

  • All unconfigured pieces are listed in your console log by their prefab IDs so you can easily update your config and change what you need.

• 📦 Ready-to-Use Default Config

  • Comes with a default configuration that organizes all Balrond’s mod pieces along with vanilla items.

    ⚠️ *Note: Dont worry if you dont use Balrond's mods they will just get skipped

Preview

⚙️ Configuration

🖥 Client-side only. No server sync is required.

The mod uses a JSON file named balrond-hammerconfig.json. This file must be placed in your config folder.

📝 Remember to backup your config it takes time to write one down like this and config is delivered with the mod on updates.

Each tab entry includes:

• name: The label displayed in-game. You can rename it or translate this to any language.
• order: The tab’s position in the list. (Do not modify this as it responds directly to order number of original base category)
• orginal: The internal name of the original tab. (Do not change.)
• pieces: A list of build piece prefab IDs, sorted as you wish.

✅ Example Configuration:

> ⚠️ *Note: You can't comment an entry it needs to be removed

{
  "tabs": [
    {
      "name": "Misc",
      "order": 0,
      "orginal": "Misc",
      "pieces": [
        "piece_repair",
        "wood_stack",
        "wood_fine_stack"
      ]
    }
  ]
}

💬 Community & Support

• Join our Discord: Balrond's Den
• Support on Ko-fi: ko-fi.com/balrond1020

🧾 Changelog