Automatics - Valheim Mod

Automatics is a mod that automates the tedious tasks of life in Valheim. Most of its features exist in existing mods, but it has been re-designed to make it easier for me to use.

IMPORTANT:

• This mod has been developed by an individual and is not associated with the game's developer in any way. Please refrain from asking the developer any questions regarding this mod.
• This mod has been developed with the sole intention of single-player usage. Please be aware that it is not supported for server operation, and we kindly request your understanding in this matter.

Features

TIP: Each of the features described below can be completely disabled using the "Disable Module" option in the configuration.

For released feature documentation, see docs/user-guide.md.

Automatic door

Automatically opens and closes allowed doors near the player. The open and close intervals, detection distances, allowed doors, optional enable/disable shortcut, and toggle message position can be changed from the configuration.

Automatic mapping

Automatically pins nearby dynamic objects, static objects, and locations to the map, including animals, monsters, flora, minerals, vehicles, portals, dungeons, spots, and other configured objects. You can configure search ranges, allowed targets, static pin saving, destroyed-object pin cleanup, and user-defined objects. The map navigation shortcut starts or clears navigation by holding the configured modifier key (Left Shift by default) and left-clicking a pin on the large map; while navigating, the HUD shows the target name and distance.

• Custom icon pack: You can also define your own icons in png and json files. See docs/custom-icon-pack.md for custom icon pack specifications.

Automatic processing

Uses nearby allowed containers to automate supported processing tasks: supplying materials for crafting, refueling, storing produced items, and charging pieces such as Ballista. Per-piece operations, container search ranges and limits, stop thresholds, and the storage connection effect color can be changed from the configuration.

Automatic feeding

Allows configured tamable creatures to eat valid food from nearby containers, the player's inventory, or both instead of only food dropped on the ground. Feeding range, animal types, and whether animals must move close to the feed can be changed from the configuration.

Automatic repair

Automatically repairs items when the player is near usable crafting stations or, if enabled, when the crafting station GUI is opened. It can also repair nearby pieces while a build tool such as a hammer is equipped.

Automatic mining

Automatically mines allowed minerals around the player. Mining can run at the configured interval or only when the mining shortcut is pressed, and it can require a pickaxe or wishbone for underground minerals.

Automatic storage

Stores eligible player inventory items into nearby allowed containers when the storage shortcut is pressed. It fills existing item stacks first, then prefers containers that already hold the same Valheim item type, and finally uses other containers with space. Hotbar, equipped, quest, and configured excluded items are kept in the player inventory by default.

Automatic pickup

Automatically picks up nearby items at the configured interval when no Pickup All Nearby shortcut is assigned. If the shortcut is assigned, interacting with a pickable object while pressing it picks up matching nearby objects instead of running interval pickup.

Automatic farming

Harvests grown crops around the player and replants the regrowing sapling at each harvested spot, keeping a configurable reserve of every planting input. It can also sow into nearby empty cultivated ground on a spacing grid so the saplings settle healthy. Planting can draw from the player inventory, or from containers you designate by role — cultivation boxes to grow crops, seed-harvest boxes to multiply seeds, and storage boxes to receive the yield. Farming can run at the configured interval or only when the farming shortcut is pressed. While farming is active, Automatic pickup leaves allowlisted crops for farming to harvest and replant.

Console commands

Automatics adds console commands for command discovery, name lookup, nearby object lookup, and map pin cleanup.

• automatics: Shows Automatics command usage.
• printnames: Finds internal and display names.
• printobjects: Shows nearby objects Automatics can handle.
• removemappins: Removes duplicate or filtered map pins.

See Console commands in the released documentation for usage and options.

Configurations

I recommend using Configuration Manager.

Use CONFIG.md for every configuration entry, default value, and accepted value range. Use docs/user-guide.md for feature-by-feature usage notes.

Adding object definitions to Automatics

You can use the Configuration Manager to define objects that you want Automatics to work with.

Open docs/add-user-defined-object.md to learn more about adding user-defined objects.

Languages

Contacts

Open an issue for bug reports, questions, suggestions, and requests.

Credits

• Dependencies:
  • Configuration Manager
  • LitJSON
  • NDesk.Options

License

Automatics is developed and released under the MIT license. For the full text of the license, please see the LICENSE file.

v1.7.0 [2026-07-19]

• Added Automatic Storage for moving eligible inventory items into nearby containers by hotkey.
• Added Automatic Farming for harvesting, replanting, sowing, seed reserves, and role-based container workflows.
• Improved Automatic Mapping performance, cache coherence, navigation, cleanup, and object matching.
• Improved Automatic Processing performance and container handling, including dedicated-server-safe mutations and storage effects.
• Improved multiplayer access and ownership handling for doors, feeding, farming, pickup, processing, and containers.
• Fixed config migration and console command edge cases, including bounded regular-expression matching.
• Added optional in-game smoke tests for live Storage, Door, Pickup, and Processing workflows.

v1.6.0 [2026-05-17]

• Updated for Valheim 0.221.12 and added automation data for Ashlands, Bog Witch, and Call to Arms content.
• Added a config migration that appends new default automation targets to existing allow lists.
• Added map navigation from selected pins, including HUD distance display while navigating.
• Improved Automatic Mapping performance and stability with throttled dynamic scans, spatial pin lookups, safer static scan invalidation, dense-area scan fallback, and cached MineRock5 collider data.
• Improved Automatic Door behavior for predicted player movement and multiplayer or dedicated-server sessions.
• Added configurable Automatic Processing connection effects and fixed stale container lookup reuse across different search limits.
• Fixed Automatic Pickup and Automatic Feeding ownership handling in multiplayer or dedicated-server sessions to avoid unsaved item changes or lost pickups.
• Fixed translations not refreshing after language changes.
• Modernized the build scripts, release checks, README, configuration reference, and user guide.

v1.5.1 [2023-10-15]

• Fixed an issue that could potentially cause exceptions when attempting to place containers added by specific mods. (#61)

v1.5.0 [2023-10-08]

• Update for Valheim 0.217.24
• The removal of the previously deprecated "module_disable" option and the "resources_directory"

v1.4.8 [2023-07-09]

• Update for Valheim 0.216.9
• Removed the "allow_non_duplicate_pins" option from the "removemappins" command. Instead, added the "dry-run" and "dangerous-mode" options.
• Enabled specifying prefab names as targets for custom icons. For more details, please refer to custom-icon-pack.adoc.

v1.4.7 [2023-05-13]

• Added a console command to remove map pins.

v1.4.6 [2023-05-02]

• Fixed a bug where static pins were immediately deleted when the "Save Static Object Pins" option was not enabled.

v1.4.5 [2023-05-01]

• Fixed a bug where pins for static objects were sometimes duplicated when the player moved using portals.
• Fixed a bug where an exception could occur when trying to delete a pin by right-clicking it.
• Automatic Pickup no longer pickup items if it would cause the player to become overweight.
• Added an option to the Automatic Processing to store only if products exist in the container.
• Added a Ballista to Automatic Processing targets.
• Changed the display name and description of the Automatic Processing config.

v1.4.4 [2023-03-23]

• Fixed a bug where the automatic door stops functioning when the player moves a certain distance away from it.
• Fixed a bug where pins would be duplicated and added when the vehicle moves, if the vehicle's automatic mapping is enabled.

v1.4.3 [2023-03-18]

• Updated for changes in Valheim 0.214.2.
• Fixed a bug where the "Pickup All Nearby" shortcut key wouldn't work if it included an interact key (e.g. Shift + E).
• Fixed a bug that caused wild animals to attack containers with food under certain conditions, even if they were allowed to eat from them.
• Fixed a bug where portals wouldn't be automatically pinned, even if "Allow Pinning Portal" was enabled.
• Fixed a bug where pins would remain on the map even after disabling automatic mapping in the configuration.

v1.4.2 [2023-03-12]

• Fixed a bug where the game won't start if some modules are disabled.

v1.4.1 [2023-03-11]

• Fixed a bug where the toggle key for automatic doors would become disabled after using it to turn off the function.
• Fixed a bug where the automatic mapping function would delete unrelated pins, such as pins added by users or boss pins.
• Fixed a bug where the automatic mapping function would cause an exception when loading the world without exiting the game after logging out of the world.
• Fixed a bug where the automatic door closing function would not work, causing the door to remain open.
• The "printobjects" command can now output doors and containers.
• Fixed a bug where the automatic repair function would cause an exception under certain conditions.
• Fixed a bug where the "Distance For Automatic Opening" configuration for automatic doors was not functioning and instead referenced "Distance For Automatic Closing."
• Modified the "Disable Module" item in the configuration to be more intuitive.
• Added "Hexagonal gate" to the door presets.

v1.4.0 [2022-12-26]

• Overall Rewriting
  • AutomaticDoor
    • Logic Improvements
  • AutomaticFeeding
    • A little refactoring
  • AutomaticMapping
    • Add Vehicle category
    • Portal pinning is now a stand-alone option, not in the Other category
    • Static object pins are no longer saved by default. They can be changed to be saved in the options
    • You can now hold down the left Shift key and click on a pin on the map to force the pin to change to save
    • Added option to automatically remove pins when destructible objects are destroyed. (probably won't work perfectly, so don't expect too much)
  • AutomaticMining
    • Limit the number of parts that can be damaged by automatic mining to a maximum of 3 at a time
  • AutomaticProcessing
    • Removed the option to limit crafting by the total number of items in a product, instead added an option to limit crafting by the number of product stacks
    • Added option to replenish material only when the material in the processor runs out
    • Added option to refuel only when the fuel in the processor runs out
    • Smelter's automatic crafting has been improved to process time-based quantities of material even when away from it for extended periods of time
  • AutomaticRepair
    • A little refactoring
• Added AutomaticPickup feature
• Custom objects have been renamed User-defined objects and moved to the General category of the Config
  • I have documentation on how to add user-defined objects, so please read through it if necessary
  • https://github.com/eideehi/valheim-automatics/blob/1.4.0/docs/add-user-defined-object.adoc
• Mistlands content has been added to the automation
• Added options to completely disable each feature
• Change the console command to take arguments like the CLI

v1.3.2 [2022-12-06]

• Rebuild for Mistlands Update
  • Content added in the Mistlands Update is not yet available for automation by Automatics

v1.3.1 [2022-11-13]

• Fix an error that occurred if ConfigurationManager was not installed
• Custom map icons can now be treated as child mod of Automatics
  • For details, refer to the "Directory structure" section of the README
• Add option to hide pin names on custom map icon
  • For details, refer to the "options" entry in the "Format of custom-map-icon.json" section of the README
• Add option to set the scale at which custom map icons appear on the map
  • For details, refer to the "options" entry in the "Format of custom-map-icon.json" section of the README

v1.3.0 [2022-04-26]

• Add the feature of 'Automatic Mining'
• Add option to change the directory to load resources such as translation files and custom icons
• Add option to change the position of the message displayed when enabling/disabling the automatic door function with a shortcut key
• Change so that the slider for handling floating decimals in the configurator increases or decreases the numerical value by 0.01 increments
• Reviewed and corrected the key names and descriptions in the configuration options
  • The configurations are automatically migrated, but be sure to check the values of the configurations after starting the game to be sure
• Rewrote most of the automatic mapping feature
  • Fix inability to apply custom icons with internal names to birds
  • Change the deposit pinning location to the center of the object
    • Due to this change, large deposits such as copper may be pinned in duplicate with existing pins
  • Add custom options for other objects, dungeons, and spots

v1.2.1 [2022-04-19]

• Change the automatic door to not work if there is an obstacle between the player and the door
• Change the minimum automatic door process interval to 0
  • Setting the value below 0.1 disables automatic opening or closing. The substantive minimum interval remains unchanged from 0.1
• Change so that the printnames command searches all translations
  • With this change, the printnames command can now take multiple arguments, allowing for more powerful filtering
  • See printnames usage for command details

v1.2.0 [2022-04-16]

• Change the format of the Cutom Map Icon settings file from csv to json
  • See "Format of custom-map-icon.json" for more information on json files
• Change translation files format from csv to json
• Fix 'Standing brazier' was omitted from 'Automatic Processing'
• Fix to be able to output names of fish, birds and dungeons with the 'printnames' command
• Fix a bug that prevented some config values from being read accurately

v1.1.2 [2022-04-14]

• Add command to output internal and display names
  • See "Console commands" in the README for details
• Add options to suppress automatic processing based on item count
• Add option to automatic refuel only when materials supplied
• Change 'Automatic Repair' not to work during game pauses
• Change 'Allow...(Custom)' options to evaluate for exact match if an internal name is specified, or partial match if a display name is specified
  • The "$enemy_boar" matches only "Boar", but "Greydwarf" matches "Greydwarf brute" and "Greydwarf shaman" in addition to "Greydwarf"
  • The same goes for TARGET for Custom Map Icon

v1.1.1 [2022-04-10]

• Fix package task of mod files for Thunderstore
• Fix a bug in which the 'Repair Pieces' function continued to work even though the 'Automatic Repair' feature was disabled in the configuration

v1.1.0 [2022-04-07]

• Add the feature of 'Automatic Feeding'
• Add the feature of 'Automatic Repair'
• Add option to allow automatic opening/closing for any door
• Fix a bug where the generated items would be lost if Smelter could not find the container when 'Automatic Store' was enabled
• Fix a bug where the honey to be set over the maximum if Beehive could not find the container when 'Automatic Store' was enabled

v1.0.6 [2022-04-04]

• Fix a bug that prevented automatic pinning of player existing in the open air under certain conditions, judging that they exist in the dungeon
• Add elements added in patch 0.207.20 to be the target for automatic pinning
• Change the maximum value of the container search range in 'Automatic Processing' to 64
• Change to remove pins added by automatic pinning when some veins are destroyed

v1.0.5 [2022-03-28]

• Add shortcut key to perform searches for static objects
• Add shortcut key to enable/disable automatic door
• Fix a bug that caused dynamic pins to remain on the map when auto-pinning was disabled from the config
• Change the initial value of the 'Automatic Map Pinning' configuration

v1.0.4 [2022-03-18]

• Fix a bug fish were not pinned
• Fix a bug that caused pins to be deleted at unintended times
• Fix a bug in which automatic pinning of ship was enabled regardless of the config value
• Add the feature to customize the icons of pins added by auto pinning
  • There are no custom icons bundled with Automatics, please add your own

v1.0.3 [2022-03-16]

• Fix a bug where tamed animals continue to be pinned
• Add options for users to add map pinning targets (animals, monsters, flora, veins, and spawners)
  • As a result, elements added by mods are no longer automatic pinning unless this option is used
• Add an option to allow ships to be automatic pinning
  • This is dynamic pinning, but unlike other dynamic pins, the pins is saved in the save data

v1.0.2 [2022-03-15]

• Improvement of FPS drop due to Automatic Map Pinning
  • In particular, FPS is greatly improved in areas with a lot of flora, such as farms
• Reduce the processing load on Automatic Door
• Add Portal to the Automatic Map Pinning target
  • Portal is added to 'Allow Pinning Other Objects'

v1.0.1 [2022-03-06]

• Fix a bug that prevented some Tar Pits from being pinning
• Fix a bug in which automatic map pinning of static objects causes a significant drop in FPS
• Fix logic for determining if a vein is in ground
• Change the Automatic Map Pinning process is not called when the game is paused
• Change Automatic Door options so that Open and Close can be specified separately

v1.0.0 [2022-01-23]

• Initial release