Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
StackmasterFix
[AI-generated] Client-only patch for Stackmaster: its expedition-kit shortcut (Alt+click a build piece) took materials from a detached snapshot, so chests were never debited (item duplication). Redirects the withdrawal to the live container.
CHANGELOG
Changelog
1.1.0
剔除冗余功能:上游 Stackmaster 1.1.5 已自行修好「合成/升级不扣料」,本补丁不再介入那一半。
- 依据(只读上游源码 + 官方包 metadata 核对):
- 1.1.5 changelog 首条声明该修复,并写明已在游戏内验证
(
prepared withdrawals are recaptured from each selected owned Container.GetInventory() rather than from detached ZDO inventory snapshots …)。 NearbyResources.cs:1288取Container.GetInventory()活库存,:1294-1313用它重建mutableHandle与runtimeStacks⇒ 执行期对象就是活库存;:1673-1681另有ReferenceEquals(runtime.Inventory, runtime.Container.Container.GetInventory())的 fail-closed 身份校验(注释直指 "grants a free crafted item"),并配ExactResourceDebit精确账本与逆序回滚。- ⇒ 本补丁针对
ExecuteWithRollback的 transpiler 已退化为恒等替换,属纯冗余。
- 1.1.5 changelog 首条声明该修复,并写明已在游戏内验证
(
- 移除:
ExecuteWithRollback的 transpiler + 写回 postfix 分支、FixCraftingFromStorage配置项、以及NearbyResourceService的类型查找。 DLL 内已确认FixCraftingFromStorage与ExecuteWithRollback零引用。 - 保留:
ExpeditionKitAction.ExecuteAtomic(远征包)。1.1.5 没有修这条路径 —— 它仍走CaptureForExpedition → Discover(…, resourceReadOnly: true)的 detached ZDO 快照, 而 crafting 专用的TryCaptureOwnedPlan/mutableCapture从未被它调用。故这一半原样保留。 - 依赖:
JStack424-Stackmaster1.1.4 → 1.1.5(不升会让 r2modman 要求把已升的上游降回去)。 - 日志改进:transpiler 不再拿「指令总数」当方法指纹(上游一改 IL 就会退化成
未知方法(指令数 N),纯误导),改用 Harmony 注入的__originalMethod直接取方法名。 - 阈值变化:
FixExpeditionKit=false时补丁不再尝试挂载,直接打日志说明并退出(等同于未安装)。
DLL 重新编译:16,896 字节,sha256 da4e8133d5e5b8ef991cc6f366f8e64ed31022d1d02bd27b0f497c8af1f5342e。
1.0.0
- 首个版本。修复上游
JStack424-Stackmaster1.1.4 的「用箱子材料合成/升级不扣料(复制)」问题。 - 根因:Stackmaster 为了「不拿所有权也能读箱子」,把容器的序列化库存从 ZDO 解进一个
临时 Inventory(
new Inventory(true),ContainerHandle.ResourceInventory), 但写入路径复用了同一个 capture ⇒ExecuteWithRollback实际是扣在只读副本上。 临时 Inventory 永不触发Inventory.Changed()⇒ 不会调用Container.Save()⇒ ZDO 里材料一点没少,而模组的自检在同一个副本上量差值必然判定成功 ⇒ 玩家白拿成品。 - 修法:transpiler 把写入方法里的
RuntimeResourceStack.get_Inventory/get_Item整体重定向到真实容器的活库存与活物品对象;事务成功后强制Container.Save()+ZDOMan.ForceSendZDO。拿不到安全写入权时 fail-closed(取消操作,不放行复制)。 - 覆盖:
NearbyResourceService.ExecuteWithRollback(合成/升级/建造)与ExpeditionKitAction.ExecuteAtomic(建造菜单 Alt+左键拉取远征包)。 - 实测(2026-09-19):修复后逐笔扣减量与配方需求精确吻合
(建造 20/10/2 = 32、合成 −3、另一组 4/1 = 5),且合成事务内首次出现
Container.OnContainerChanged与Container.Save(修复前为 0 条)。 - 配置项:
FixCraftingFromStorage、FixExpeditionKit、Verbose(均默认开)。