You are viewing a potentially older version of this package. View all versions.
ArgusMagnus-ServersideQoL_AutoStore-2.5.1 icon

ServersideQoL AutoStore

Automatically put dropped items and items in player inventories into nearby containers

Date uploaded a day ago
Version 2.5.1
Download link ArgusMagnus-ServersideQoL_AutoStore-2.5.1.zip
Downloads 450
Dependency string ArgusMagnus-ServersideQoL_AutoStore-2.5.1

This mod requires the following mods to function

ArgusMagnus-ServersideQoL-2.5.1 icon
ArgusMagnus-ServersideQoL

Serverside-only QoL mod, compatible with vanilla/console (e.g. XBox, PS, Switch) clients. Stack player inventories into chests, generated portal hub, auto-sort chests, refuel smelters from containers, infinite building/farming stamina and much more

Preferred version: 2.5.1

README

Serverside QoL

This mod adds some QoL features as a serverside-only mod.

It's designed and tested for dedicated servers with vanilla/console clients (e.g. XBox/PS/Switch users).

If you'd like to support me, subscribe as a test user. You can help by testing the beta versions on hexium.

Features

  • Stack player inventory into nearby containers
    • For example, with a xbox controller you can use D-Pad down to execute the Sit emote to dump your inventory into chests (and dodge roll to get up quickly again)
  • Automatically put dropped items in nearby containers
  • Automatically sort containers

Other ServersideQoL mods

Documentation

The best available documentation is the config file. Read the description of the config options for a better idea of how this mod works.

Feature Requests

If you have an idea you think might fit this mod, you can create a feature request issue in the github project. If a similar request already exist, you can add a 👍 reaction to it.

Known Issues

Known issues are listed in the github project. If you experience an issue, please file a report there or on the hexium mod page.

Configuration

The configuration is loaded from BepInEx/config/ArgusMagnus.ServersideQoL.AutoStore.cfg. Start the server once to generate the file if it does not exist.

AutoStore
Option Default Value Acceptable Values Description
Enabled true True/False Enables/disables the entire mod
AutoSort true True/False True to auto sort container inventories
SortedMessageType None None, TopLeftNear, TopLeftFar, CenterNear, CenterFar, InWorld Type of message to show when a container was sorted
AutoPickup true True/False True to automatically put dropped items into containers if they already contain said item
AutoPickupRange 64 Required proximity of a container to a dropped item to be considered as auto pickup target.
Can be overridden per chest by putting '<AutoPickupRangeSignPrefix><Range>' on a chest sign, e.g. '🧲16'.
For example, '🧲0' will disable auto pickup/stacking from player inventory into that chest.
Only works with automatic chest signs added by the ServersideQoL.ContainerSigns mod.
AutoPickupRangeSignPrefix 🧲 Requires the ServersideQoL.ContainerSigns mod.
The prefix used to identify the container specifc auto pickup range value in chest sign text.
AutoPickupMaxRange 64 Requires the ServersideQoL.ContainerSigns mod.
Max auto pickup range players can set per chest (by putting '<AutoPickupRangeSignPrefix><Range>' on a chest sign).
AutoPickupMinPlayerDistance 4 Min distance all players must have to a dropped item for it to be picked up
AutoPickupExcludeItemTypes Ammo, AmmoNonEquipable, Bow, Chest, Consumable, Fish, Helmet, Legs, Material, Misc, OneHandedWeapon, Shield, Shoulder, Tool, Torch, Trinket, Trophy, TwoHandedWeapon, TwoHandedWeaponLeft, Utility Item types which will be excluded from auto pickup
AutoPickupExcludeFodder true True/False True to exclude food items for tames when tames are within search range
AutoPickupRequestOwnership true True/False True to make the server request (and receive) ownership of dropped items from the clients before they are picked up. This will reduce the risk of data conflicts (e.g. item duplication) but will drastically decrease performance
PickedUpMessageType InWorld None, TopLeftNear, TopLeftFar, CenterNear, CenterFar, InWorld Type of message to show when a dropped item is added to a container
ShowContainerModifiedEffect true True/False True to show an effect when a container is modified due to auto pickup or player inventory stacking
SuppressContainerModifiedEffectSound false True/False True to suppress the sound of the container modified effect when ShowContainerModifiedEffect = true
StackInventoryIntoContainersEmote Sit -1, -2, Wave, Sit, Challenge, Cheer, NoNoNo, ThumbsUp, Point, BlowKiss, Bow, Cower, Cry, Despair, Flex, ComeHere, Headbang, Kneel, Laugh, Roar, Shrug, Dance, Relax, Toast, Rest, Vibe, LoveYou, Count Emote to stack inventory into containers.
If a player uses this emote, their inventory will be automatically stacked into nearby containers.
The rules for which containers are used are the same as for auto pickup.
-1 to disable this feature, -2 to use any emote as trigger.
For example, on xbox you can use D-Pad down to execute the Sit emote.
If you use emotes exclusively for this feature, it is recommended to set the value to -2 as it is more reliably detected than specific emotes, especially on bad connection/with crossplay.
StackInventoryIntoContainersExcludeItemTypes Ammo, AmmoNonEquipable, Bow, Chest, Consumable, Fish, Helmet, Legs, Material, Misc, OneHandedWeapon, Shield, Shoulder, Tool, Torch, Trinket, Trophy, TwoHandedWeapon, TwoHandedWeaponLeft, Utility Item types which will be excluded from stacking into containers via emote
StackInventoryIntoContainersReturnDelay 1 From 1 to 10 Time in seconds after which items which could not be stacked into containers are returned to the player.
Increasing this value can help with bad connections.

CHANGELOG

v2.5.1

  • Minor fixes and optimizations

v2.1.0

  • Added option AutoPickupRangeSignPrefix #270
  • Added option SuppressContainerModifiedEffectSound

v2.0.14

  • Added option AutoPickupExcludeItemTypes to exclude certain item types from auto pickup #232
  • Added option StackInventoryIntoContainersExcludeItemTypes to exclude certain item types from stacking into nearby containers #232
  • Added option ShowContainerModifiedEffect to show an audiovisual effect when a container is modified due to auto pickup or player inventory stacking #208

v2.0.11

  • Moved AutoPickupMaxRange config option from ContainerSigns to AutoStore
  • Support for the new core options UnifiedConfig and ConfigPerWorld

v2.0.8

  • Bugfixes

v2.0.0

  • Initial release