开始之前
前提条件
- 已安装正版 Terraria
- 用于下载模组的网络连接
- 至少 1GB 可用存储空间
- 管理员/root 权限（用于安装）
Steam 安装（推荐）
这是最简单的推荐方法。Steam 会自动处理所有更新并包含创意工坊集成。安装完成后，请查看我们的模组使用指南。
打开 Steam
启动 Steam 客户端并确保您已登录账户。
安装（完全免费！）
点击"开始游戏"按钮。tModLoader 完全免费 - 无需购买。
Steam 将根据您的平台下载约 200-500MB。
启动 tModLoader
安装完成后，在 Steam 游戏库中找到 tModLoader 并点击"开始"。
首次启动可能需要几分钟来设置文件和文件夹。
Steam 安装的优势
- 自动更新
- Steam 创意工坊集成
- 云存档支持
- 轻松与朋友联机
手动安装
适用于高级用户或没有 Steam 的平台。需要手动更新。
解压文件
将下载的文件解压到 Terraria 安装目录。
常见 Terraria 安装路径：
Windows (Steam)：
C:\Program Files (x86)\Steam\steamapps\common\Terraria
Windows (GOG)：
C:\GOG Games\Terraria
macOS：
~/Library/Application Support/Steam/steamapps/common/Terraria
Linux：
~/.steam/steam/steamapps/common/Terraria
运行 tModLoader
启动 tModLoader 可执行文件：
- Windows：运行
tModLoader.exe - macOS：运行
tModLoader（可能需要在系统偏好设置中允许） - Linux：运行
./tModLoader（可能需要先设置可执行权限）
平台特定说明
Windows 安装说明
需要 .NET Framework：从微软官网安装 .NET Framework 4.7.2 或更新版本。
管理员权限：首次启动时可能需要以管理员身份运行。
杀毒软件：某些杀毒软件可能会标记 tModLoader。如有需要，请将其添加到例外列表。
防火墙：多人游戏时请允许 tModLoader 通过 Windows 防火墙。
macOS 安装说明
Mono Framework：从 mono-project.com 安装最新的 Mono 框架。
Gatekeeper：首次启动时右键点击 → 打开以绕过 Gatekeeper。
权限：可能需要在系统偏好设置 → 安全性中授予权限。
Linux 安装说明
Mono Framework：通过包管理器安装（apt、yum 等）。
设置可执行权限：首次启动前运行 chmod +x tModLoader。
依赖项：根据发行版可能需要额外的库。
音频问题：如遇音频问题请安装 PulseAudio。
验证安装
如何确认 tModLoader 安装正确：
✓ 检查 1：主菜单
您应该看到以下新菜单选项：
- • 模组浏览器 - 浏览和下载模组
- • 模组 - 启用/禁用已安装的模组
- • 创意工坊 - 开发和发布模组
✓ 检查 2：版本号
左下角应显示：
✓ 检查 3：文件夹结构
导航到 Documents/My Games/Terraria/ - 您应该看到"tModLoader"文件夹。
安装故障排除
问题："缺少 .NET Framework"
症状：启动时出现缺少 .NET 的错误消息
解决方案：
- 1. 访问微软 .NET 下载页面
- 2. 下载 .NET Framework 4.7.2 或更新版本
- 3. 安装并重启电脑
- 4. 重新启动 tModLoader
问题："杀毒软件阻止 tModLoader"
症状：安装失败或 tModLoader 无法运行
解决方案：
- • 将 tModLoader 文件夹添加到杀毒软件例外
- • Windows Defender：设置 → 病毒和威胁防护 → 排除项
- • 添加整个 Terraria/tModLoader 目录
- • 安装期间暂时禁用杀毒软件
问题："首次启动缓慢"
症状：tModLoader 首次启动需要 5 分钟以上
这是正常现象！
首次启动会执行以下任务：
- • 创建文件夹结构
- • 生成配置文件
- • 索引原版内容
- • 设置模组浏览器数据库
GOG 和其他版本
使用 GOG 版 Terraria 安装
tModLoader 兼容 GOG Galaxy 和独立 GOG 安装：
选项 1：手动安装
- 1. 从 GitHub 下载 tModLoader
- 2. 找到 GOG Terraria 文件夹（通常是 C:\GOG Games\Terraria）
- 3. 将 tModLoader 文件解压到该文件夹
- 4. 运行 tModLoader.exe
选项 2：Steam 免费下载
即使您在 GOG 上拥有 Terraria，也可以在 Steam 上免费下载 tModLoader。它是一个独立应用，可以单独运行。
注意：创意工坊集成仅通过 Steam 版本提供。GOG 用户仍可使用游戏内模组浏览器。