RunicInventoryFix

RunicInventoryFix

⚠️ 请先读：这不是 bug / Applicability Notice

中文：

这不是 bug。 Chazman-RunicInventory 和 JStack424-Stackmaster 两个模组本身都没有问题， 它们各自都完全按自己的设计正常工作。这只是两个独立开发的模组恰好都把 LeftAlt 选作了自己的 修饰键，属于「按键撞车」这种纯粹的巧合，不是任何一方的编码错误。

• 原模组作者不应被追责。 本补丁与 Chazman、JStack424 两位作者没有任何关系，

也没有经过他们的同意或审查。有问题请找我，不要去打扰原作者。

• 本补丁只在同时装了这两个模组、并且你在意 Stackmaster 那套 Alt+鼠标 手势时才有意义。

只装其中一个模组 ⇒ 根本不存在冲突，装本补丁纯属多余。

• 本补丁只做一件事：让 RunicInventory 的鼠标锁格手势不再拦截输入。

不改任何数值、不加任何功能、不碰存档格式。

• 这是一个取舍，不是「谁对谁错」：本补丁选择保留 Stackmaster 的手势、关掉 RunicInventory 的。

如果你的偏好相反，不要装本补丁，改成把 Stackmaster 的 Storage-action keybind 修饰键从 LeftAlt 换成别的键即可（两个模组的功能都能保住，见文末）。

• 上游任意一方之后若自行解决了这个撞车，请优先升级上游并停用本补丁。

English:

This is not a bug. Neither Chazman-RunicInventory nor JStack424-Stackmaster is defective — both work exactly as designed. Two independently developed mods simply happened to pick LeftAlt as their modifier key. It is a plain hotkey collision, not a coding error on anyone's part.

• The original authors should not be blamed. This patch is **unaffiliated with and

not endorsed by Chazman or JStack424. Report anything to me, not to them**.

• It only matters if you run both mods and care about Stackmaster's Alt+mouse gestures.

With only one of them installed there is no collision at all, and this patch is pointless.

• It does exactly one thing: stop RunicInventory's mouse lock gesture from intercepting input.

No values changed, no features added, no save format touched.

• This is a trade-off, not a verdict: it keeps Stackmaster's gestures and disables

RunicInventory's. If you prefer the opposite, do not install this — instead change Stackmaster's Storage-action keybind modifier away from LeftAlt (see the end of this page).

> 🤖 本模组的代码由 AI 生成（AI Generated），需求、验证与发布由人类完成。

---

它解决的是什么

两个模组都拿 LeftAlt 当修饰键，而 RunicInventory 的手势补丁点更靠上游：

InventoryGrid.OnRightDown          ← RunicInventory 补丁在这里（上游）
   └─ m_onRightClick 委托
        └─ InventoryGui.OnRightClickItem   ← Stackmaster 的 Alt+右键 挂在这里（下游）

RunicInventory 的补丁逻辑是：

// InventoryGridRightClickLockPatch.Prefix —— 补丁 InventoryGrid.OnRightDown
return !InventoryRuntime.TryTogglePointerLock(grid, handler);

只要 TryTogglePointerLock 返回 true，Prefix 就 return false ⇒ 原版 OnRightDown 整条不执行 ⇒ 它内部的 m_onRightClick 委托不会被调用 ⇒ 挂在下游的 Stackmaster 右键功能永远收不到调用（症状就是「静默失效」，连报错都没有）。

而 TryTogglePointerLock 在下列情况下都会返回 true：

| 情况 | 结果 | |---|---| | RequireLockState() 为假（锁功能不可用：尺寸不匹配 / 持久化状态对不上） | 返回 true ⇒ 掐断 | | Alt+右键没落在有效的背包格子上 | 返回 true ⇒ 掐断 | | 成功切换了锁定 | 返回 true ⇒ 掐断 |

⇒ 实际上「按住 Alt 在玩家背包上点右键」几乎必然掐断整条链路。

> 顺带澄清一个容易误判的点：RunicInventory 也补丁了 InventoryGui.OnSelectedItem > （Stackmaster 的 Alt+左键落点），但它的 InventoryRuntime.AllowSelectedAction > 是恒返回 true（IL 全文只有 ldc.i4.1; ret）⇒ 对左键不构成拦截。 > 也就是说按代码推演，被真正掐断的是 Alt + 右键，不是左键。

它是怎么修的

TryTogglePointerLock 在 RunicInventory 1.1.9 里只有一个调用点 （已用 member_refs_dll.py 反查确认），所以补这一个方法就够：

[HarmonyPatch(typeof(InventoryRuntime), "TryTogglePointerLock", ...)]   // 实际用反射定位
static bool Prefix(ref bool __result)
{
    __result = false;
    return false;                 // false = 不执行原方法
}

⇒ 该方法恒返回 false ⇒ RunicInventory 自己的 Prefix 算出 !false = true ⇒ 放行原版 ⇒ Stackmaster 的 OnRightClickItem / OnSelectedItem 都能正常收到调用。

为什么用 Prefix 跳过，而不是 Postfix 只改返回值（重要）

TryTogglePointerLock 在命中格子时会内部真的调用 ToggleLockAt 去切换锁定。 若只用 Postfix 改返回值，锁定依然会被切换（副作用已经发生）—— 而我们要的是「手势彻底关掉」。 Prefix 跳过原方法还顺带避免了它在「锁不可用 / 没点到格子」时弹出的 Notify 提示。

刻意保留、绝不触碰的部分

| 保留项 | 原因 | |---|---| | RunicInventory 键盘锁格键（默认 L + LeftAlt） | 它走 Plugin.Update → InventoryRuntime.Tick → KeyboardInput.ShortcutDown(ToggleLock) → ToggleFocusedLock，与本补丁的目标方法无关 | | RunicInventory 的额外装备行 / 整理 / 拾取过滤 / UI / 拓扑 | 全部不涉及本补丁的目标方法 | | Stackmaster 的 Alt+左键 / Alt+右键 | 这正是要救回来的 | | Stackmaster 的 Alt+E 存料、合成/建造取料 | 不受影响 |

配置

BepInEx/config/s6652289.RunicInventoryFix.cfg

| 项 | 默认 | 说明 | |---|---|---| | SuppressMouseLockGesture | true | 关掉 RunicInventory 的鼠标锁格手势。设 false = 本补丁什么都不做，冲突照旧 | | Verbose | true | 打印补丁安装与目标签名确认细节 |

> ⚠️ 开关不支持热切换：Awake 时读取一次，改了要重启游戏。

怎么看它生效了

日志（BepInEx/LogOutput.log）里搜 [Fix]：

[Fix] 已打补丁：RunicInventory.Integration.InventoryRuntime.TryTogglePointerLock → Prefix 恒返回 false（跳过原方法）
[Fix] 效果：RunicInventory 的『左Alt+右键』不再拦截 InventoryGrid.OnRightDown，
[Fix]       Stackmaster 的 Alt+左键 / Alt+右键 应恢复正常。
[Fix] 目标方法签名确认：Boolean TryTogglePointerLock(InventoryGrid, UIInputHandler)

关键判据：打开背包 → Alt + 左键 点物品 → 出现 Stackmaster: item protected. / Stackmaster: item unprotected. 提示 = 修好了。

若看到下面任一条，说明是环境问题而非补丁问题，本补丁不会做任何改动：

[Fix] 180 秒内没等到 RunicInventory.Integration.InventoryRuntime —— RunicInventory 可能没装或版本不匹配，本模组未做任何改动。
[Fix] 找到类型但没有 TryTogglePointerLock —— RunicInventory 版本不匹配，拒绝打补丁（本模组不做任何改动）。
[Fix] 目标方法签名不符（期望 实例方法 bool ...）—— 拒绝打补丁。

安装 / 卸载

• 安装：把 RunicInventoryFix.dll 放到 BepInEx/plugins/RunicInventoryFix/
• 卸载：删掉该目录
• 依赖：denikson-BepInExPack_Valheim + Chazman-RunicInventory。

不需要 Stackmaster 才能启动，但没装 Stackmaster 时本补丁没有意义。

• 纯客户端，不联网，不引用 RunicInventory.dll（全部走反射定位）

⇒ RunicInventory 没装或不兼容时本模组只是安静地不做事，不会导致启动失败。

如果你其实是想要相反的效果

不要装本补丁。改成在 Stackmaster 的 cfg 里把修饰键挪开：

# BepInEx/config/com.jstack424.stackmaster.cfg
# 默认：Storage-action keybind = E + LeftAlt
Storage-action keybind = E + LeftControl

Stackmaster 的这一个值同时驱动 Alt+E（存料）、Alt+左键（保护物品）、Alt+右键 ⇒ 改成 LeftControl 就整体挪开，两个模组的功能都能保住（代价是 Stackmaster 的组合键从 Alt 变 Ctrl）。

源码

D:\WorkBuddy\RunicInventoryFix\（本地工作区）

已知边界