扩展玩家背包

一个独立的英灵神殿BepInEx模组，可扩展玩家背包行数（最多50行，默认20行），并内置滚动条和鼠标滚轮滚动支持。

已知问题与解决方法

[!NOTE] 首次打开时偶现空白网格:

• 症状在某些环境或大量模组配置下，加入世界、重生或加载到新区域后首次打开物品栏时，可能偶尔只显示木质背景面板，而物品槽不会立即渲染出来。
• 快速解决只需关闭（Tab 或 Esc）然后重新打开一次物品栏。这会强制界面布局同步，之后所有物品槽位、图形和滚动都会在你本次游戏过程中正常流畅地渲染。

功能

• 可配置的玩家物品栏行数（4 到 50 行）。
• 集成了维京风格滚动条。
• 鼠标滚轮与手柄导航支持。
• 完全独立：可配合或不配合 ValheimPlus 使用。

配置

配置文件已生成于 BepInEx/配置/ckforgame.ExpandedPlayerInventory.cfg 首次启动后：

• 物品栏行数：玩家物品栏行数（最小4，最大50，默认20）。
• 滚动灵敏度：鼠标滚轮滚动灵敏度（最小50，最大1500，默认350）。数值越高，滚轮移动越少即可滚动越快。
• 记住滚动位置： 打开物品栏时记住上次的滚动位置，而不是总是跳回顶部（默认 真实)。

与ValheimPlus的兼容性

[!IMPORTANT] 如果您正在使用 英灵神殿增强版，请确保 物品栏行数 在你的ValheimPlus配置中（瓦尔海姆plus.cfg) 设置为 4 （原版默认）或保留 [玩家] 物品栏扩展已禁用。

让ValheimPlus同时扩展背包行数会与本模组的滚动条定位和网格布局管理冲突。请使用 扩展玩家背包的配置，改为指定您想要的行数。

安装

• 使用 Mod 管理器（r2modman / Thunderstore）: 点击 用模组管理器安装.
• 手动安装:
  1. 安装 BepInExPack 英灵神殿.
  2. 提取 扩展玩家背包.dll 进入 <GameDirectory>/BepInEx/plugins/.

更新日志

• v1.2.0:
  • 功能：已添加 滚动位置记忆 (记住滚动位置，默认 真），让你在切换背包和搜刮箱子时保持滚动视图位置不变。
  • 功能动态分辨率与UI缩放适配（设置更改后自动重新计算布局，无需重启游戏）。
  • 可靠性：在物品安全纵深防御网中新增 人形生物.掉落无效物品 和 设置玩家背包容量 严格防止物品掉落或丢失。
  • 可靠性：通过程序化 UI 回退增强滚动条模板搜索。
  • 可靠性登出和进入世界时彻底重置会话状态。
• v1.1.0:
  • 功能： 新增可配置鼠标滚轮 滚动灵敏度 默认 350，范围 50–1500）以实现约5倍速的轻松滚动。
  • 功能: 将插件 GUID 和配置文件名标准化为 ckforgame.扩展玩家背包.cfg （自动从旧版配置迁移）。
  • 修复修复了 ValheimPlus 模组冲突，该冲突导致调整容器大小后首次打开时出现负视口高度并剔除物品槽位。
  • 修复修复了每局世界会话中仅在首次打开时严格限制开启同步，从而解决重复出现20行弹出或闪烁的问题。
  • 修复：添加了运行时布局故障保护机制，在 背包界面.更新 防止画布稳定期间物品图形被剔除。
• v1.0.4将裁剪延迟到动画过渡之后执行；修复了与ValheimPlus及其他背包模组的兼容性。
• v1.0.3：新增已知问题和临时解决方法文档；改进打开背包动画期间的画布和裁剪更新处理。
• v1.0.2修复了首次打开背包时格子偏移至屏幕外且不可见，直到重新打开才显示的渲染问题。
• v1.0.1：初始版本发布，包含独立滚动背包以及与 ValheimPlus 的兼容性指南。

鸣谢与特别感谢

• 瓦尔海姆增强版：特别感谢ValheimPlus项目及其贡献者为库存滚动和网格扩展机制提供的灵感与基础概念。

许可证

本项目采用 GNU 通用公共许可证 v3.0 授权 - 详见 许可 详细信息请查看文件。