Multi User Chest

About

Allows multiple players to interact with the same chest at the same time.

Installation

This mod requires BepInEx and Jötunn. Extract all files to BepInEx/plugins/MultiUserChest

The mod must be installed on the server and all client. It is ensured that all players have the mod installed with the same mod version, otherwise no connection is possible.

Please report all errors and desyncs if they occur.

FAQ

• Who needs this installed?

  • The server and every player who joins it. You will be disconnected if there is a version mismatch or the mod is not installed somewhere.

• If two players move an item at the exact same time, will it be duplicated?

  • No, only one move will be accepted.

• How is item duplication/loss prevented?

  • An item will never exist twice. When an interaction is made inside a shared chest, the item is packed into a message and sent to the player currently managing the chest. This player instance then decides whether or not to move the item and sends the result back to the player who made the interaction.

• Can this be added to an existing game?

  • Yes, you can add and remove this mod at any time.

• Will this mod work with other modded chests?

  • Yes, most likely. But it can may cause problems if other mods change the behaviour of chests.

• Will this mod work with mods that change inventory/chest sizes?

  • Yes.

• Does it work with mods that add quick stacking / chest sorting?

  • Depends on the mod, see Incompatible Mods and Compatible Mods. If it's not listed there, assume it won't work.
  • Recommended is Quick Stack Store Sort Trash Restock by Goldenrevolver, as as it combines many quick stack features and provides explicit compatibility with Multi User Chest.

Confirmed Incompatible Mods

These mods cause desync with Multi User Chest and will not startup together

• QuickStore
• QuickStack
• SimpleSort

Compatible Mods

Here are some quick stack mods listed that are compatible with Multi User Chest. The version number indicates the tested version of the other mod, a different one may also work but isn't confirmed.

• Quick Stack Store Sort Trash Restock 1.3.10 (recommended quick stack mod, a higher version very likely works too)
• SmartContainers 1.6.4
• QuickDeposit 1.0.1
• DepositAnywhere 1.2.0
• Valheim Simple Auto Sort 1.0.7

Links

• Thunderstore
• Nexus
• Github
• Discord: Margmas. Feel free to DM or ping me about feedback or questions, for example in the Jötunn discord

Development

See contributing.

Changelog

See changelog.

Changelog

0.6.0

• Added a MUC_Ignore ZDO bool flag that other mods can set on containers ZNetViews to exclude them from interacting with Multi User Chest

0.5.10

• Uploaded without debugging context, which has slowed down the mod a lot

0.5.9

• Fixed issues with ships and carts caused by the 0.5.8 update

0.5.8

• Fixed issues when a player interacts with a chest while the owning player is teleporting away

0.5.7

• Fixed type warning about ItemDrawer when it's not installed

0.5.6

• Fixed a conflict with Backpacks where dropping an item from a backpack throws an error
• Fixed compatibility with ItemDrawers for dependent mods like ItemHopper where stack sizes were wrong and the drawer did not update correctly
• Fixed a potential item loss issue when another mod patches AddItem() to reject an item inconsistently between clients
• Removed some vanilla logging when adding an item to an inventory, to avoid clutter and slightly improve performance when many actions are done

0.5.5

• Compatible with Valheim version 0.217.22, not working with an older version
• Updated and compiled for BepInExPack 5.4.2200

0.5.4

• Fixed equipped items appear to be un-equipped when item preview shows an item in the player inventory, resulting in equipped items background flashing

0.5.3

• Updated for Valheim 0.217.14 (Hildir's Request), not compatible with older versions

0.5.2

• Removed QuickStack compatibility as the mod isn't updated for Valheim and threw a MUC error. The mods will no longer start together

0.5.1

• Updated for Valheim 0.216.9, not compatible with older versions

0.5.0

• Added item preview. This visually shows changes before all messages have been processed and improves the flow of interaction within a shared chest
• Changed internal messages and made general code improvements
• Fixed an issue where items could be lost when a player removes an item from a shared chest and the stack size has changed in the meantime

0.4.4

• Fixed a compatibility issue with OdinShipPlus. Some of the ships have multiple chests on board, these ships are excluded from MUC
• Fixed a compatibility issue with AdventureBackpacks where the backpack items could be duplicated

0.4.3

• Fixed distant containers could cause errors when other mods tried to access them. These containers have no player assigned (owner) responsible for managing their inventory and will be ignored by MUC

0.4.2

• Fixed an item duplication bug when a player moves a weapon/tool/armor item repeatedly in a shared chest

0.4.1

• Fixed an error when a player tries to place a chest

0.4.0

• Big internal rework for compatibility with other mods: instead of patching GUI methods, mainly inventory methods are patched and movement is intercepted when needed. This fixes desyncs with other mods greatly and removes a lot of specific compatibility code. While this doesn't make all quick stack mods compatible, it simplifies compatibility for the most ones.
• Added compatibility with Quick Stack Store Sort Trash Restock by Goldenrevolver
• Added compatibility with DepositAnywhere by Lookenpeepers
• Added debug files (MultiUserChest.dll.mdb) to the release, this will make finding future issues easier
• Changed that the mod is now always required on the server and the version check matches the exact version instead of only minor releases
• Fixed an item duplication bug when a player moved an item into a chest and fast enough elsewhere
• Fixed an item duplication bug with the take all action
• Fixed the last item stack could not be fast moved if a stack has space left
• Fixed a compatibility issue with EpicLoot while picking up the tombstone
• Fixed a compatibility issue with Equipment and Quick Slots when trying to throw an item out of a a quick slot

0.3.1

• Improved mod compatibility by loading items into a temporary inventory first
• Fixed item stack size modification from V+ was causing issues
• Changed chest inventory reload to be called after vanilla, this makes the inventory not break completely with OdinsQOL AutoStore feature. Nevertheless, both AutoStore and MUC are incompatible at this time

0.3.0

• Updated for Valheim 0.212.7 (Mistlands)
• Fixed that an item will not be deselected if the underlying chest reloads
• Fixed that a slot could stay blocked if the owner of the chest changes

0.2.4

• Fixed items from EIDF were not loaded correctly when fast moving them inside shared chests. They had to be picked up to show the extended item data again
• Improved performance of adding item to inventories by avoiding costly vanilla code

0.2.3

• Fixed item loss in high latency situations. This could occur when the receiving slot was occupied before the item was fully transferred. If items cannot be delivered, they are now dropped to the ground

0.2.2

• Added compatibility with SmartContainers

0.2.1

• Fixed an error that could occur when an item was moved while the player is spawning

0.2.0

• Added ability to making synced non-player interactions on chests possible. This will be the base for other mods I am working on
• Added BepInEx incompatibility for conflicting mods to prevent item issues. This means Multi User Chest will not start if any of the incompatible mods are installed
• Added Jotunn dependency for utilities
• Added enforcement of mod version if the mod is installed on the server
• Removed Container.IsInUse() patch to improve mod compatibility
• Removed custom file logger
• General improvements

0.1.6

• Fixed errors with Jewelcrafting

0.1.5

• Fixed the compatibility patch with Valheim Simple Auto Sort was always active, resulting in a harmony error

0.1.4

• Added compatibility with Valheim Simple Auto Sort

0.1.3

• Sync visual chest opening with other players
• Added compatibility with QuickDeposit and QuickStack

0.1.2

• Fixed item loss with EAQS quick slots on death, when inventory was full. Only fixes the interaction with both mods, not changing EAQS itself

0.1.1

• Fixed pickup items could be deleted when player inventory is full and item was switched or rejected by chest
• Fixed error with while placing ItemDrawers
• Removed alpha status of this mod

0.1.0

• Release