L4zerShark_Team-AzuAutoStorePerformance icon

AzuAutoStorePerformance

~4x Faster Storage Scans, ~75% less scan time with large exclusion groups. Same storage rules, priorities, ranges, timers and item-transfer behavior. Requires AzuAutoStore.

Last updated 14 hours ago
Total downloads 279
Total rating 1 
Categories Mods Tweaks Server-side Client-side Utility Deep North Update
Dependency string L4zerShark_Team-AzuAutoStorePerformance-1.0.8
Dependants 1 other package depends on this package

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2351 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.

Preferred version: 5.4.2351
Azumatt-AzuAutoStore-3.1.4 icon
Azumatt-AzuAutoStore

Automatically store and deposit items from your inventory or ground into nearby chests and containers. Chest management, hotkey support, quick stack, auto-pickup, favorites, ItemDrawers, backpacks, WardIsLove, ward protection.

Preferred version: 3.1.4

README

AzuAutoStore Performance

~4× Faster Storage Scans

Measured with large item-group exclusion rules; see the scan timings below.

Same storage behavior, faster item-group checks. Your storage rules, priorities, ranges, scan timers, favorites, access checks and item transfers keep their existing behavior. The addon removes repeated group-copying work during storage checks.

Requires the original AzuAutoStore by Azumatt. This is an optional performance addon with its own DLL.

What improves

AzuAutoStore can copy an entire item group into a temporary list for each membership check. This addon checks the existing group directly, avoiding that copy and the usual linear search.

Exclusions, includeOverride priority, exact item-name comparisons and live configuration changes retain their original behavior. The addon leaves transfer handling, chest access, ownership, favorites, range and scan intervals in AzuAutoStore's control.

Large groups checked against many items benefit most. Explicit overrides that already skip group checks have little work for this addon to remove.

Measured performance

Storage scan times with AzuAutoStore 3.1.4 on Valheim 1.0.16:

Original versus performance addon: 3.93x speedup and 74.6% less scan time; 4.15x and 75.9%; 4.05x and 75.3%. Measured milliseconds shown.

Each pair of bars uses its original scan time as 100%. Labels show measured milliseconds, speedup and the percentage of scan time saved. Speedup is original time divided by addon time. Lower scan time is better; higher speedup is better.

Test scene Original scan With addon
8 chests, 20 drops 4.99 ms 1.27 ms
40 chests, 100 drops 133.10 ms 32.08 ms
100 chests, 200 drops 679.75 ms 167.91 ms

These are median times from seven measurements per mode. Each chest used a 1,501-item exclusion group, with all dropped items in range and excluded. The figures measure storage scanning only.

This is a deliberately heavy rule scenario. It demonstrates reduced scan cost, not a promise of the same improvement in every world or a percentage increase in game FPS. The largest scene can still hitch with the addon. Remote network latency was not measured.

AzuAutoStore 3.1.6 showed similar improvements in the same three scenes: 4.82 to 1.34 ms, 132.42 to 33.77 ms, and 672.80 to 172.36 ms respectively.

Requirements and installation

  • BepInExPack Valheim 5.4.2351.
  • Official AzuAutoStore 3.1.4 from Thunderstore, or 3.1.6 from Hexium.

The package declares AzuAutoStore 3.1.4 as its minimum dependency. The official 3.1.6 build is also supported; the addon's build check still applies to other versions.

Install the original mod first, then import this ZIP as a local mod in your mod manager. For manual installation, copy its BepInEx folder into the game/profile folder containing BepInEx.

Install the addon on the clients that should benefit. Ground scans require a local player, so adding it only to a dedicated server will not improve client scan time. Keep the original AzuAutoStore version consistent with your server's requirements.

No new configuration is needed. Removing this addon's DLL restores the original lookup behavior. Existing AzuAutoStore configuration files remain in use.

Only the supported official DLL builds are enabled. An unrecognized build produces an “addon inactive” warning and uses AzuAutoStore's original behavior.

Related upstream fixes

The author's newer release includes full-chest log-spam and delayed multiplayer-transfer fixes introduced in 3.1.5. See the upstream releases. This addon addresses group lookup performance and does not backport those separate fixes into 3.1.4.

Credits

AzuAutoStore is by Azumatt. Performance addon by L4zerShark. The package contains the addon only; install AzuAutoStore separately.