1. How to Use the Base Assistant

Getting your Assistant helper up and running is extremely simple.

1.1 Build the Assistant Totem Equip your Hammer and look for the Base Assistant category. Select the Assistant Totem and place it anywhere in your base. This totem is the "anchor" point for your NPC.

1.2 Meet your Assistant As soon as the totem is built, the Dverger Assistant will spawn and immediately start scanning the area for tasks. If he doesn't have anything to do, he will wander around near the totem.

1.3 The Totem Control Panel (UI) Interact with the totem (Press E) to open the Totem Control Panel. From this UI, you can:

• Rename your Assistant: Give them a custom name (e.g., "Bob the Builder").
• Assign a Profession: Restrict them to specific tasks (General, Smelter, Organizer, or Repairer).
• Toggle Radar Dome: Show/hide the glowing blue sphere that marks their work radius.
• Vacation Mode: Pause the assistant indefinitely if you want them to stop working.
• Call NPC: Teleport the assistant directly to the totem if they ever get stuck in the terrain.

1.4 Sleep and Danger The Assistant has basic survival instincts:

• Nighttime: When night falls, the assistant goes to sleep. You should build an Assistant Bed for each NPC. They will uniquely claim their bed and sleep peacefully without bugs.
• Raids/Danger: If the base is attacked, the assistant abandons all tasks and hides near the totem until the threat is cleared.

1.5 Managing Tasks You don't need to assign tasks manually unless you want to specialize them via the Totem UI. Simply drop items on the floor, leave damaged walls, or place empty smelters within the dome, and the Assistant will prioritize them automatically!

2. Chest Organization Rules

The Base Assistant has a highly advanced logic system for storing items. It prevents messy chests and respects your base layout.

2.1 Visual Affinity (Auto-Sorting) If you don't name your chests, the Assistant will look inside every chest in the radius and score them:

• Perfect Match (+100): If a chest already has Wood and has free stack space, the assistant will ALWAYS put more Wood there.
• Category Match (+50): If a chest is full of tools/weapons, the Assistant will place other weapons there, even if they aren't exactly the same.
• Master Inbox Chest: The newly upgraded BlackMetal Chest acts as the main Inbox. You can drop everything inside it, and the Assistant will pull items from it and sort them into your final chests.
• Strict Prevention: The Assistant will never mix food with ores, or weapons with mob drops. If no suitable chest is found, it will look for a completely empty chest to start a new category.

2.2 Custom Chest Names (Overrides) You can force the assistant to obey strict rules by renaming your chests (using Valheim's standard Shift+E or a sign/nameplate mod):

• Specific Items: Name a chest exactly Iron or Ferro (based on your game language), and the Assistant will ONLY put that specific item inside.
• Categories: Name a chest Weapons or Food, and the Assistant will lock that chest for those specific item types.
• Blacklist: Name a chest Ignore or Private, and the Assistant will pretend that chest doesn't exist.

2.3 Anti-Duplication System Running multiple assistants? No problem! The mod features a global reservation system. When an assistant decides to pick up an item, that item is instantly locked. Other NPCs will ignore it, preventing cloning and item loss bugs.

3. Configuration (Live Reload)

You can tweak the Assistant's brain in real-time using the com.singularitydot.baseassistant.cfg file via Thunderstore Mod Manager or BepInEx Configuration Manager. Changes apply immediately in-game without restarting!

General Settings

• WorkRadius (30.0): The max distance the assistant will travel from the totem.
• NpcWalkSpeed (2.5) / NpcRunSpeed (5.0): How fast the Dverger moves.

Production Limits & Safety

• MaxCoalAmount (200): If you have this much Coal in your chests, the assistant stops feeding the Wood Kiln.
• Leave[Metal]Ore (10): The assistant will smelt infinitely but will always leave this amount of raw ore (Copper, Iron, Tin, etc.) safe in your chests.
• LeaveWoodAmount (10): The assistant will never take the last 10 wood from your chests to fuel kilns.
• LeaveCoalAmount (10): Keeps an emergency reserve of coal safe from being fed into smelters.

Repair & Interaction

• RepairHealthThreshold (0.8): Starts repairing when a structure drops below 80% health.
• AoERepairRadius (10.0): When repairing a wall, the assistant magically repairs everything else within 10 meters of it.
• StuckTimeout (5.0): If the NPC is blocked by players or other NPCs for 5 seconds, it intelligently drops the task and tries something else to avoid lagging the game.