【标题】
《瓦尔海姆》物品堆叠与重量分离优化 MOD 使用指南
【核心介绍】
重写并优化原「ItemStacks」模组,将物品堆叠与重量配置分离为独立文件,提升可读性、可维护性及服务器兼容性。
【安装指南】
1. 下载本 MOD 文件(含 `ItemStacksRewrite.dll` 及配置模板),来源:[Nexus Mods 页面]( 网址链接) 或 [GitHub 仓库]( 网址链接
2. 将 `.dll` 文件放入游戏根目录 `/BepInEx/plugins` 文件夹;
3. 首次加载世界时,MOD 会自动在 BepInEx 配置路径下生成新文件夹「ItemStacksRewrite」,其中包含分离的堆叠配置与重量配置文件;通用配置保留在基础 `config` 文件夹中;
4. 本 MOD 安装前,需同步安装前置依赖的 MOD「ServerSync」(由 Blaxxun 开发,用于服务器同步支持);
5. 所有配置文件均为自动生成,无需手动创建或编辑初始文件,缺一不可。
【功能详情】
✅ 已优化:
– 物品堆叠数量与重量参数完全分离,分别存于独立配置文件;
– 清理原始配置中无效条目(如 `Abomination_attack3` 等玩家无法获得的 AI 相关物品);
– 支持模组物品的可切换开关(启用/禁用后自动适配配置生效逻辑);
– 全面适配「ServerSync」,确保多人服务器中堆叠与重量设置一致;
❌ 未修改:
– 游戏原生物品栏界面、UI 布局、拾取动画等非配置类行为;
– 其他模组添加的物品默认堆叠规则(需对应模组作者适配本 MOD 接口);
✨ 额外调整:
– 首次加载世界即自动生成结构清晰的配置目录「ItemStacksRewrite」,避免单一大文件维护困难;
– 提供完整开源实现,便于社区审核与协作改进。
【使用要求】
– 必须安装 BepInEx 6.x(Valheim 推荐版本);
– 必须安装前置依赖 MOD:「ServerSync」;
– 适用于 Valheim 官方最新稳定版(v0.230+),不支持旧版存档直接迁移(建议新建世界初始化配置)。
【兼容性说明】
– 兼容范围:所有基于 BepInEx 的 Valheim MOD(只要不直接覆盖同一配置键或 Hook 冲突);
– 不兼容模组:直接修改 `ItemStacks` 原始配置结构的旧版衍生模组(如未更新的 fork 版本);
– 暂未推出专用兼容补丁。
【注意事项】
– ⚠️ 若在生成配置后禁用某模组物品,其配置条目仍保留在文件中,但不会生效;如需彻底清除,请删除 `ItemStacksRewrite` 文件夹并重新加载世界;
– ⚠️ 配置文件仅在首次加载世界时生成,后续修改需手动编辑对应 `.cfg` 文件;
– ⚠️ 本 MOD 为「ItemStacks」的独立重写,不继承原作者 MTNewton 的更新计划与责任归属;
– ⚠️ 若原作者回归并更新官方「ItemStacks」,本 MOD 将主动下架。
【更新日志】
– 2024 年 4 月 12 日 首发正式版,完成堆叠/重量分离、ServerSync 集成、无效条目清理;
– 2024 年 5 月 3 日 新增模组物品可切换开关逻辑,并优化首次生成提示机制。






猎人通讯频道 LIVE
通讯频道已加密
[ 系统检测 ] 您需要特工身份验证才能广播通讯指令