Install with Gale
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
Sitemote to dump your inventory into chests (and dodge roll to get up quickly again)
- For example, with a xbox controller you can use D-Pad down to execute the
- Automatically put dropped items in nearby containers
- Automatically sort containers
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. |