Terramods - 简易模组管理器

Terramods - 简易模组管理器

Terramods 是由 R4V9N1 创建的轻量级 Windows Valheim 模组管理器。它将 Thunderstore 和 Nexus Mods 连接到一个桌面应用程序中,同时保持安装和更新决策明确。

1.1.4 - 2026-09-14

  • 在权威构建和发布流水线中添加了一流的 Thunderstore 上传包
  • 现在每个打包发布都会生成 Terramods-<version>-thunderstore.zip,其中包含根级的 manifest.jsonREADME.mdCHANGELOG.mdicon.png 以及 Windows 安装可执行文件。
  • 添加了 Thunderstore manifest 生成,具有稳定的包名 Terramods、与应用程序匹配的语义版本、空依赖列表以及独立应用描述。
  • 添加了验证,确保 Thunderstore 图标恰好为 256x256 PNG,并且所有必需的包文件都位于 ZIP 根目录。
  • 将 Thunderstore 包的 SHA-256 添加到构建证据、结果 JSON、SHA256SUMS.txt 以及已发布的发布工件中。
  • 添加了专注于 Thunderstore 的 README,说明 Terramods 是一个独立的 Windows 应用程序,应通过 Manual Download(手动下载) 运行安装可执行文件来进行安装。

1.1.3 - 2026-09-14

  • Details(详情) 选项卡的选定模组文本中移除了多余的插件组件报告。
  • 模组详情现在只显示一次名称、作者、版本、包/提供程序状态、GUID、路径和配置数量,而不再在下面重复相同的组件标识。
  • 组件元数据仍在内部用于扫描、配置归属和更新逻辑;仅移除了 Details 选项卡中重复的渲染。
  • 添加了一个回归测试,防止 BuildModDetails 再次追加 ActivityReports.Components(mod)

1.1.2 - 2026-09-14

  • 清理了 Details(详情) 选项卡,使其仅显示所选模组的详情。
  • 从模组 Details 选项卡中移除了 BepInEx/Jotunn 状态文本、框架修复按钮、Valheim 状态/路径文本和安装流程文本。
  • 修复了 Shared setups 中 Save / share(保存/分享)Load profile(加载配置文件) 按钮的裁剪问题,方法为增加顶部控件行和垂直间距。
  • 为简化后的 Details 选项卡和未裁剪的 Shared setup 控件添加了 UI 回归测试。

1.1.1 - 2026-09-14

  • 安装程序现在会检测现有的 Terramods 安装,并在安装了较旧版本时显示 Update Terramods(更新 Terramods)
  • 重新安装相同版本会显示为 Repair Terramods(修复 Terramods)
  • 安装程序拒绝覆盖较新的 Terramods 版本进行安装,从而防止意外降级。
  • 改进了 Inno Setup 6 编译器发现机制,适用于每用户安装、PATH 安装、标准 Program Files 安装和卸载注册表安装。

1.1.0 - 2026-09-14

  • 在 Thunderstore 之外添加了真正的 Nexus Mods GraphQL v2 支持。
  • 添加了独立的提供程序健康/更新检查,并采用提供程序中立的最高较新候选选择。
  • 添加了精确的提供程序身份持久化以及 Nexus 模组/文件绑定,不进行无人值守的模糊跨提供程序匹配。
  • 添加了安全的通用 Valheim/BepInEx ZIP 安装,具有暂存、路径/重解析点保护、配置保留、备份、SHA-256 验证和回滚。
  • 添加了在 Nexus 游戏文件写入之前进行精确的 Nexus MD5 fileHash 验证。
  • 添加了提供程序感知的共享配置文件,同时保持 1.0.0 JSON 兼容性。
  • 添加了 Browse Thunderstore 和 Browse Nexusmods 控件以及独立的 Nexus 状态。
  • 添加了 Windows ZIP shell 操作 Install with Terramods,使用 --install-zip,且不接管默认 ZIP 关联。
  • 活动视图现在仅显示最新三条记录,同时保留完整日志;双击可在 Notepad 中打开不可变的完整详情。
  • 压缩了共享配置文件控件和行。
  • 为 Nexus、提供程序选择、状态兼容性、归档安全性和最终集成契约添加了确定性的离线测试。
  • 扩展了权威构建,加入 -Package-ResultPath、自包含 win-x64 发布、维护的 Inno Setup 打包和发布结果 JSON。

1.0.0

  • 添加了描述和图标。

Features

  • 扫描现有的 Valheim 安装并识别已安装的 BepInEx 模组。
  • 通过 Thunderstore 和 Nexus Mods 检查更新。
  • 保留精确的提供程序身份,使更新不会静默跳转到无关包。
  • 通过暂存、备份、哈希验证和回滚安全地安装受支持的模组 ZIP。
  • 从管理器中编辑模组配置文件。
  • 保存和分享模组设置,以便其他玩家可以查看并应用相同的设置。
  • 通过其 Windows 安装程序安装、更新和修复 Terramods。

Installation

Terramods 是一个 独立的 Windows 桌面应用程序,不是 BepInEx 插件。

  1. 在 Thunderstore 上选择 Manual Download(手动下载)
  2. 解压下载的 ZIP。
  3. 运行 Terramods-Setup-1.1.4-win-x64.exe
  4. 按照安装程序操作。
  5. 启动 Terramods,如果未自动检测到,请选择你的 Valheim 安装。

如果已安装较旧的 Terramods 版本,安装程序将提供 Update Terramods(更新 Terramods)。安装相同版本会提供 Repair Terramods(修复 Terramods)

Thunderstore / mod-manager note

由于 Terramods 本身就是一个模组管理器,请使用 Manual Download(手动下载) 获取应用程序安装程序。将此包安装到游戏配置文件中并不能替代运行 Windows 安装可执行文件。

Supported game

  • Valheim

Platforms

  • Windows x64

Providers

  • Thunderstore
  • Nexus Mods

Safety

Terramods 对受支持的安装使用显式提供程序身份、暂存写入、路径验证、配置保留、SHA-256 验证和回滚行为。

Created by R4V9N1.