MOD 开发

Mod 开发指南

使用 tModLoader 强大的 C# API 创建您自己的 mod。

前提条件

开发工具

  • Visual Studio 2022(推荐)
  • JetBrains Rider(替代方案)
  • VS Code 搭配 C# 扩展
  • .NET 6.0 SDK 或更新版本

必备知识

  • C# 编程基础
  • 面向对象概念(类、继承)
  • Terraria 游戏知识
  • 基础游戏开发理解

创建您的第一个 Mod

步骤 1:设置开发环境

从官方来源安装 Visual Studio 和 .NET SDK。

查看详细设置指南 →

步骤 2:创建 Mod 项目

  1. 1. 启动 tModLoader
  2. 2. 进入"创意工坊"→"开发 Mod"
  3. 3. 点击"创建 Mod"
  4. 4. 输入唯一的 mod 名称(不含空格)
  5. 5. 点击"创建"

步骤 3:了解 Mod 结构

YourModName/
├── build.txt # 元数据
├── description.txt # 描述
├── icon.png # 64x64 图标
├── YourModName.cs # 主类
├── Items/ # 自定义物品
├── NPCs/ # 自定义 NPC
├── Projectiles/ # 弹射物
└── Tiles/ # 方块/图块

了解 tModLoader API

tModLoader 通过 C# 类提供了对 Terraria 系统的广泛钩子。

核心类

  • • Mod(基础 mod 类)
  • • ModItem(物品/武器)
  • • ModNPC(敌人/NPC)
  • • ModProjectile(弹射物)

世界内容

  • • ModTile(方块/图块)
  • • ModWall(墙壁)
  • • ModBiome(生物群落)
  • • ModWorld(世界生成)

效果与界面

  • • ModBuff(增益/减益)
  • • ModDust(粒子效果)
  • • ModSound(音效)
  • • UIState(自定义界面)

学习资源

官方 GitHub Wiki

最全面的资源,包含数百个示例和教程。

覆盖范围:所有 API 类及示例
更新:定期维护
示例:200+ 代码片段
社区:开放贡献
访问 GitHub Wiki

视频教程

通过 YouTube 上的社区教程进行可视化学习。

  • • 基础 mod 创建
  • • 高级技巧
  • • 实时编码演示

示例 Mod

学习热门开源 mod 的源代码。

  • • ExampleMod(官方模板)
  • • 社区 mod 仓库
  • • 注释完善的项目

下一步

继续学习