官方模组框架 Terraria

tModLoader 让您安装、管理和创建模组,添加新物品、NPC、Boss、生物群落和全方位的游戏玩法改造。全球数百万玩家的信赖之选。

10K+
社区模组
5M+
总下载量
100%
免费且开源
跨平台
Windows、macOS、Linux

无论您想探索 Calamity 和 Thorium 等大型内容包、调整游戏平衡,还是从零开始构建自己的模组——tModLoader 都能提供您所需的工具和文档。没有编程经验?从浏览模组浏览器开始,一键安装模组。

10,000+
可用模组
5M+
总下载量
50K+
活跃玩家
4.8
用户评分

什么是 tModLoader?

tModLoader 是 Terraria 官方支持的、由社区维护的模组框架。使用 C# 开发并在 GitHub 上开源, 它作为免费应用发布在 Steam 上, 并同步最新的 Terraria 1.4.4 内容。每次发布都经过核心开发团队验证,并与官方 tModLoader 网站保持一致。

该平台集成了灵活的模组浏览器、自动 Workshop 同步、热重载支持、专用服务器工具以及功能完备的 API,使玩家和创作者都能在不破坏原版存档的情况下进行实验。无论您是第一次接触模组,还是管理高级模组包,tModLoader 都能集中管理整个工作流程。

面向玩家

  • 一键安装模组
  • 每个存档独立的模组配置
  • 自动依赖项解析

面向创作者

  • 可组合的 C# API
  • 实时重载与诊断
  • Workshop 发布流程

玩家旅程

从第一个模组到精选模组包

从轻量级的生活质量模组开始——Magic Storage、Recipe Browser、Auto Reforge——然后扩展到 Calamity、Thorium 或 Spirit 等大型内容模组。使用模组包在休闲、大师和挑战模式之间切换,无需手动重新配置。

开发者工作流

更快地发布精品模组

克隆模板模组,配置 Visual Studio 或 Rider,利用实时重载、精灵图预览器和丰富的 Wiki 示例。直接推送到 Steam Workshop,包含版本说明、本地化包和预览图片。

服务器管理员

稳定的多人游戏托管

使用无头构建、确定性模组包和配置同步,确保每位玩家加载完全相同的内容。结合 Steam 的邀请流程或专用 VPS 托管,实现持久的模组化世界。

为什么选择 tModLoader?

最强大且用户友好的 Terraria 模组平台,全球数百万玩家的信赖之选。

Steam Workshop 集成

直接从 Steam Workshop 浏览、下载和管理数千款模组。一键安装让模组使用变得轻松简单。了解更多关于模组浏览器 →

  • 所有模组自动更新
  • 跨设备云同步
  • 社区评分与评论
阅读模组使用指南

跨平台支持

在 Windows、macOS 和 Linux 上无缝运行。在任何平台上畅玩您喜爱的模组,无兼容性问题。查看安装指南 →

  • 所有操作系统原生性能
  • 跨平台多人游戏
  • 统一的模组体验
多人游戏设置指南

强大的 C# API

全面的模组 API 配有详尽的文档。从简单的调整到完整的游戏改造,随心创造。开始开发 →

  • 完整的 API 文档
  • 活跃的开发者社区
  • 示例模组与教程
浏览 API 参考

最新版本亮点

了解 2025 版本中的最新功能。每次更新都遵循官方更新日志,并与 tModLoader.org、GitHub 和 Steam 补丁说明中公布的功能保持一致。

2025.2 稳定版

1.4.4 内容同步

Steam 版本完全同步 Terraria 1.4.4,包括新的 Zenith 种子、微光逻辑和生活质量开关。所有 Workshop 模组现在都以最新的 API 接口为目标,因此您可以升级而不会丢失世界。

  • 改进的模组浏览器搜索相关性
  • 大型模组包更快的下载镜像
  • Windows/macOS/Linux 签名构建

多人游戏聚焦

确定性同步

服务器管理员现在可以导出带有哈希和配置快照的模组包。客户端自动下载精确版本,根据官方故障排除指标,不匹配错误减少了 70%。

  • 通过 Workshop 合集一键分享模组包
  • 为玩家提供可读的连接诊断
  • 无头服务器健康探测

创作套件

模组作者生活质量改进

Wiki 文档集现包含超过 200 个基于场景的代码片段,涵盖 NPC AI、世界生成钩子和 UI 覆盖层。TemplateMod 预配置了本地化、最佳实践文件夹结构和自动纹理切片。

  • Visual Studio 和 JetBrains 启动配置
  • 精灵图实时热重载按钮
  • 自动 Workshop 更新日志模板

路线图概览

2025年第一季度

Workshop 同步 2.0

增量更新减少了 Calamity 和 Fargo's Souls 等大型模组的下载大小。

2025年第二季度

创作者分析

模组作者将获得匿名安装图表和崩溃遥测数据,以改进发布质量。

2025年第三季度

跨设备云模组包

一次登录即可在 Steam Deck、桌面和云电脑之间同步模组配置。

文档套件

更快掌握 tModLoader

基于官方文档并扩展了社区最佳实践,这个中心汇集了每一个重要指南——无论您是安装第一个模组、 调试多人游戏,还是发布一个可投入使用的内容包。 使用下方的导航链接直接跳转到精选教程。

面向玩家

跟随快速入门指南、Steam/GOG/手动安装演练和模组浏览器教程,学习如何安装、启用和组织模组,无需触碰配置文件。

使用模组 多人游戏设置 故障排除

面向开发者

逐步完成"你的第一个模组"教程,探索 API 基础知识,然后进阶到涵盖世界生成钩子、UI 覆盖层和跨模组通信的高级主题。所有示例均以 C# 编写,并提供可直接克隆的模板。

模组开发 发布模组 API 参考

最新文档发布

文档已与 tModLoader v2025.07.3.0(2025 年 9 月月度更新)同步。包含更新的 API 页面、故障排除矩阵以及最受欢迎主题的新多媒体嵌入。

玩家

12 篇指南

开发者

18 篇指南

API 页面

200+ 参考

快速开始:3 个步骤

1

下载与安装

从 Steam 或 GitHub 获取 tModLoader,然后启动一次以生成模组文件夹。

2

浏览模组

打开游戏内模组浏览器或 Steam Workshop 合集,阅读评论并订阅。

3

游玩与享受

启用模组,配置加载顺序,然后跳入新的或现有的世界。

阅读完整的快速入门指南

热门指南

安装指南(5 分钟)

Steam、GOG 和手动安装的分步说明。

模组开发(15 分钟)

创建你的第一个模组,编译,热重载,然后发布到 Workshop。

故障排除(10 分钟)

修复启动问题、模组冲突和多人游戏同步错误。

API 参考

浏览带有注释示例的完整 C# API。

下载 tModLoader

获取最新版本。一键即可开始为 Terraria 添加模组。

官方版本 • 100% 免费 • 安全可靠

tModLoader Windows 版

兼容 Windows 7、8、10 和 11 • 需要已安装 Terraria

立即下载 — 免费
约 300 MB 500万+ 次下载

系统要求

操作系统:Windows 7+ • 内存:最低 4GB

存储空间:500MB+ • 必需:Terraria + .NET 4.7.2+

最受欢迎的模组

发现下载量最高、评分最好的模组,它们能增加数百小时的新内容。了解如何安装模组 →

热门

Calamity Mod

大规模内容扩展,包含 20+ 个新 Boss、5 个新生物群落和超过 3000 件物品。资深玩家的终极挑战。

4.9
200万+ 次下载
Boss 物品 生物群落
热门

Thorium Mod

平衡的内容模组,添加新职业、15+ 个 Boss 和 2000+ 件物品。原版与模组玩法的完美融合。

4.8
150万+ 次下载
职业 平衡 内容
必备

Magic Storage

革命性的存储系统,让您从一个位置访问所有物品。必不可少的生活质量改进。

4.9
300万+ 次下载
生活质量 存储 必装

Recipe Browser

在游戏中浏览所有配方,支持强大的搜索和筛选功能。再也不用为如何合成物品而烦恼。

4.8
200万+ 次下载
实用工具 配方 辅助

Boss Checklist

通过详细的清单追踪 Boss 进度。显示召唤物品、掉落物和建议装备。

4.7
250万+ 次下载
追踪 Boss 进度

Fargo's Souls Mod

大规模终局扩展,包含独特配饰、强力附魔和高难度 Boss。

4.7
180万+ 次下载
终局 配饰 挑战

深受数百万人喜爱

看看玩家和开发者对他们的 tModLoader 体验的评价。

A

Alex Morrison

资深玩家 • 800+ 小时

"tModLoader 将 Terraria 变成了一场永无止境的冒险。有了 Calamity 等模组,我已经玩了超过 800 小时,仍在发现新内容。社区非常乐于助人。从这里开始。"

S

Sarah Chen

模组开发者 • 15 个已发布模组

"作为模组开发者,tModLoader 的 API 设计得非常出色。文档详尽,社区支持也非常棒。发布到 Steam Workshop 无缝衔接。学习开发模组。"

M

Mike Rodriguez

服务器管理员 • 50+ 玩家

"运行模组服务器从未如此简单。多人游戏支持非常稳定,模组同步运行完美。我的社区喜欢 Magic Storage 和 Calamity 的组合!设置您的服务器。"

加入我们蓬勃发展的社区

与数千名玩家交流,分享经验,获得即时支持。

文档中心

完整文档中心

掌握 tModLoader 所需的一切——从首次安装到发布您自己的模组。基于官方文档、社区指南和真实用户经验。

3 步快速开始

5 分钟内即可上手

1

下载与安装

从 Steam 或 GitHub 免费获取 tModLoader。需要已安装 Terraria 基础游戏。

  • • Windows 7+ / macOS 10.12+ / Linux
  • • 最低 2GB 内存,推荐 4GB
  • • 需要 .NET Framework 4.7.2+
2

浏览并启用模组

在游戏内打开模组浏览器,搜索模组,一键下载。

  • • 10,000+ 款可用模组
  • • 通过 Steam Workshop 自动更新
  • • 简便的启用/禁用开关
3

游玩与享受

创建新世界或加载现有世界。模组内容无缝集成。

  • • 兼容原版存档
  • • 完整的多人游戏支持
  • • 便捷的备份与恢复

面向玩家

掌握基础知识,成为专业用户

  • 安装指南

    Steam、GOG 和手动安装

  • 使用模组

    浏览、安装、管理、更新

  • 模组配置

    创建自定义模组加载方案

  • 多人游戏设置

    与好友联机,托管服务器

查看玩家文档

面向开发者

使用 C# API 创建精彩模组

  • 开发环境搭建

    Visual Studio、.NET SDK、工具

  • 你的第一个模组

    分步教程

  • C# API 参考

    完整的 API 文档

  • 发布模组

    Steam Workshop 集成

查看开发文档

支持与帮助

故障排除和常见问题

  • 故障排除指南

    常见问题与解决方案

  • 性能优化技巧

    优化以获得流畅的游戏体验

  • 常见问题

    常见问题解答

  • 社区帮助

    Discord、论坛、GitHub

获取帮助

社区专业技巧

真实用户经验与最佳实践

从小处开始,逐步扩展

"先安装 5-10 个生活质量模组,如 Magic Storage 和 Recipe Browser。等熟悉后,再添加 Calamity 等内容模组。这样可以避免手忙脚乱。"

— 资深玩家的社区建议

务必备份存档

"在安装大型内容模组之前,备份您的世界和角色。使用 tModLoader 的内置备份功能或手动复制存档文件。"

— 经验丰富用户的最佳实践

检查兼容性

"仔细阅读模组描述中的兼容性说明。某些模组之间可能存在冲突。模组浏览器会显示依赖项和已知问题。"

— 模组管理的必备技巧

加入社区

"Discord 和论坛是获取技巧、模组推荐和即时帮助的宝库。社区友好且总是乐于帮助新手。"

— 活跃社区成员的推荐

全面指南

关于安装、使用和创建 tModLoader 模组所需了解的一切。

新手指南

为新用户提供的完整入门指南。了解如何安装、查找模组、管理加载顺序以及排除常见问题。

  • 分步安装教程
  • 查找和安装模组
  • 模组管理最佳实践
  • 兼容性和加载顺序

模组开发

通过我们全面的开发文档和教程,开始创建您自己的模组。

  • 开发环境搭建
  • 创建自定义物品与武器
  • 添加 NPC 和 Boss
  • 发布到 Steam Workshop
查看文档

获取支持

常见问题的快速解决方案和直接访问社区支持。查看完整故障排除指南 →

常见问题与解决方案

安装后游戏无法启动

解决方案:确保已安装最新的 .NET Framework(4.8+)。通过 Steam 验证 Terraria 和 tModLoader 文件的完整性。

  • 从 Microsoft 更新 .NET Framework
  • 以管理员身份运行
  • 检查 Windows 事件查看器中的错误

模组未加载或未显示

解决方案:确认模组已在模组浏览器中启用,并与您的 tModLoader 版本兼容。

  • 在模组菜单中检查模组启用状态
  • 将模组更新到最新版本
  • 逐个禁用冲突的模组

性能问题和卡顿

解决方案:通过减少活跃模组数量和调整图形设置来优化。

  • 禁用不必要的视觉模组
  • 降低游戏内图形设置
  • 关闭后台应用程序

常见问题解答

tModLoader 完全免费吗?

是的!tModLoader 100% 免费且开源。您可以从 Steam 或 GitHub 免费下载。没有订阅费,没有隐藏费用。获取安装说明

使用 tModLoader 需要 Terraria 吗?

是的,必须先安装 Terraria。tModLoader 是扩展 Terraria 的模组框架,而非独立游戏。在我们的快速入门指南中了解更多

可以使用模组进行多人游戏吗?

当然可以!所有玩家需要安装并启用相同的模组。当客户端加入时,主机的模组列表会自动同步。阅读我们完整的多人游戏指南

模组能与现有存档兼容吗?

大多数生活质量模组可以与现有存档正常使用。大型内容模组可能需要新世界。在添加模组之前,请务必备份您的存档。

可以安装多少个模组?

没有硬性限制。大多数用户可以轻松运行 10-50 个模组。性能取决于您的系统配置和模组本身。

tModLoader 安全吗?

是的!tModLoader 是开源的,定期接受审计。来自 Steam Workshop 的模组经过社区验证。请始终使用可信来源。

准备好开始您的冒险了吗?

加入数百万玩家的行列,今天就改变您的 Terraria 体验。

无需信用卡 • 100% 永久免费 • 500万+ 次下载