故障排除指南
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 图形设置
禁用光照效果
减少粒子效果
使用性能优化模组
关闭不必要的后台程序
减少内存使用
将活跃模组限制为必备模组
避免使用高分辨率纹理的纹理包
定期清除模组缓存
每隔几小时重启游戏
使用专为性能设计的模组
获取更多帮助
Discord 社区
来自社区成员和开发者的实时帮助
Terraria 论坛
官方论坛，包含详细的故障排除帖子
GitHub Issues
报告错误和搜索现有问题
如何有效地报告问题
寻求帮助时请提供以下信息：
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/
仍然需要帮助？
如果你在这里没有找到解决方案，别担心！我们的社区随时为你提供帮助。
加入 Discord
报告错误