储物魂导器

🔮 中文

2025.12.17：

• 经过一个多星期的测试，以及Bug修复，体验优化，现首个正式版发布

• 优化：通过鼠标左键将物品收入储物魂导器的功能将不会再影响物品的价格设置。

• 优化：现在可以在任意界面打开和关闭储物魂导器，不会影响游戏原本的功能，你甚至可以在机器面前一边看菜单配料一边打开你的储物魂导器拿东西然后点一键制作。

• 优化：现在可以通过ESC，B键，鼠标下侧键开启和关闭储物魂导器，极端情况下也不会触发背包锁定和鼠标锁定。

• 修复了从储物魂导器中拿出东西之后未保存直接退出游戏后，下一次进入游戏该物品会从储物魂导器中消失的Bug。

• 修复了特殊情况下使用右上角的x关闭储物魂导器面板的时候背包会锁定的Bug。

• 修复了从储物魂导器中拿出工具后，使用一次，再存放入储物魂导器，在未保存的情况下退出游戏再重新进入游戏的情况下，储物魂导器会出现两把耐久度只差1的工具的Bug

• API：在LanVoidPouch 类中新增了GetItemAmountInSlot 方法，其他的Mod开发者可以通过反射调用该方法获取一个物品存在于储物魂导器中的数量。

• API：在LanVoidPouch 类中新增了HasItemInSlot 方法，通过反射调用可以获取到储物魂导器中是否存在一件物品。

• API：在LanVoidPouch 类中新增了DecreaseItemInSlot 方法，通过反射调用可以从储物魂导器中取出一样物品（需要您自己将物品给到玩家）。

• API：在LanVoidPouch 类中新增了FindBySaveNameAndMapNameAndItemSoId 方法，通过反射调用可以拿到特定物品的列表。

• API：在LanVoidPouch 类中新增了FindBySaveNameAndMapName 方法，可以拿到储物魂导器内所有当前有效物品的列表。

2025.12.13：

• 略微提升了储物魂导器的面板性能。

• 修复了点击右上角的x关闭面板后，背包卡住，需要按ESC解锁的问题bug。

• 修复了在储物魂导器面板中点击图标的下半部分会跳到下一行按钮的bug。

2025.12.12：

• 修复了此前一直存在但是没办法修的Bug：进入储物魂导器之后第一次取出的物品是魂导器中完全随机的物品的Bug。
• 修复了在某些非常特殊的情况下关闭面板鼠标不解锁，需要手动按ESC的问题。
• 新增物品数量统计，现在您将鼠标对准物品之后，您可以在面板的左上方看到这件物品在储物魂导器中存储的数量，用箱子装的物品会统计箱子数量，没装满一箱的按照一箱来算。不用箱子装的物品直接统计其存入储物魂导器中的数量。
• 新增背包锁定，即打开储物魂导器的时候，滚轮将不会再切换背包格子，避免背包散乱。

2025.12.11：

• 修复使用堆叠类Mod之后导致鱼笼、钓鱼奖杯、地毯等物品无法被正确放入储物魂导器的BUG。
• 优化使用体验：现在您也可以使用鼠标侧键4号键（鼠标回退键）开启和关闭储物魂导器面板，并且在储物魂导器面板开启的时候可以点击鼠标右键关闭它，在储物魂导器面板处于打开状态时，鼠标左键不会再将您面前的物品放入储物魂导器中。
• 热键修改：原本您可以使用G键将背包的物品放入储物魂导器，但是该热键与钓鱼传送点Mod冲突，现在改成C键将背包物品放入储物魂导器，原有的左键功能不变。

✨ 功能说明

背景

无论是100格超大号背包也好，20个地窖也罢，本质上都还是把东西放身上和放地图上的区别，该卡还是会卡，并且这个游戏优化很差，甚至第一年的冬天都还没过，我的RTX 4080 + 13600KF + 32G内存就已经能感觉到游戏明显变卡了，而且我并不习惯用超大号背包，太占屏幕空间了，到现在为止我还是用的11格背包，不够装，根本不够装，去挖一次矿可能只能扫荡半个地图，背包就满了，而且地窖，工坊放置的物品太多，非常杂乱，于是我就一直想着做一个虚空储物箱，于是，无论是东方还是西方都有的四维空间带就在我的超大脑洞下，成功做出来了，虽然只是测试版，但是写完这个之后真的已经燃尽了，至少一个月不想碰C#代码。

⚠️ 警告

此Mod需要依赖前置Mod：轮椅牧场，该Mod的dll文件需要与轮椅牧场的dll文件放在同一个文件夹下才能被正常加载，不要拆开放置。

WheelchairRanch | Thunderstore - The Old Market Simulator Mod Database

Mod功能

此Mod提供了游戏卡顿的一种解决方案：

• 您可以通过C键将您手上的物品存放到储物魂导器中。
• 您可以通过鼠标左键，将您对准的物品存放到储物魂导器中。
• 您可以通过键盘的B键，打开您的储物魂导器，点击物品图标，就能够将物品从储物魂导器中转移到您的背包里面。
• 地窖雇员会优先从储物魂导器中补货，表现形式是地窖雇员从虚空中直接拿出需要补货的商品，然后将商品放置到货架上（多人游戏时需要主机安装此Mod才会生效），对于鱼类、雕像、武器等不生效，您仍然需要将这些物品存放在地窖中，使用ice_box_studio的Mod进行自动补货。
• 建议您除了鱼类、肉块、武器、雕像之外的东西，尽可能放入储物魂导器，降低游戏的资源压力，减少卡顿。
• 这是我写过的最复杂的Mod，没有之一，并且该Mod还处于早期测试阶段，也未经过多人游戏的测试，可能会有Bug，如果有Bug，欢迎通过我的邮箱反馈： [email protected]

📦 技术细节

• 修改：
  1. 通过复制和修改码头订单的UI界面制作了储物魂导器的UI页面，并且自定义了简易按钮，因此并不好看。
  2. 通过Hook游戏内的背包类PlayerInventory 实现了将物品转换为特定几种属性并且存入数据库的功能。
  3. 通过Hook游戏内的补货NPC逻辑类RestockerWait 实现了自定义地窖雇员NPC补货逻辑，让NPC能够直接从房主的储物魂导器中补货。
• 兼容性：未发现与其他Mod冲突。

🛠️ 安装指南

1. 下载 Lan-VoidPouch-1.3.0.zip
2. 解压至 Old Market Simulator 游戏的根目录

VoidPouch

🔮 English

2025.12.17:

• After more than a week of testing, bug fixes, and experience optimizations, the first official release is now live.

• Optimization: The feature that allows you to store items into the VoidPouch by left-clicking no longer interferes with item price settings.

• Optimization: You can now open and close the VoidPouch from any in-game interface without disrupting core game functionality. For example, you can view a machine’s recipe menu while simultaneously opening your VoidPouch to retrieve ingredients and then click “Craft All” seamlessly.

• Optimization: The VoidPouch can now be toggled open or closed using the ESC key, the B key, or the mouse side button. Even in edge cases, this will not trigger inventory lock or mouse lock.

• Fixed a bug where items taken from the VoidPouch would disappear from it upon rejoining the game if the game was exited without saving after removal.

• Fixed a bug where closing the VoidPouch panel using the top-right “X” button under certain conditions would cause the inventory to become locked.

• Fixed a bug where, if you took a tool from the VoidPouch, used it once, put it back, and then exited the game without saving, rejoining would result in two nearly identical tools (with durability differing by 1) appearing in the VoidPouch.

• API: Added a new method GetItemAmountInSlot to the LanVoidPouch class. Other mod developers can use reflection to call this method and retrieve the quantity of a specific item stored in the VoidPouch.

• API: Added a new method HasItemInSlot to the LanVoidPouch class. Mod developers can use reflection to check whether a specific item exists in the VoidPouch.

• API: Added a new method DecreaseItemInSlot to the LanVoidPouch class. Via reflection, this method allows removing one unit of an item from the VoidPouch (you are responsible for delivering the item to the player yourself).

• API: Added a new method FindBySaveNameAndMapNameAndItemSoId to the LanVoidPouch class. Using reflection, mod developers can retrieve a list of specific items matching save name, map name, and item SO ID.

• API: Added a new method FindBySaveNameAndMapName to the LanVoidPouch class. This method returns a list of all currently valid items in the VoidPouch for the given save and map context.

2025.12.13:

• Slightly improved the performance of the VoidPouch panel.
• Fixed a bug where clicking the 'X' in the top-right corner to close the panel would cause the backpack to become stuck, requiring pressing ESC to unlock it.
• Fixed a bug where clicking the lower half of an icon in the VoidPouch panel would jump to the button on the next line.

2025.12.12:

• Fixed a long-standing bug that was previously difficult to resolve: the first item retrieved from the VoidPouch was a completely random item from within it.
• Fixed an issue where, under certain very specific circumstances, the mouse would remain locked after closing the panel, requiring manually pressing ESC to unlock it.
• Added item quantity statistics. Now, when you hover the mouse over an item, you can see the quantity of that item stored in the VoidPouch displayed in the top-left corner of the panel. For items stored in crates, the number of crates is counted (partially filled crates are counted as one crate). For items not stored in crates, the actual quantity stored in the VoidPouch is displayed directly.
• Added backpack locking. When the VoidPouch is open, scrolling the mouse wheel will no longer switch between backpack slots, preventing clutter in the backpack.

2025.12.11:

• Fixed a bug where items such as fish traps, fishing trophies, and rugs could not be correctly stored into the VoidPouch when using stacking-related Mods.
• Optimized user experience: You can now also use Mouse Side Button 4 (the mouse back button) to open and close the VoidPouch panel. Additionally, you can close the panel by right-clicking when it is open. While the VoidPouch panel is open, left-clicking will no longer store the item in front of you into the VoidPouch.
• Hotkey change: Previously, you could use the G key to store items from your backpack into the VoidPouch. However, this hotkey conflicted with the Fishing Teleport Mod. It has now been changed to the C key for storing backpack items into the VoidPouch. The original left-click functionality remains unchanged.

✨ Feature Description

Background

​ Whether it's a 100-slot oversized backpack or 20 cellars, essentially it's still the difference between carrying items on your person or placing them on the map. Lag will still occur. Moreover, this game is poorly optimized. I hadn't even passed the first winter when my RTX 4080 + 13600KF + 32GB RAM setup could already feel the game noticeably lagging. Also, I'm not accustomed to using oversized backpacks; they take up too much screen space. To this day, I still use an 11-slot backpack. It's not enough space, simply not enough. Going on one mining trip might only allow me to clear half a map before the backpack is full. Furthermore, cellars and workshops become extremely cluttered with too many placed items. Therefore, I've always wanted to create a void storage chest. Thus, drawing inspiration from the concept of extra-dimensional space pouches found in both Eastern and Western lore, I successfully created one under my massive burst of creativity. Although it's only a beta version, I am truly burnt out after finishing this and don't want to touch C# code for at least a month.

⚠️ Warning

This Mod requires the prerequisite Mod: Wheelchair Ranch. The DLL file of this Mod needs to be placed in the same folder as the DLL file of Wheelchair Ranch to be loaded correctly. Do not place them separately.

WheelchairRanch | Thunderstore - The Old Market Simulator Mod Database

Mod Functionality This Mod provides a solution for game lag:

• You can press the C key to store the item in your hand into the VoidPouch.
• You can use the Left Mouse Button to store the item you are aiming at into the VoidPouch.
• You can press the B key on your keyboard to open your VoidPouch. Clicking on an item's icon will transfer that item from the VoidPouch to your backpack.
• Cellar employees will prioritize restocking from the VoidPouch. The visual representation is the cellar employee directly taking the needed restocking goods from the void and placing them on the shelves (in multiplayer games, this only takes effect if the host has this Mod installed). This does not work for fish, statues, weapons, etc. You still need to store these items in the cellar and use Mods like ice_box_studio's for automatic restocking.
• It is recommended that you put as many items as possible, except for fish, meat chunks, weapons, and statues, into the VoidPouch to reduce the game's resource pressure and decrease lag.
• This is the most complex Mod I have ever written, bar none. Furthermore, this Mod is still in early beta testing and has not been tested in multiplayer. There may be bugs. If you encounter any bugs, feel free to provide feedback via my email: [email protected]

📦 Technical Details

• Modifications:
  1. Created the VoidPouch UI page by copying and modifying the UI interface of the dock orders, and customized simple buttons, so it is not aesthetically pleasing.
  2. Implemented the function to convert items into specific properties and store them in the database by hooking into the in-game backpack class PlayerInventory.
  3. Implemented custom cellar employee NPC restocking logic by hooking into the in-game restocker NPC logic class RestockerWait, allowing NPCs to restock directly from the host's VoidPouch.
• Compatibility: No conflicts with other Mods have been discovered.

🛠️ Installation Guide

1. Download Lan-VoidPouch-1.3.0.zip
2. Extract it to the Old Market Simulator game's root directory.