Hello World

欢迎来到泰拉瑞亚的创意无限世界，在这里，不仅仅是探索与冒险，更是创造与实现梦想的天地。作为一名勇敢的开发者，你即将他上的旅程，不近视深入这个像素世界的腹地，更是要在其基础上构建属于你自己的奇迹。本指南将是你受众的罗盘，引领你步入泰拉瑞亚模组开发的神秘大门。
想象一下，当你手持代码之间，桥下第一个字符，一个简单的"Hello World"便能在泰拉瑞亚广阔的天地间回响，这不仅是变成传统的直径，也是你成为游戏世界造物主的第一步。泰拉瑞亚mod开发的魅力，在于它赋予你重塑世界规则的能力，无论是新奇的武器、独特的怪物，还是整个异世界的创造，一切皆有可能。
本指南将循序渐进，从最基础的设置环境开始，逐步深入如何使用C#和TModLoader来编写你的第一个mod，理解背后的逻辑与技巧，为你后续的创意开发打下坚实的基础。
无论你是编程新手，还是经验丰富的开发者初涉游戏领域，这篇指南都力求让你的每一步学习都充满乐趣与成就感。准备好了吗？让我们异同步入泰拉瑞亚的编程仙境，用一行行代码编制出属于你的传奇故事。
让我们开始吧！

Mod制作准备

一台电脑
玩过泰拉瑞亚，原版或者灾厄至少通关过一次（博主原版大师、灾厄死亡大师都通关了）
安装IDE，强烈建议VSCode，主要是写C#
会使用画图软件（Photoshop等）

.NET环境安装

开发环境的安装，可以直接看微软官方教程

https://dotnet.microsoft.com/zh-cn/learn/dotnet/hello-world-tutorial/install

这里再建议安装一个通义灵码的插件，用起来还是挺方便的

TModLoader的介绍与安装

源码Mod和TML Mod的区别

源码Mod的制作方法是通过反编译泰拉瑞亚源码，并在此基础上修改而制作的模组。优点是自由度高，可以实现的功能多。缺点是很难管理，灵活度低下，尤其是当Mod规模扩大的时候。

TML Mod通过提供原版的接口使得开发者可以在一个与原版独立的环境开发Mod，也就是说，开发者可以不用关注原版冗长的代码实现细节，而是与接口进行互动。优点是管理方便、灵活。缺点是实现的功能具有局限性，有时候需要等待TML开发者添加了某些接口才能实现特定的功能。但是随着TML这么多年功能的不断的完善，以及原版泰拉瑞亚代码越来越晦涩难懂，TML开发最终占据了主导。

TModLoader的安装

如果你之前打过mod玩，那么其实你已经安装好了，对吧
如果你是第一次使用mod游玩，直接在Steam上下载安装即可
安装完成之后，直接TMOD，启动！
点击创意工坊，进入创意工坊中心
点击开发模组，会看到如下页面

第一个Mod

点击右下角创建模组，填写模组信息我们就可以初始化一个模组项目了
- ModName：模组名称，不要夹杂空格
- Mod DisplayName：模组显示名称
- Mod Author：模组作者
- BasicSword：初始之剑，这里填写的是剑的名称，创建项目时，会自动生成这把剑的初始化代码
点击创建后，初始化的项目如下
我们在VSCode里打开这个项目，首先看一下目录结构
1. [ModName].cs：这是Mod类。它是任何Mod的核心文件，每个Mod只能存在一个Mod类，对于简单的Mod，这个文件会非常简洁，但是这个类中可以发生各种全局性的事情。
2. description.txt：包含Mod的描述文本，在Mod菜单中点击“更多信息”按钮可以在游戏中查看。如果你愿意，可以创建一个带有额外BBCode格式的description_workshop.txt文件，该文件将在Steam创意工坊网站上显示。
3. build.txt：包含Mod的版本、作者和显示信息。可以包含其他值。这个文件是必要的。
4. icon.png：在游戏中显示的80x80图标。你可以为Steam创意工坊创建一个更详细或更高分辨率的icon_workshop.png图标，该文件可以达到512x512像素。
5. [ModName].csproj：为Visual Studio设置的项目文件，用于调试你的Mod。调试非常有用，但需要一些学习，不要删除它。
6. Properties/launchSettings.json：与ModName.csproj相关，包含用于调试tModLoader文件路径，不要删除，随着你的经验积累，它会变得很有用。
7. Content/Items/[ItemName].cs：一个简单的剑物品。以此作为示例，学习如何制作其他ModItem类。
8. Content/Items/[ItemName].png：对应的物品图像。
9. Localization/en-US_Mods.[ModName].hjson：包含Mod中内容的英文文本。它目前包含生成的剑的显示名称和工具提示。这个文件会随着你向Mod添加新内容而自动更新条目。请参阅Localization Wiki了解更多本地化及支持其他语言的信息。
下面我们直接来看初始化剑的代码，以及对应的配置文件信息。

下面这段代码就是初始之剑的代码，我们先来看SetDefaults()方法，这个方法就是初始化物品的配置信息，这里我们配置了物品的伤害、攻击类型、宽高、使用时间、使用动画、使用方式、击退、价值、稀有度、音效、自动使用（近战武器自动挥舞）等。
同时我们需要关注AddRecipes()方法，这个方法就是添加物品的合成配方，这里我们添加了合成配方，需要用10个土块，并且需要工作台才可以制作。

using Terraria;
using Terraria.ID;
using Terraria.ModLoader;

namespace MyFirstMod.Content.Items
{
    // This is a basic item template.
    // Please see tModLoader's ExampleMod for every other example:
    // https://github.com/tModLoader/tModLoader/tree/stable/ExampleMod
    public class Excalibur : ModItem
    {
        // The Display Name and Tooltip of this item can be edited in the 'Localization/en-US_Mods.MyFirstMod.hjson' file.
        public override void SetDefaults() {
            Item.damage = 50;
            Item.DamageType = DamageClass.Melee;
            Item.width = 40;
            Item.height = 40;
            Item.useTime = 20;
            Item.useAnimation = 20;
            Item.useStyle = ItemUseStyleID.Swing;
            Item.knockBack = 6;
            Item.value = Item.buyPrice(silver: 1);
            Item.rare = ItemRarityID.Blue;
            Item.UseSound = SoundID.Item1;
            Item.autoReuse = true;
        }

        public override void AddRecipes() {
            Recipe recipe = CreateRecipe();
            recipe.AddIngredient(ItemID.DirtBlock, 10);
            recipe.AddTile(TileID.WorkBenches);
            recipe.Register();
        }
    }
}

那我们现在加载Mod，并且进入游戏
建造一个工作台，并且使用10个土块，即可制造我们的初始之剑
50点伤害有点不够看啊，那我们现在修改一下武器伤害以及攻击间隔，随后重新构建并加载我们的Mod，然后再次进入游戏

using Terraria;
using Terraria.ID;
using Terraria.ModLoader;

namespace MyFirstMod.Content.Items
{
    public class Excalibur : ModItem
    {
        public override void SetDefaults() {
-           Item.damage = 50;
+           Item.damage = 99999999;
            Item.DamageType = DamageClass.Melee;
            Item.width = 40;
            Item.height = 40;
-           Item.useTime = 20;
-           Item.useAnimation = 20;
+           Item.useTime = 5;
+           Item.useAnimation = 5;
            Item.useStyle = ItemUseStyleID.Swing;
            Item.knockBack = 6;
            Item.value = Item.buyPrice(silver: 1);
            Item.rare = ItemRarityID.Blue;
            Item.UseSound = SoundID.Item1;
            Item.autoReuse = true;
        }

        public override void AddRecipes() {
            Recipe recipe = CreateRecipe();
            recipe.AddIngredient(ItemID.DirtBlock, 10);
            recipe.AddTile(TileID.WorkBenches);
            recipe.Register();
        }
    }
}

在这里可以配置Mod物品的显示名称和提示信息。

# This file will automatically update with entries for new content after a build and reload.

Items: {
  Excalibur: {
    DisplayName: "Excalibur"
    Tooltip:
      '''
      Template of an item
      Replacing this tooltip is duty 
      It's snowing on Mt.Fuji
      '''
  }
}

修改初始之剑的名称以及描述

Items: {
  Excalibur: {
    DisplayName: Hello World!
    Tooltip: 代码之力，小子！
  }
}

Basic Item

本小节旨在解释所有Item之间的共同点。

什么是物品（What is an Item）？

了解物品（Item）、抛射物（Projectiles）和方块（Tiles）之间的区别非常重要。刚开始时，如果你不清楚它们的不同之处，可能会无意中混淆概念。例如，有些人可能会混淆并试图将工作台物品（Item）添加到配方中，而实际上他们想要添加的是工作台方块（Tile）。还需要意识到，像回旋镖武器这样的东西实际上由物品和抛射物组成。虽然这是一个简单的概念，但请记住这一点。

制作物品（Making an Item）

要将物品添加到泰拉瑞亚，我们首先必须创建一个类，该类需要继承ModItem，实际上上面小节中的[ModName].cs就是个样例，在创建Mod的时候已经为我们生成了一把剑的物品。

设置默认值

物品最重要的部分是 SetDefaults。SetDefaults 是设置物品属性的地方，例如物品使用什么弹药、物品的大小以及物品放置的是哪个方块。请参阅 Item 类文档，了解在 SetDefaults 中常见的设置值的含义。你还可以通过访问 Vanilla Item 来查看原版物品字段值。

本地化

构建你的 Mod 后，本地化文件通常位于 My Games\Terraria\tModLoader\ModSources\MyModName\Localization\en-US_Mods.MyModName.hjson，将会填充有新添加物品的条目。对于物品，你会看到 DisplayName 和 Tooltip 的条目。DisplayName 将默认为类名，单词之间用大写字母分隔。Tooltip 默认为空。你可以编辑此文件以自定义这些本地化内容：

Items: {
  NameHere: {
    DisplayName: Name Here
    Tooltip: This is a modded item.
  }
}

Basic Projectile

在学习向量以及计算几何的知识之前，最好能先创建一个自己的弹幕。这样我们可以通过这个弹幕观察到数学是如何发挥作用的。

弹幕基础

什么是Projectile

在开始修改弹幕之前，我们需要先了解物品和弹幕之间的区别。物品是可以存储在库存中（例如背包、箱子等）的对象，而弹幕时从武器或者敌人射出的对象，例如子弹、箭等。

什么情况下会使用弹幕？

在泰拉瑞亚中，许多物品因为弹幕的存在而具有功能性，例如枪和弓（子弹和箭）、激光、炸弹和其他投掷物品，以及大多数魔法武器，甚至一些抓钩、连枷、长矛、宠物、召唤物、钻头和悠悠球，也会生成弹幕。很多敌怪也可以生成弹幕。

创建基本弹幕

在创建弹幕之前，我们最好先规范一下目录结构，为后续所有的弹幕建立一个单独的文件夹，名为Porjectiles；同时也为刚刚的剑创建一个单独的文件夹，名为Sowrds。
随后在Projectiles目录下创建[ProjectileName].cs和[ProjectileName].png（弹幕贴图）文件。创建弹幕时，我们需要继承ModProjectile类，同时需要实现SetDefaults方法，SetDefaults方法中需要设置弹幕的属性，例如弹幕的大小、弹幕的速度、弹幕的伤害、弹幕的伤害类型等。
下面代码中的namespace需要替换为你自己的模组文件夹名/命名空间。

using Terraria;
using Terraria.ID;
using Terraria.ModLoader;

namespace MyFirstMod.Content.Items.Projectiles
{
    public override void SetDefaults()
    {
      Projectile.arrow = true;
      Projectile.width = 10;
      Projectile.height = 10;
      Projectile.aiStyle = ProjAIStyleID.Arrow;
      Projectile.friendly = true;
      Projectile.DamageType = DamageClass.Ranged;
      AIType = ProjectileID.WoodenArrowFriendly;
    }

    // Additional hooks/methods here.
}

应用弹幕

请记住，物品和弹幕是不同的。一个常见的错误是，模组开发者创建了一个弹幕，却不了解还需要创建一个使用该弹幕的东西。例如，对于投掷飞刀武器，您需要同时创建一个物品和一个弹幕。弹药物品也需要有一个独特的弹幕与之关联。如果弹幕是由NPC生成的，您不总是需要同时创建物品和弹幕。测试弹幕的最简单方法是创建一个物品，并将 Item.shoot 设置为弹幕。
1
Item.shoot = ModContent.ProjectileType<MyProjectile>();

在刚刚我们已将创建好了一个弹幕，现在我们将其作用于武器上

+ using MyFirstMod.Content.Items.Projectiles;
using Terraria;
using Terraria.ID;
using Terraria.ModLoader;

namespace MyFirstMod.Content.Items.Swords
{
    public class Excalibur : ModItem
    {
        public override void SetDefaults() {
            Item.damage = 99999999;
            Item.DamageType = DamageClass.Melee;
            Item.width = 40;
            Item.height = 40;
            Item.useTime = 5;
            Item.useAnimation = 5;
            Item.useStyle = ItemUseStyleID.Swing;
            Item.knockBack = 6;
            Item.value = Item.buyPrice(silver: 1);
            Item.rare = ItemRarityID.Blue;
            Item.UseSound = SoundID.Item1;
            Item.autoReuse = true;
+           Item.shoot = ModContent.ProjectileType<MyFirstProjectile>();
        }

        public override void AddRecipes() {
            Recipe recipe = CreateRecipe();
            recipe.AddIngredient(ItemID.DirtBlock, 10);
            recipe.AddTile(TileID.WorkBenches);
            recipe.Register();
        }
    }
}

重新编译并加载Mod，进入游戏，挥舞武器，可以看到我们刚刚制作的弹幕已经生成了。

SetDefaults

弹幕最重要的部分是SetDefaults方法。该方法是设置弹幕值的地方，例如命中宽度和高度、弹幕是友军还是敌军、以及弹幕将使用哪个AI。请参阅弹幕类文档以了解通常设置的值的含义。还可以通过放温暖Vanilla弹幕字段值来查看Vanilla弹幕值。

Projectile.Damage

一个常见的错误是在SetDefaults中设置Projectiles.Damage，这不起作用，因为弹幕的伤害值总是被生成弹幕时传递给Projectile.NewProjectile的值覆盖。通常，生成弹幕的物品或NPC将决定伤害值。

Other Hooks/Methods

ModProjectile文档列出了许多其他钩子/方法，您可以使用它们生成独特的弹幕。例如在弹幕击中敌人时施加减益效果，可以使用OnHitNpc方法，要在弹幕击中物块时做些事情，可以使用OnTileCollide方法。

What is AI

弹幕的AI是弹幕最重要的方面，它控制弹幕在生成后如何移动和行动，对于新手模组开发者来说，最简单的方法是通过设置Projectile.aiStyle = #和AIType = ProjectileID.NameHere来一来其他原版弹幕已经使用的AI代码。你分配给Projectile.aiStyle的值应该与ProjectileID.NameHere的值相匹配。这杯成为模仿原版弹幕。
随着你对更高级的弹幕移动行为的需求，你会发现模仿原版弹幕AI非常有限，所以下面我们将讨论如何自定义AI。

使用原版AI

我们可以使用原版AI来初始化我们的弹幕。让我们制作一个回旋镖，使用和原版回旋镖弹幕相同的aiStyle。我们可以在中查找回旋镖弹幕，可以看到原版回旋镖使用的aiStyle为3。
那么我们可以在代码中使用Projectile.aiStyle = 3;，或者将3改为ProjectileID.Boomerang，增强代码的可读性。
为了让这个回旋镖更简单，我们可以使用Projectile.CloneDefaults(ProjectileID.EnchantedBoomerang);，这将复制所有其他的默认值。这样，你将获得一个与原版回旋镖行为相同的弹幕。
通过设置AIType可以改变弹幕的粒子特效。

请注意，武器贴图请自行解决。

using MyFirstMod.Content.Items.Projectiles;
using Terraria;
using Terraria.ID;
using Terraria.ModLoader;

namespace MyFirstMod.Content.Items.Boomerangs
{
    public class MyFirstBoomerang : ModItem
    {
        public override void SetDefaults() {
            Item.damage = 99999999;
            Item.DamageType = DamageClass.Melee;
            Item.width = 40;
            Item.height = 40;
            Item.useTime = 5;
            Item.useAnimation = 5;
            Item.useStyle = ItemUseStyleID.Swing;
            Item.knockBack = 6;
            Item.value = Item.buyPrice(silver: 1);
            Item.rare = ItemRarityID.Blue;
            Item.UseSound = SoundID.Item1;
            Item.autoReuse = true;
            // 重点是这一行，指定弹幕类型
            Item.shoot = ModContent.ProjectileType<BoomerangProjectileDemo>();
            Item.shootSpeed = 10f;
        }

        public override void AddRecipes() {
            Recipe recipe = CreateRecipe();
            recipe.AddIngredient(ItemID.DirtBlock, 10);
            recipe.AddTile(TileID.WorkBenches);
            recipe.Register();
        }
    }
}

using Terraria;
using Terraria.ID;
using Terraria.ModLoader;

namespace MyFirstMod.Content.Items.Projectiles
{
    public class BoomerangProjectileDemo : ModProjectile
    {
        public override void SetDefaults()
        {
            Projectile.width = 10;
            Projectile.height = 10;
            Projectile.aiStyle = ProjAIStyleID.Boomerang;
            Projectile.friendly = true;
            Projectile.DamageType = DamageClass.Ranged;
            AIType = ProjectileID.WoodenArrowFriendly;
        }

        // Additional hooks/methods here.
    }
}

using Terraria;
using Terraria.ID;
using Terraria.ModLoader;

namespace MyFirstMod.Content.Items.Projectiles
{
    public class BoomerangProjectileDemo : ModProjectile
    { 
        public override void SetDefaults()
        {
            Projectile.CloneDefaults(ProjectileID.EnchantedBoomerang);
            AIType = ProjectileID.EnchantedBoomerang;
        }

        // Additional hooks/methods here.
    }
}

重新编译并加载Mod，进入游戏，我们就可以使用10个土块在工作台旁制作我们刚刚编写的回旋镖了。亲测手感和原版几乎无异（虽然我也不怎么用回旋镖武器就是了）。

自定义AI

本小节将讨论你可以在AI中添加的元素，记得如果使用Projectile.CloneDefaults复制其他弹幕默认值，要将Projectile.aiStyle的值设回0。所有自定义AI的代码都放在ModProjectile.AI方法中。也就是重写AI()方法

using Terraria;
using Terraria.ID;
using Terraria.ModLoader;

namespace MyFirstMod.Content.Items.Projectiles
{
    public class MyFirstProjectile : ModProjectile
    {
        public override void SetDefaults()
        {
            Projectile.arrow = true;
            Projectile.width = 10;
            Projectile.height = 10;
            Projectile.aiStyle = ProjAIStyleID.Arrow;
            Projectile.friendly = true;
            Projectile.DamageType = DamageClass.Ranged;
            AIType = ProjectileID.WoodenArrowFriendly;
        }

        // Additional hooks/methods here.

        // 重写此方法，自定义AI
        public override void AI()
        {
            base.AI();
            // Additional code here.
        }
    }
}

Timers

Timers：计时器
许多弹幕使用计时器来延迟动作。通常我们使用Projectile.ai[0]或Projectile.ai[1]，因为这些值会自动同步，这里我们计数到30，换句话说，半秒。

Projectile.ai[0] += 1f;
if (Projectile.ai[0] >= 30f)
{
    // 半秒过去了。重置计时器等。
    Projectile.ai[0] = 0f;
    Projectile.netUpdate = true;
    // 在这里做点什么，也许改变到新状态。
}

Gravity

Gravity：重力
弹幕实际上没有重力，每个带有重力移动的弹幕实际上是它们的AI代码实现了重力。要实现重力，只需要在Projectile.velovity.Y中添加一个小值。

Projectile.velocity.Y = Projectile.velocity.Y + 0.1f; // 0.1f 是箭的重力，0.4f 是飞刀的重力
if (Projectile.velocity.Y > 16f) // 这个检查实现了“终端速度”。我们不希望弹幕越来越快。
{
    Projectile.velocity.Y = 16f;
}

根据上述的计时器和重力的设定，我们现在可以写一个延迟重力效果

Projectile.ai[0] += 1f; // 使用计时器等待15个刻度后再应用重力。
if (Projectile.ai[0] >= 15f)
{
    Projectile.ai[0] = 15f;
    Projectile.velocity.Y = Projectile.velocity.Y + 0.1f;
}
if (Projectile.velocity.Y > 16f) // 终端速度检查，设置弹幕速度不超过16像素/帧。
{
    Projectile.velocity.Y = 16f;
}

Wind Resistance

Wind Resistance：风阻
纵向的加速度是重力控制的，那么横向的加速度是风阻控制的。
通过减少Projectile.velocity.X的乘积系数，我们可以轻松实现风阻。结合计时器，我们同样可以让弹幕越来越慢，实现类似蜜蜂手雷的效果。（打肉山的时候，在平台扔蜜蜂手雷，一开始速度蛮快的，但是会越来越慢，直至爆炸）

Projectile.ai[0] += 1f;
if (Projectile.ai[0] >= 15f) {
    // 这里的示例没有加上重力，无伤大雅
    Projectile.velocity.X = Projectile.velocity.X * 0.97f;
}

Rotation

Rotation：旋转

恒定旋转

我们可以在AI中添加Projectile.rotation使其想回旋镖一样旋转。

1	Projectile.rotation += 0.4f * Projectile.direction;

泰拉瑞亚Mod开发指南

Hello World

Mod制作准备

.NET环境安装

TModLoader的介绍与安装

源码Mod和TML Mod的区别

TModLoader的安装

第一个Mod

Basic Item

什么是物品（What is an Item）？

制作物品（Making an Item）

设置默认值

本地化

Basic Projectile

弹幕基础

什么是Projectile

什么情况下会使用弹幕？

创建基本弹幕

应用弹幕

SetDefaults

Projectile.Damage

Other Hooks/Methods

What is AI

使用原版AI

自定义AI

Timers

Gravity

Wind Resistance

Rotation

恒定旋转

面向前方

自定义坐骑