Auto Refuel Engine

⚙️ Core Automation Features

🏢 Smelters, Kilns & Blast Furnaces

• []Auto-Refuel: Automatically pulls wood, coal, or specific fuel items from nearby containers when fuel drops below maximum capacity.[/]

  []Auto-Load: Automatically pulls raw ores, scrap metals, or raw wood from nearby containers and feeds them into processing slots.[/]

  []Windmill & Wheel Optimization: Automatically empties processed assets (like barley flour or linen thread) from machine extraction slots and refills the queue with raw barley/flax from nearby chests.[/]

  🕯️ Fireplaces & Torches

  • []Constant Lighting: Automatically stocks fireplaces, standing torches, sconces, and campfires with their required fuel type (wood, resin, etc.) from nearby chests so your village stays bright.[/]

    []Smart Caps: Instantly caps refueling at the exact vanilla maximum capacity to prevent over-stoking bugs.[/]

    🍳 Cooking Stations & Stone Ovens

    • []Smart Feed Mode (Mode 1): Automatically pulls raw meats, fish, or bread dough from containers and mounts them onto open cooking slots/spits. Acts as an automated coal generator—it lets food burn on purpose and ejects it only when it turns to Coal.[/]

      []Turbo Mode (Mode 2): Automatically feeds raw ingredients onto active slots, tracks cooking timers, and instantly ejects cooked food onto the floor the exact millisecond it finishes to prevent burning![/]

      📦 Chest Vacuum & Ground Scraper

      • []Ground Scraper: Automatically sweeps loose items dropped on the warehouse floor and loads them directly into nearby storage boxes.[/]

        []Smart Matching Mode (Mode 1): Restricts vacuum pulls to only collect items that already exist in that specific chest's inventory slots (ideal for automated sorting rooms).[/]

        []Total Pull Mode (Mode 2): Vacuums every item on the floor within radius into the container until slots are completely full.[/]

        ---

        🎹 Interactive Controls & Hotkeys

        • []Left Shift + F(Hover Override): Toggles or cycles the automation behavior of the specific chest, machine, cooking station, or torch you are looking at in real-time.[/]

          []Key (Instant UI Take All): Pressing

          Rwhile looking inside any container menu interface instantly migrates all items from the chest directly into your pockets safely, updating text counters instantly.[/]

          []Key (Quick Stack Matching): Pressing

          Tinside an open container panel scans your pockets for resource types that already exist inside that chest and automatically transfers them until either your inventory is clean or the chest fills up.[/]

          []Chat & Console Focus Insulation: Both the

          TUI shortcuts feature smart focus filtering. If you are actively typing a message in the public chat box or executing console lines, hotkey interception is safely suspended to prevent accidental inventory drops.[/]

          []Live HUD Overlay: Appends your active automation status string directly onto your center crosshair hover tooltip text.[/]

          ---

          🧱 Architectural Core & Persistence Safety

          The mod utilizes an un-wipeable dual-stage configuration framework to store and protect your base layout preferences:

          • []Global Default Panel (

            ninefinger.valheim.autorefuelengine.cfg): Sets the global initial state and search distances for all newly encountered or placed objects across your world cells. Fireplaces and torches are set to

            ENABLEDby default so they keep the lights on automatically.[/]

            []Granular Coordinate Anchoring (

            ninefinger.valheim.autorefuelengine.storage.cfg): Unlike fragile setups that use randomized, volatile network identities (ZDO IDs) that shuffle and wipe out on logouts, this mod maps your overrides directly to the structure's permanent Rounded 3D Spatial Vector Key.[/]

            []Drift & Reset Proof: Because your manual hotkey choices are locked to physical map coordinates inside an independent BepInEx configuration stream, values are completely immune to world-save pruning loops, cell unloads, or server reboots.[/]

            ---

            ⚡ Performance Optimization Metrics

            []0ns Active Gameplay Tax: High-speed RAM dictionary lookups completely replace repetitive hard drive file reading passes during active runtime cells.[/]

            [*]2-Second Spatial Heartbeat: Spatial sweeps execute on a restricted 2. 0-second background timer loop to guarantee completely smooth fram