故障排除指南
tModLoader 常见问题及错误信息的解决方案
15 分钟阅读
故障排除
更新于 2025 年 9 月
快速解决方案
在深入研究具体问题之前，先尝试以下常见修复方法：
重启一切
完全关闭 tModLoader 并重新启动。这可以解决 50% 的问题。
禁用所有模组
禁用所有模组，然后逐个启用以找出冲突的模组。
安装问题
tModLoader 无法启动
Windows 解决方案：
- 安装 .NET Framework 4.7.2 或更高版本
- 安装 Visual C++ Redistributable 2015-2022
- 以管理员身份运行
- 在 Windows Defender/杀毒软件中添加例外
- 验证 Terraria 安装完整性
macOS/Linux 解决方案：
- 安装 Mono 框架（6.0 或更高版本）
- 检查文件权限：
chmod +x tModLoader - 安装所需的系统库
- 尝试从终端运行以查看错误信息
Steam 相关问题
未出现在库中
- 刷新你的 Steam 库
- 检查下载是否成功完成
- 重启 Steam 客户端
- 确认你安装了 tModLoader，而不是只添加到了愿望单
Steam Workshop 不工作
- 确保你已登录 Steam
- 检查 Steam 社区功能是否已启用
- 尝试在在线模式下重启 Steam
- 清除 Steam 下载缓存
模组相关问题
模组冲突和崩溃
识别问题模组
- 禁用所有模组，从头开始
- 逐个启用模组，每次启用后测试
- 当崩溃发生时，最后启用的模组可能就是罪魁祸首
- 查看模组描述中的已知不兼容信息
常见冲突类型：
- 配方冲突：多个模组修改相同的配方
- ID 冲突：模组使用相同的物品/NPC ID
- 版本不兼容：模组针对不同的 tModLoader 版本设计
- 依赖问题：缺少必需的模组或库
性能问题
低帧率解决方案
- 降低 Terraria 图形设置
- 禁用资源消耗大的模组
- 关闭后台应用程序
- 更新显卡驱动
内存问题
- 限制活跃模组数量
- 增加虚拟内存
- 关闭其他程序
- 考虑升级到 64 位系统
多人联机问题
无法连接到好友
模组同步
所有玩家必须启用完全相同的模组：
- 相同的模组版本
- 相同的模组加载顺序
- 服务器上不要有仅客户端的模组
常见解决方案
- 主机创建并分享模组包
- 所有玩家下载相同的模组包
- 验证模组列表是否完全一致
- 模组更改后重启客户端和服务器
常见错误信息
System.DllNotFoundException
此错误表示缺少系统库。
解决方案：
- 安装 Visual C++ Redistributable（Windows）
- 更新到最新的 Windows 版本
- 安装缺少的系统依赖项
- 运行 Windows Update
System.OutOfMemoryException
游戏已耗尽可用内存。
解决方案：
- 减少活跃模组数量
- 关闭其他应用程序
- 增加虚拟内存/页面文件
- 如有可能，升级系统内存
- 使用 64 位操作系统
模组加载错误
加载或构建模组时出现的错误。
常见原因及解决方案：
- 缺少依赖：安装必需的模组库
- 版本不匹配：将模组更新到最新兼容版本
- 模组文件损坏：重新下载并重新安装模组
- 无效的模组结构：验证模组文件结构是否正确
性能优化
提高帧率
- 降低 Terraria 图形设置
- 禁用光照效果
- 减少粒子效果
- 使用性能优化模组
- 关闭不必要的后台程序
减少内存使用
- 将活跃模组限制为必备模组
- 避免使用高分辨率纹理的纹理包
- 定期清除模组缓存
- 每隔几小时重启游戏
- 使用专为性能设计的模组
获取更多帮助
如何有效地报告问题
寻求帮助时请提供以下信息：
- tModLoader 版本号
- 操作系统及版本
- 已启用模组的完整列表
- 确切的错误信息（如有）
- 重现问题的步骤
- Logs 文件夹中的日志文件
常见问题
我可以在盗版 Terraria 上使用 tModLoader 吗？
不可以。tModLoader 需要正版 Terraria 才能运行。我们不支持或协助盗版版本。
我的原版 Terraria 存档可以在 tModLoader 中使用吗？
可以，tModLoader 可以加载原版 Terraria 的世界和角色。但是，模组添加的内容在原版 Terraria 中不可用。
如何更新 tModLoader？
Steam 版本会自动更新。对于手动安装，从 GitHub 下载最新版本并替换现有安装。
我可以用模组化的 Terraria 在线游玩吗？
可以，但所有玩家必须安装 tModLoader 并启用完全相同的模组。原版玩家无法加入 tModLoader 服务器。
我的模组文件存储在哪里？
模组文件存储在：
- Windows： Documents/My Games/Terraria/tModLoader/
- macOS： ~/Library/Application Support/Terraria/tModLoader/
- Linux： ~/.local/share/Terraria/tModLoader/
仍然需要帮助？
如果你在这里没有找到解决方案，别担心！我们的社区随时为你提供帮助。