模组安装与推荐指南｜Mods 安装方法
Mods 扩展了游戏，加入新建筑、界面改动、地图和玩法机制；对于想要提升 QoL、使用社区内容或引入全新系统的玩家来说，这些是必不可少的。此页面说明了 mod 的分发、安装、创建与故障排除方法，并给出推荐类型和安全做法。
Mods 可以做什么
- 使用官方 Mod API 添加新建筑、资源和生物群系。
- 提供 QoL 与界面改进（海狸管理覆盖层、水位覆盖、跳过开场、自动化辅助）。
- 提供新地图和地图编辑器资源（自定义起始位置、河流、地形、资源分布）。
- 引入新的游戏系统（火车、扩展地形工具、创意模式）。
- 暴露高级集成点（HTTP Lever / HTTP Adapter 用于外部自动化与监视）。
游戏的 mod 生态从小的外观调整与覆盖层扩展到改变后期进程的大型内容包。
在哪里可以找到 mods
- Steam 创意工坊 — 对于 Steam 玩家一键订阅；是获取地图、素材和大量 mod 的最受欢迎来源。
- mod.io — 集成在游戏客户端内的官方跨
- Thunderstore — 常见于 BepInEx/BepInExPack 用户以及一些旧内容。
- Nexus Mods 和社区 Discord 频道 — 额外的上传、图形、模板与帮助。
社区资源也会收集热门或推荐列表（例如 BeaverBuddy、Water Overlay Enhanced、TimberbornTerrainTools、ChooChoo 火车 mod）。
如何安装 mods
游戏内 / 平台集成安装（推荐）
- Steam 创意工坊：订阅项目；它们会自动下载。启动游戏，打开 Mods 菜单，并启用已订阅的 mod。
- mod.io：在游戏内或 mod.io 上浏览，按
手动安装
- 下载 mod 压缩包或文件。
- 解压到你的 Timberborn Mods 文件夹：
- Windows: %USERPROFILE%\Documents\Timberborn\Mods
- macOS: ~/Library/Application Support/Timberborn/Mods
- Linux: ~/.local/share/Timberborn/Mods
- 启动游戏并在 Mods 菜单中启用该 mod（如有必要）。
BepInEx / BepInExPack 要求
- 许多 mod（尤其是代码类 mod）需要 BepInEx 或 社区的 BepInExPack 来运行。通过将 BepInExPack 的内容解压到 Timberborn 的游戏文件夹并运行游戏一次来完成安装。按照 BepInEx 文档了解插件开发和高级用法。
创建 mods
- 代码类 mod 使用 Unity 的 C# 编写，基于 Timberborn modding SDK 与 BepInEx。需要基础的 C# 知识并熟悉 BepInEx 插件教程。
- modding SDK 提供模板、示例和 API 文档；官方 Discord 有 mod 制作相关的支持频道。
- 对于图形资源（旗帜、尾标贴花、自定义图片），使用正方形 PNG（首选透明 1024×1024）并使用社区模板。
- 若要分享地图，使用内置地图编辑器然后上传到 Steam 创意工坊或 mod.io；地图文件（.timber）位于玩家 Maps 文件夹。
启用 mods 与存档兼容性
- 安装/订阅后，从主菜单的 Mods 部分启用 mods。
- 添加新建筑、资源或机制的 mod 最安全的做法是在新存档开始时启用。在已进行中的游戏中途添加此类 mod 可能导致不兼容。
- 界面/QoL mod（覆盖层、显示）通常可以安全地添加到现有存档，但请查看每个 mod 的说明。
故障排除与常见问题
- 启动崩溃：逐个禁用 mod 以定位问题 mod。版本不匹配是最常见原因。
- 冲突：两个修改相同系统的 mod 可能互相冲突——检查 mod 描述和作者说明。
- 存档文件：使用 mod 的存档在没有相同 mod 的机器上可能无法加载。启用或禁用 mod 前请备份存档。
- 如果 mod 在游戏更新后失效，检查 mod 页面是否有更新版本，或回退到与 mod 兼容的旧游戏版本。
- 游戏日志文件（Timberborn 日志目录）包含指向问题 mod 的错误信息。
最佳实践与安全
- 在安装大量或大型内容 mod 之前，备份你的 Saves 文件夹。
- 优先通过 Steam 创意工坊或 mod.io 订阅以获取自动更新。
- 检查 mod 的兼容性说明和所需依赖（例如 BepInExPack）。
- 第一次使用 mod 时，先安装轻量的 QoL mod（如 BeaverBuddy、Water Overlay 增强）以熟悉流程，再尝试大型内容 mod。
- 避免同时启用多个改变核心平衡的 mod，除非你接受成就或玩法会被改变。
Mod 类型与社区常用项
- QoL/界面类 mod：改进的覆盖层、海狸管理 UI、跳过开场。
- 自动化与集成：类似 SmartPower 的工具以及用于外部控制/监视的 HTTP Lever/HTTP Adapter。
- 内容包：新作物、建筑、生物群系与科技树。
- 创意与沙盒工具：创意模式、扩展地形工具、地图包。
- 美化类：尾标贴花、旗帜、自定义图片。
分享与发布
- Steam 创意工坊：使用游戏内上传工具上传地图与 Workshop 项目；选择可见性，添加描述与更新日志。
- mod.io：按照 mod.io 的上传指南上传地图与 mod；提供所需的元数据与资源。
- 在发布时，包含清晰的兼容性信息（游戏版本、所需依赖）、更改日志与安装说明。
文件位置与共享
- Mods 文件夹（手动安装）：Documents/Timberborn/Mods（见上述
- Steam 创意工坊内容存储在你的 Steam workshop 内容文件夹（Steam/steamapps/workshop/content/1062090）。
- 自定义地图放在本地 Maps 文件夹；共享 .timber 文件或通过编辑器上传。
使用本指南来选择、安装并安全管理 mods，让你能够自信地扩展游戏内容——从简单的 QoL 调整到复杂的新玩法系统。