TModLoader on 南亭

tModLoader 认识一下Shader

Mon, 03 Nov 2025 16:22:00 +0800

如果要使用着色器建议Begin时设置BlendState 为 BlendState.NonPremultiplied

语义
SV_POSITION	float4	作为像素作色器输入	顶点在其次座标系 xyzw 中的位置
COLOR0	float4	作为像素着色器输入	顶点的RGBA颜色
TEXCOORD0	float2	作为像素着色器输入	纹理uv坐标

Effect的引入

private const string shader = "path";
public static Asset<Effect> Bloom { get; private set; }
static EffectAssets()
{
    Bloom = GetEffect(nameof(Bloom));
}
public static Asset<Effect> GetEffect(string name)
{
    return Request<Effect>($"{shader}{name}");
}

//其实就一行
Request<Effect>("Path");

Effect的应用时机

//在Begin的时候说明要使用的Effect
spriteBatch.Begin(effect: exampleEffect);

//在Begin后的Draw中将会实际应用
spriteBatch.Draw(exampleTexture, texturePosition, Color.White);
spriteBatch.DrawString(exampleFont, "Hello World", textPosition, Color.White);

// For most SpriteSortMode values, actual drawing with the effect happens here
//对于 SpriteSortMode 值的效果，会在End() 时生效
spriteBatch.End();

Effect的参数更改

立即模式

// 指定Immediate 这回造成严重的性能问题
spriteBatch.Begin(effect: exampleEffect, sortMode: SpriteSortMode.Immediate);

// 更改Effect参数值，这会立即生效并应用！
exampleEffect.Parameters["ExampleParameter"].SetValue(1.0f);
spriteBatch.Draw(texture1, position, color);

// 再次更改 也会立即生效
exampleEffect.Parameters["ExampleParameter"].SetValue(0.5f);
spriteBatch.Draw(texture2, position, color);

// 由于处于立即模式，此end的作用也只有结束
spriteBatch.End();

批处理模式

// 默认使用批处理，因此只有当调用End时才会实际应用效果
spriteBatch.Begin(effect: exampleEffect);

// 更改参数并绘制内容
exampleEffect.Parameters["ExampleParameter"].SetValue(1.0f);
spriteBatch.Draw(texture1, position, color);

// 更改参数并绘制其他内容
exampleEffect.Parameters["ExampleParameter"].SetValue(0.5f);
spriteBatch.Draw(texture2, position, color);

// 对于Effect的参数值，只有在调用End时才会应用
// 也代表 0.5f 会应用于两次绘制
// 而不是每次调用都使用不同的值
spriteBatch.End();

灰度fx

sampler uImage0 : register(s0); // 原图像
float Saturation; //灰度的强度，0全色 1全灰

struct PSINPUT{
    float4 pos : SV_POSITION;   //顶点在其次座标系 xyzw 中的位置
    float4 color : COLOR0;      //颜色
    float2 uv : TEXCOORD0;      //纹理uv坐标
};

float4 Gray(PSINPUT input) : COLOR
{
    //对材质采样
    float4 color = tex2D(uImage0, input.uv);

    //计算灰度值
    float grayscale = dot(color.rgb, float3(0.3, 0.59, 0.11));

    //创建灰色
    // float3 graycolor = float3(grayscale, grayscale, grayscale);

    //利用灰度值在给定的强度间进行平滑计算
    float3 finalcolor = lerp(grayscale, color.rgb, Saturation);

    //不干扰透明度 只干扰颜色
    return float4(finalcolor, color.a);
}

technique GrayDraw
{
    pass p0
    {
        PixelShader = compile ps_2_0 Gray();
    }
}

计算亮度fx

sampler uImage0 : register(s0); // 原图像
float Intensity = 0.6; //亮度强度

struct PSINPUT
{
    float4 pos : SV_POSITION;   //顶点在其次座标系 xyzw 中的位置
    float4 color : COLOR0;      //颜色
    float2 uv : TEXCOORD0;      //纹理uv坐标
};

// 计算亮度的方法
float CountLight(float4 color)
{
    return 0.2125 * color.r + 0.7154 * color.g + 0.0721 * color.b;
}
// 像素着色器：接收结构体
float4 PixelLight(PSINPUT input) : COLOR0
{
    float4 color = tex2D(uImage0, input.uv);
    float val = clamp(CountLight(color) - Intensity, 0.0, 1.0);
    return color * val;
}

technique Technique1
{
    pass Pass1
    {
        PixelShader = compile ps_2_0 PixelLight();
    }
}

tModLoader 自绘UI中的位置计算问题

Fri, 17 Oct 2025 16:00:00 +0800

自绘UI中的位置计算问题

我们在类型中属性对于的值一般都是原始数值，而SpriteBatch.Draw()在SpriteBatch.Begin()中指定了变换矩阵。因此如果需要正确处理点击时的位置，应当将使用宽高创建的向量，使用SpriteBatch.Begin()中的矩阵进行变换。

如下，在绘制时采用了Main.UIScaleMatrix

public sealed override void DrawSelf(SpriteBatch spriteBatch)
{
    spriteBatch.End();
    spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.Additive, SamplerState.PointClamp, DepthStencilState.Default, RasterizerState.CullNone, null, Main.UIScaleMatrix);
    foreach (var item in entitys) {
        ReLogic.Graphics.DynamicSpriteFontExtensionMethods.DrawString(
            spriteBatch,
            FontAssets.MouseText.Value,
            item?.ToString() ?? "",
            GetItemPosition(item!),
            Color.White,
            0f,
            Vector2.Zero,
            1f,
            SpriteEffects.None,
            1f
            );
    }
    spriteBatch.End();
    spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.Opaque, SamplerState.PointClamp, DepthStencilState.Default, RasterizerState.CullNone, null, Main.UIScaleMatrix);
}

/// <summary>
/// 获取此实体需要绘制的位置
/// <code>
/// (index + 1) * ItemHeight + ItemVerticalSpacing
/// </code>
/// </summary>
private Vector2 GetItemPosition(Entity entity) => GetItemPosition(entitys.FindIndex(f => f.Equals(entity)));

/// <summary>
/// 获取此索引对应实体绘制的位置
/// <code>
/// (index + 1) * ItemHeight + ItemVerticalSpacing
/// </code>
/// </summary>
/// <returns></returns>
private Vector2 GetItemPosition(int index)
{
    //1. 先计算此元素在列表中的索引 然后根据索引计算其左上角位置
    _ = Main.UIScaleMatrix;

    //数量 * 元素高度 + 元素间距
    var itemOffset = new Vector2(0, index * ItemHeight + ItemVerticalSpacing); //TODO 现在X是没变的
    var origOffset = new Vector2(LeftPadding, TopPadding);

    return origOffset + itemOffset ;//origOffset + itemOffset;
}

但我在进行进行点击碰撞检测的时候，认为是鼠标坐标计算矩阵的问题，是我在进行点击碰撞检测的代码中，直接使用了GetItemPosition的值

原始代码

1
2
3

var itemPosition = GetItemPosition(item);
rectangle.X = (int)itemPosition.X;
rectangle.Y = (int)itemPosition.Y;

修正后的完整代码

/// <summary>
/// 鼠标是否点击元素
/// </summary>
private Entity? IsMouseClickItem(Vector2 mousePosition)
{
    //1. 计算变换后的UI大小
    //2. 遍历列表元素 并判断鼠标位置是否进行碰撞
    //鼠标位置使用 Main.GameViewMatrix.ZoomMatrix 矩阵
    //列表元素统一使用 Main.UIScaleMatrix

    //TODO 绘制使用了矩阵 这里计算也要 不然会偏移
    var newv2 = Vector2.Transform(new Vector2(ItemWidth, ItemHeight), Main.UIScaleMatrix);

    var rectangle = new Rectangle(0, 0, (int)newv2.X, (int)newv2.Y);
    foreach (var item in entitys) {
        //绘制位置未应用矩阵，因为在Begin中已经指定
        //如果要将未应用矩阵的元素与应用了矩阵的元素比较，会造成偏移
        //消除偏移 需要手动应用矩阵
        var itemPosition = GetItemPosition(item);
        itemPosition = Vector2.Transform(itemPosition, Main.UIScaleMatrix);
        rectangle.X = (int)itemPosition.X;
        rectangle.Y = (int)itemPosition.Y;
#if DEBUG
        TeachMod.Mod!.Logger.Debug($"{rectangle} {MouseRectangle}");
#End if
        if (CheckAABBvAABBCollision(rectangle, MouseRectangle)) {
            ItemClickEvent?.Invoke(new ItemClickEventArgs(item, this, mousePosition));
        }
    }
    return null;
}

tModLoader 零群问题收纳

Sat, 16 Aug 2025 18:40:00 +0800

2025/08/11

模组联动中其他模组类型`Type`获取问题

引入目标模组程序集

1
2
3

1. 使用isual Studio打开模组的项目文件 csproj
2. 在解决方案资源管理器中右键项目文件
3. 添加 -> 引用 -> 下方浏览 -> 找到目标程序集 -> 确定 -> 双击项目文件 -> CTRL + S保存

在代码文件中使用

添加目标模组的物品作为我的物品合成配方

public override void AddRecipes()
{
    CreateRecipe()
        //添加天蓝锭, 数量100, 其实与使用自己的物品作为材料是一致的
        //如果显示 AerialiteBar类型未找到,需要检查目标程序集是否被正确引用
        .AddIngredient(ModConten.ItemType<AerialiteBar>(), 100)
        .Register()
        ;

}

2025/08/12

无Key物块合成站汉化问题

后面的结果

javidpack说他会修这个

public class AddMissingTileMapEntriesSystem : ModSystem
{
    public override void Load()
    {
        Lang._mapLegendCache[MapHelper.TileToLookup(TileID.BlooMoonMonolith, 0)] = Lang.GetItemName(ItemID.BloodMoonMonolith);
    }
    
    public override void Unload()
    {
        Lang._mapLegendCache[MapHelper.TileToLookup(TileID.BlooMoonMonolith, 0)] = LocalizedText.Empty;
    }
    
}

一开始

使用TileID.Search，例如血月天塔柱的合成站是无文本的，会被替换为英文
1 2

TileID.Search.Remove(480); TileID.Search.Add("血月天塔柱", 480);

直接删除此合成表所需的制作站，替换为条件

public class Update : ModSystem
{
    public static Condition condition =
        new Condition(Language.GetOrRegister(Guid.NewGuid().ToString(), () => "血月天塔柱"), () => Main.player[Main.myPlayer].adjTile[480]);

    public override void PostAddRecipes()
    {
        _ = Main.recipe
            .Where(r => r.HasTile(480))
            .Select(r => {
                r.RemoveTile(480);
                r.AddCondition(condition);
                return 1;
            })
            .ToArray()
            ;
        base.PostAddRecipes();
    }
}

如何监听护士治疗等(未试验)

类	方法	回答场景
ModPlayer	PostNurseHeal	监听护士治疗
搜索breath		水中窒息
ModPlayer	UpdateBadLifeRegen	判断lifeRegen值负数就是回复跟不上`debuff`

2025/08/13

其他玩家受伤也调用方法问题

其他玩家的行为导致的方法调用，从而达到计划之外的内容

在代码中使用if(Main.myPlayer == player.whoAmI) 只有本地玩家触发此方法才调用

世界生成时如何生成NPC

public class WorldGenNPCSystem : ModSystem
{
    public override void ModifyWorldGenTasks(List<GenPass> tasks, ref double totalWeight)
    {
        var task = tasks.FindIndex(f => f.Name == "Guide"); //向导
        tasks.Insert(task, new WorldGenNPCSystemGenPass("SpawnDemolitionist", 1.0));
        base.ModifyWorldGenTasks(tasks, ref totalWeight);
    }

    public override void PreWorldGen()
    {
        base.PreWorldGen();
    }

    public class WorldGenNPCSystemGenPass : GenPass
    {
        public WorldGenNPCSystemGenPass(string name, double loadWeight) : base(name, loadWeight)
        {
        }

        protected override void ApplyPass(GenerationProgress progress, GameConfiguration configuration)
        {
            //实际 直接生成就好了
            int entityId = NPC.NewNPC(new EntitySource_WorldGen(), Main.spawnTileX * 16, Main.spawnTileY * 16, NPCID.Demolitionist);
            Main.npc[entityId].homeTileX = Main.spawnTileX;
            Main.npc[entityId].homeTileY = Main.spawnTileY;
            Main.npc[entityId].direction = 1;
            Main.npc[entityId].homeless = true;
        }
    }
}

2025/08/14

关于静态类

IL层面其实是sealed abstract250343

加载XNB字体

`1`	`private static Asset<DynamicSpriteFont> font = ModContent.Request<DynamicSpriteFont>("ModName/华文细黑", AssetRequestMode.ImmediateLoad);`

2025/08/15

关于Dust的问题

在ModDust的MidUpdate里，无论最后是return true（不跑原版dust update）还是return false（跑原版dust update），都无法正常操作dust.fadein 想要像npc或proj的ai[n]一样操作fadein，请使用ModDust的Update updatetype是不是-1都有问题

如果想写一个完全属于自己的Dust就需要在Update返回false

2025/08/16

模组加载顺序问题

好的我无法分析

ModA:
displayName = A
author = a
sortAfter = B

ModB:
displayName = B
author = b
weakReferences = C
side = NoSync

ModC:
displayName = C
author = c

螺线: 
	有B是 -> CBA
	没有B是 -> AC
	A和C都是Both,所以可能会错位
	B换成client也一样
	反正都是可能加载可能不加载的意思
	
依稀:
	这里报错是要求如果你sortafter一个client或者nosync的话，就必须sortafter那个模组的一切引用
	按照螺线说的情况，确实必须这么要求
	
螺线:
	比如我模组本身是内容向，需要Both
	但是我需要用一个UI库
	而UI库这种东西其实Client就行了
	这种时候是不是可以把UI库标NoSync
	这样Both的模组引用的时候服务端加载
	只有Client模组引用的时候就客户端加载就够了
	我觉得NoSync应该这么用

音频播放的位置移动

音频在生成后更改其位置可以改变播放位置

public class SoundPlayer : ModPlayer
{
    public static SlotId slotid;
    public override async void OnEnterWorld()
    {
        var ss = new SoundStyle("ModName/路径"); //wav . mp3 . ogg . xnb 等都行 不需要后缀
        await Task.Delay(1000);
        slotid = SoundEngine.PlaySound(ss);
        base.OnEnterWorld();
    }

    public override void PreUpdate()
    {
        if(SoundEngine.TryGetActiveSound(slotid, out var acs)) {
            acs.Position = Main.MouseWorld;
        }
        base.PreUpdate();
    }
}

已经退出群聊

tModLoader 关于物品收藏的联机同步

Sat, 02 Aug 2025 19:07:00 +0800

由于我未寻找到tModLoader给出相关方法，在物品在收藏时调用，我使用favorited作为关键字查找，最后找到了状态修改的地方，这个是私有方法，被LeftClick调用，隶属于Terraria.UI.ItemSlot，在调用前后均没有看到有钩子的迹象

private static bool OverrideLeftClick(Item[] inv, int context = 0, int slot = 0)
{
	if (Main.cursorOverride == 3) {
		if (!canFavoriteAt[Math.Abs(context)])
			return false;
	
		item.favorited = !item.favorited;
		SoundEngine.PlaySound(12);
		return true;
        
        
        
public static void LeftClick(Item[] inv, int context = 0, int slot = 0)
{
	Player player = Main.player[Main.myPlayer];
	bool flag = Main.mouseLeftRelease && Main.mouseLeft;
	if (flag) {
		if (OverrideLeftClick(inv, context, slot))
			return;

现在我们要求其更改时服务器能收到消息，所以要对他进行挂钩。

[ModuleInitializer]
internal static void HookItemSlot()
{
    On_ItemSlot.OverrideLeftClick += On_ItemSlot_OverrideLeftClick; ;
}

private static bool On_ItemSlot_OverrideLeftClick(On_ItemSlot.orig_OverrideLeftClick orig, Item[] inv, int context, int slot)
{
    var oldFavoritedStatu = inv[slot].favorited;
    var retValue = orig.Invoke(inv, context, slot);
    var newFavoritedStatu = inv[slot].favorited;
    if(oldFavoritedStatu != newFavoritedStatu) {
        var packet = ModLoader.GetMod(nameof(NoNPCSpawn)).GetPacket();
        packet.Write(slot);
        packet.Write(newFavoritedStatu);
        packet.Send();
    }
    return retValue;
}

public override void HandlePacket(BinaryReader reader, int whoAmI)
{
    //这里看需求，如果其他客户端需要知道状态，可进行 (netmode == server) 后转发
    var slot = reader.ReadInt32();
    var newFavoritedStatu = reader.ReadBoolean();
    Main.player[whoAmI].inventory[slot].favorited = newFavoritedStatu;
    base.HandlePacket(reader, whoAmI);
}

如果玩家进入世界前就收藏了物品，需要手动同步一下状态

public class NoNPCSpawnPlayer : ModPlayer
{
    private volatile List<Action> updateExter = [];

    public override void PostUpdate()
    {
        foreach (var action in updateExter) {
            action.Invoke();
        }
        updateExter.Clear();
        base.PostUpdate();
    }

    public override void OnEnterWorld()
    {
        updateExter.Add(SendItemFavorited);
        base.OnEnterWorld();
    }
    private void SendItemFavorited()
    {
        if (Main.netMode == NetmodeID.MultiplayerClient) {
            var packet = ModLoader.GetMod(nameof(NoNPCSpawn)).GetPacket();
            List<int> items = [];
            for (int i = 0; i < Player.inventory.Length; i++) {
                if (Player.inventory[i].favorited) {
                    items.Add(i);
                }
            }
            items.ForEach(f => {
                packet.Write(f);
                packet.Write(true);
                packet.Send();
            });
        }
    }
}

tModLoader 基础饰品

Thu, 13 Mar 2025 21:38:00 +0800

饰品

方法

继承自ModItem

方法名称	用处
UpdateAccessory	实际的饰品效果，只运行一次，但是每游戏刻更新一次

常用加成

更多加成可以CTRL + 左键 进入玩家类查看，主要为字段 / 属性，代码行1550前后，需要注意的是，部分加成使用乘算，因此进行修改时需要使用 *= 1 + %

使用Player.Get可以获得大量加成提示

属性 / 字段名称	作用
GetDamage	获取伤害加成引用
GetCritChance	获取暴击率加成引用
GetArmorPenetration	获取盔甲穿透力引用

public override void SetDefaults()
{
    Item.accessory = true;
}
public override void UpdateAccessory(Player player, bool hideVisual)
{
    player.GetDamage(DamageClass.Generic) *= 1 + 0.5f;
}

Mod Player

使用饰品为玩家提供原版加成是在大多数情况下是次要的，除了伤害加成等，tModLoader为我们提供了 ModPlayer类，可以让开发者自定义玩家属性，从而达到特殊的判定等。例如特殊装备的冷却计时

创建自己的ModPlayer类

`1`	`public class MyModPlayer : ModPlayer{}`

定义自定义 属性 / 字段 例如xxxxTimer 或 bool 类型，对于非bool类型，应当自行控制何时增减，对于bool类型，应当在ResetInfoAccessories方法中将其恢复为默认值，此方法用来重置自定义属性，每游戏刻都会更新一次，但是在所有加成完成之后，否则饰品效果自然无效了
1 2 3 4 5 6 7

public int NewTextTimer = 0; public bool Yes = false; public override void ResetInfoAccessories() { Yes = false; }

在饰品的UpdateAccessory中，更改 / 使用自定义的玩家属性，也可以在ModPlayer提供的virtual方法中执行这些操作，下面的代码示例，当玩家佩戴次饰品时，我们自定义的Yes字段被设置为true，并且设置NewTextTimer每游戏刻自增1

public override void UpdateAccessory(Player player, bool hideVisual)
{
    player.GetDamage(DamageClass.Generic) *= 1 + 0.5f;
    var modPlayer = player.GetModPlayer<MyModPlayer>();
    modPlayer.Yes = true;
    if(modPlayer.NewTextTimer < 60)
        modPlayer.NewTextTimer++;
}

效果我们可以直接在UpdateAccessory里面写，也可以在ModPlayer的UpdateEquips方法中，或者其他任何你想进行的地方，只需要你确保，你应用的方法在此字段被恢复为默认值之前就可。加成不建议写每游戏刻运行一次的方法，而是写在每游戏刻更新一次的方法。可以写一个简单绘制，如果绘制没有按照预期绘制，但是此方法内的Main.NewText却一直运行，那大概率是目标方法了。

public override void UpdateEquips()
{
    //Player.inventory 玩家背包
    if (Yes) Player.statLifeMax2 += 100;
    if (NewTextTimer >= 60) {
        CombatText.NewText(new((int)Player.Center.X, (int)Player.Center.Y, 20, 20), Color.Aqua, "60！");
        NewTextTimer = 0;
    }
    base.UpdateEquips();
}

本地化

对于饰品，进行加成本地化时有两种方法，一种是直接写死在hjson文件中，另一种是在代码中传值，可以保证本地化显示与实际同步，强烈建议是在代码中传值，hjson中使用占位符

Items: {
	TestAss: {
		DisplayName: Test Ass
		Tooltip: 
		'''
		增加{0}生命上限
		每{1}秒跳字
		'''
	}
}

public class TestAss : ModItem
{
    public override LocalizedText Tooltip => base.Tooltip.WithFormatArgs(100, 1);
}

这样写后是，效果与相同，实际上这两个数字可以使用变量 / 属性进行存储

1
2

增加100生命上限
每1秒跳字

1
2
3

public static int addMaxLife = 100;
public static int textTimer = 60;
public override LocalizedText Tooltip => base.Tooltip.WithFormatArgs(addMaxLife, textTimer / 60);

相应的，加成部分需要使用这两个字段来进行加成

public override void UpdateAccessory(Player player, bool hideVisual)
{
    if(modPlayer.NewTextTimer < textTimer)
    modPlayer.NewTextTimer++;
}
public override void UpdateEquips()
{
    //Player.inventory 玩家背包
    if (Yes) Player.statLifeMax2 += TestAss.addMaxLife;
    if (NewTextTimer >= TestAss.textTimer)
}

甚至可以将加成字段统一管理起来，这个就看个人喜好了。

tModLoader 类似打字机的文本出现

Sat, 08 Mar 2025 15:09:00 +0800

1.前提准备

要绘制文字，首先得寻找一个绘制的地方，我这里使用PlayerDrawLayer，还得定义要绘制的文字，我这里使用要被显示的全部文本，你猜怎么着

首先创建一个继承PlayerDrawLayer的类，并定义一个string存放文本，PlayerDrawLayer是有要求实现两个方法。

GetDefaultPosition，实现就行，他决定绘制的图层

Draw确切的要绘制的地方

public class ModPlayerLayer : PlayerDrawLayer
{
 	private string drawString = "要被显示的全部文本，你猜怎么着";   
	public override Position GetDefaultPosition() //决定绘制的图层
	{
		return new BeforeParent(PlayerDrawLayers.HandOnAcc);
	}
    
    protected override void Draw(ref PlayerDrawSet drawInfo)
    {
        
    }
    
}

2.开始绘制

准备好类之后就可以开始绘制了，主要代码都写在Draw方法里面，为了让文本是一会出一个，我们可以使用一个定时器，这个定时器决定什么情况下让显示的文本字符+1，或者直接使用这个定时器决定要显示的文本长度

private int timer = 0;
protected override void Draw(ref PlayerDrawSet drawInfo)
{
	timer++;
    int length = drawString.Length; //文本的长度
    var viewCount = timer / 10 % (length + 1); //要被绘制的字符数量
}

在决定好要绘制字符数量后，我们就可以对字符串进行截取了并绘制了，使用string.Substring可以对字符串进行截取。绘制有一个参数是位置，它是基于屏幕坐标的，决定了绘制的位置，这里使用玩家中心。

1
2

string draw = drawString.Substring(0, viewCount);//真实要绘制的字符
var DrawPos = drawInfo.drawPlayer.Center - Main.screenPosition; //世界坐标 - 屏幕坐标 = 此世界坐标在屏幕的位置

可以使用Utils中的方法进行文本的绘制，绘制大型文字可以使用DrawBorderStringBig，普通文本可以使用DrawBorderString

`1`	`Utils.DrawBorderStringBig(Main.spriteBatch, draw, DrawPos, Color.Red);`

如果想让文本居中，可以使用一些计算，达到类似的效果。下面是全部代码(或许可以使用yield ？)

private int timer = 0;
private bool IsViewShu = true;
private string drawString = "要被显示的全部文本，你猜怎么着";
protected override void Draw(ref PlayerDrawSet drawInfo)
{
    timer++;
    int length = drawString.Length;                                                 //文本长度
    var DrawPos = drawInfo.drawPlayer.Center - Main.screenPosition;
    var viewCount = timer / 10 % (length + 1);                                   //显示数量
    string draw = drawString.Substring(0, viewCount);                      //真实显示的文本
    DrawPos += new Vector2(-viewCount * (50 - viewCount), -100f);                 //绘制位置调整 需要微调 / 计算

    #region 最后的 | 符号
    if (IsViewShu) draw += "I";
    if (timer % 30 == 0) IsViewShu = false;
    if (timer % 60 == 0) IsViewShu = true;
    #endregion
    Utils.DrawBorderStringBig(Main.spriteBatch, draw, DrawPos, Color.Red, 1.5f);
}

tModLoader 动态更改显示文本(多语言切换)

Wed, 05 Mar 2025 18:40:00 +0800

参考方法LocalizationLoader.LoadModTranslations(culture)

如果要更改值，那就 lang.GetText(Key).SetValue(value);

var lang = LanguageManager.Instance;
foreach (var mod in ModLoader.Mods) {
	foreach (var (key, value) in LoadTranslations(mod, culture)) {
        //lang.GetText(Key)返的是LocalizatText
		lang.GetText(key).SetValue(value); // can only set the value of existing keys. Cannot register new keys.
	}
}

参考方法LocalizationLoader.LoadTranslations这里是解析hjson的逻辑，我们无法直接调用此方法，因为GameCulture是当前语言，并不包含繁体中文，并且使用编译时就确定的枚举值，如果使用Unknown，那么只支持一种外部语言

private static List<(string key, string value)> LoadTranslations(Mod mod, GameCulture culture){}

//下面是GameCulture
public enum CultureName
{
	English = 1,
	German = 2,
	Italian = 3,
	French = 4,
	Spanish = 5,
	Russian = 6,
	Chinese = 7,
	Portuguese = 8,
	Polish = 9,
	Unknown = 9999
}
static GameCulture()
{
	_NamedCultures = new Dictionary<CultureName, GameCulture> {
		{ CultureName.English, new GameCulture("en-US", 1) },
		{ CultureName.German, new GameCulture("de-DE", 2) },
		{ CultureName.Italian, new GameCulture("it-IT", 3) },
		{ CultureName.French, new GameCulture("fr-FR", 4) },
		{ CultureName.Spanish, new GameCulture("es-ES", 5) },
		{ CultureName.Russian, new GameCulture("ru-RU", 6) },
		{ CultureName.Chinese, new GameCulture("zh-Hans", 7) },
		{ CultureName.Portuguese, new GameCulture("pt-BR", 8) },
		{ CultureName.Polish, new GameCulture("pl-PL", 9) }
	};

	DefaultCulture = _NamedCultures[CultureName.English];
}

如果是本就有本地化的模组，只需要保存另外语言的Hjson副本，然后读取内容，使用LocalizationLoader.LoadTranslations中解析的方法

lang是LanguageManager实例，其在LanguageManager中存储

`1`	`public static LanguageManager Instance = new LanguageManager();`

SetValue方法是非public的，需要特殊手段

internal void SetValue(string text)
{
	Value = text;
}

但其实LocalizedText的Value是一个

public string Value {
	get => _value;
	private set {
		_value = value;
		_hasPlurals = null;
		BoundArgs = null;
	}
}

至于GetText是公共的在LanguageManager下

public LocalizedText GetText(string key)
{
	return _localizedTexts.TryGetValue(key, out var text) ? text : new LocalizedText(key, key);
}

//1. 读取Hjson为文本，这是tModLoader使用的方法
using var stream = mod.File.GetStream(translationFile);
using var streamReader = new StreamReader(stream, Encoding.UTF8, detectEncodingFromByteOrderMarks: true);
string translationFileContents = streamReader.ReadToEnd();
//2. 解析为文本后执行 // Parse HJSON and convert to standard JSON注释下的代码
//此注释在 LocalizationLoader.LoadTranslations(Mod mod, GameCulture culture) 方法中
//结果会返回一个 二元组？ 键是key 值是value，该键对应本地化键，然后遍历lang.GetText(Key).SetValue(value);

另一种方法是不使用lang.GetText(Key).SetValue(value)
- 获取LanguageManager实例

public static object LanguageManager;
public override void Load(){
    Type GameCulture = typeof(LanguageManager);
	//在LanguageManager类下有个Instance字段，是自己的实例 公共的
	FieldInfo Instance = GameCulture.GetField("Instance", BindingFlags.Public | BindingFlags.Static);
	LanguageManager = Instance.GetValue(null);
}

其实在LanguageManager类中有一个字段存放着全部的本地化键和值，只需要获取他的实例，然后得到LocalizedText的Value属性的Set方法，就可以随意取值修改内容
1

internal readonly Dictionary<string, LocalizedText> _localizedTexts = new Dictionary<string, LocalizedText>();

public static Dictionary<string, LocalizedText> LocalizedTexts;
public static MethodInfo LocalizedTextSet;
public override void Load(){
	Type LocalizedText = typeof(LocalizedText);
	//全部字段
	FieldInfo Field = GameCulture.GetField("_localizedTexts", BindingFlags.NonPublic | BindingFlags.Instance);
    //获取实例
	LocalizedTexts = (Dictionary<string, LocalizedText>)Field.GetValue(LanguageManager);
    //Set方法
	LocalizedTextSet = LocalizedText.GetProperty("Value").GetSetMethod(true);
}

修改

1
2

LocalizedText Text = LocalizedTexts["ItemName.CopperShortsword"];
LocalizedTextSet.Invoke(Text, ["非常好的铜短剑令我脑袋飞转"]);

对于硬编码，可以使用GetOrRegister注册键然后使用IL钩子，将原本字符串替换为

1
2

Emit(OpCodes.Ldstr, "Key");
Emit(OpCodes.Call, Language.GetTextValue);

tModLoader 禁用给定模组

Mon, 03 Mar 2025 15:46:00 +0800

禁用模组逻辑

单机启用按钮 -> 触发Terraria.ModLoader.UI.Enable方法

internal void Enable()
{
	if (_mod.Enabled) { return; }
	_mod.Enabled = true;
	UpdateUIForEnabledChange();
}

_mod类型是internal Terraria.ModLoader.Core.LocalMod，其中Enabled是一个属性

public bool Enabled {
	get => ModLoader.IsEnabled(Name);
	set => ModLoader.SetModEnabled(Name, value);
}

其调用ModLoader的IsEnabled / SetModEnabled方法

1
2
3

internal static bool IsEnabled(string modName) => EnabledMods.Contains(modName);
internal static void EnableMod(string modName) => SetModEnabled(modName, true);
internal static void DisableMod(string modName) => SetModEnabled(modName, false);

internal static void SetModEnabled(string modName, bool active)
{
	if (active == IsEnabled(modName))
		return;

	Logging.tML.Info($"{(active ? "Enabling" : "Disabling")} Mod: {modName}");
	if (active)
		EnabledMods.Add(modName);
	else
		EnabledMods.Remove(modName);

	ModOrganizer.SaveEnabledMods();
}

UIMods实例在那里?

Terraria.ModLoader.UI.Interface 注意此类访问修饰符为internal
1

internal static UIMods modsMenu = new UIMods();

获取此实例

获取类

1
2
3

Type type = typeof(Main)
    .Assembly.GetTypes()
    .FirstOrDefault(type => type.FullName.Contains("Terraria.ModLoader.UI.Interface"));

通过类获取实例，因为是静态成员，直接获取即可

1
2

FieldInfo field = type.GetField("modsMenu", BindingFlags.NonPublic | BindingFlags.Static);
object modsMenu = field.GetValue(null);

UIMods包含什么?
- 启用全部模组
- 禁用全部模组
- 重新加载模组

如何在自己模组被加载时，禁用其他模组?

通过调用ModLoader.DisableMod方法，可以禁用模组，但是在加载完成后需要进入模组管理重新加载

我们可以在静态构造 / Mod主类的Load() 执行代码
1 2

typeof(ModLoader).GetMethod("DisableMod", BindingFlags.NonPublic | BindingFlags.Static) .Invoke(null, ["模组名称"]);

我们可以这样禁用后，通过反射调用重新加载，让禁用生效

重新加载应该在最后阶段调用PostSetupContent ModSystem / Mod

BindingFlags BSN = BindingFlags.Static | BindingFlags.NonPublic; //反射过滤
Type type = typeof(ModLoader);//获取类型
type.GetMethod("DisableMod", BSN).Invoke(null, ["模组名称"]);//禁用模组
if (ModLoader.TryGetMod("目标模组名", out _)) {//重加载
    type.GetField("isLoading", BSN).SetValue(null, false);
    type.GetMethod("Load", BSN).Invoke(null, [null]);
}

tModLoader IL钩子

Mon, 17 Feb 2025 17:50:00 +0800

IL钩子

目标方法

TGlobal的类型的是GlobalNPC

namespace Terraria.ModLoader;
public abstract class GlobalType<TGlobal> : ModType where TGlobal : GlobalType<TGlobal>

//目标
public static bool TryGetGlobal<TResult>(int entityType, ReadOnlySpan<TGlobal> entityGlobals, TResult baseInstance, out TResult result) where TResult : TGlobal

public abstract class GlobalType<TEntity, TGlobal> : GlobalType<TGlobal> where TGlobal : GlobalType<TEntity, TGlobal> where TEntity : IEntityWithGlobals<TGlobal>    

//类型
namespace Terraria.ModLoader;
public abstract class GlobalNPC : GlobalType<NPC, GlobalNPC>

步骤1

获取目标方法

MethodInfo noOnMethod = 
    onGlobalType
    	.GetMethods(BindingFlags.Public | BindingFlags.Static)
    	.FirstOrDefault(method => method.GetParameters().Length == 4 && method.Name == "TryGetGlobal");

步骤2

由于目标泛型未闭合，我们需要先闭合泛型，否则方法没有实例无法挂钩

//获取未闭合的 GlobalType 稍后我们闭合未GlobalType<GlobalNPC>
Type noOnGlobalType = typeof(GlobalType<>);

//闭合GlobalType<>
Type onGlobalType = noOnGlobalType.MakeGenericType(typeof(GlobalNPC));

//获取闭合后的方法
MethodInfo onMethodinfo = noOnMethod.MakeGenericMethod(typeof(GlobalNPC));

步骤3

挂钩，只能使用IL钩子ILHook，如果使用new Hook(onMethodinfo) 会报源方法不支持
如果你观察原方法的IL代码就能发现，在最后if判断的条件中前两条IL语句是Ldloc,LdcI4

ILHook ilHook = new ILHook(onMethodinfo, ilBody => 
{
  	//进行IL编辑  
    ILCursor ilCursor = new ILCursor(il); //获取IL指针
	if(ilCursor.TryGotoNext(	//尝试跳转到指定目标位置之后
    	MoveType.After,
    	x => x.MatchLdloc0(), 
    	x => x.MatchLdcI4(out _)))
	{
        //跳转完后还得加1，因为当前指针位置是那个Label也就是跳转
    	ilCursor.Index++;
        //观察IL发现，if语句有两个Lable，那么两个Lable跳转的地方应该是相同的，我们直接copy
    	ILLabel ilLabel = il.Labels[0];
        //将局部变量压入计算栈(索引0)
    	ilCursor.Emit(OpCodes.Ldloc_0); 
		//将方法传入的参数压入计算栈(索引1) 由于他是结构体，需要使用 Ldarga
        ilCursor.Emit(OpCodes.Ldarga, 1); 
    	ilCursor.Emit(OpCodes.Call, typeof(ReadOnlySpan<GlobalNPC>).GetProperty("Length").GetMethod);
    	ilCursor.Emit(OpCodes.Bge, ilLabel); //如果第一个值大于或等于第二个值，则将控制转移到目标指令。
	}
});

tModLoader 基础UI

Tue, 28 Jan 2025 18:50:00 +0800

基础准备

首先创建一个类，继承ModSystem，无特殊需求UI类也可以丢这个类里面，成为内部类。由于UI只需要在客户端就行了，所以使用特性标记，仅在客户端加载[Autoload(Side = ModSide.Client)]

方法	说明
Load()	用来载入UI
UpdateUI()	用来更新UI
ModifyInterfaceLayers((List layers)	用来确定UI所在层级，并注册UI层级

[Autoload(Side = ModSide.Client)]
class UISystem : ModSystem
{
	public override void Load()
	{
        base.Load();
    }
    
    public override void UpdateUI(GameTime gameTime)
	{
        base.UpdateUI(gameTime);
    }
    
    public override void ModifyInterfaceLayers(List<GameInterfaceLayer> layers)
	{
        base.ModifyInterfaceLayers(layers);
    }   
}

创建UI

我们创建一个ModSystem的内部类，并继承UIState / UIElement，只需要重写OnInitialize()方法即可。在这个方法里面我们进行界面的创建布局等。

public class BzaUI : UIState
{
    public override void OnInitialize()
	{
        base.OnInitialize();
    }
}

原版有很多的控件供给我们使用，在Terraria.GameContent.UI.Elements名称空间下。我们使用UIImageButton创建一个自定义图像的按钮，并加入到画布中。

public class BzaUI : UIState
{
    private UIImageButton MyButton;
    public override void OnInitialize()
	{
        //导入图片资源
        Asset<Texture2D> tex2d = Request<Texture2D>("ModName/xxxxx/imageName");
        //使用图片资源创建控件
        MyButton = new UIImageButton(tex2d);
        
        //将控件添加到父组件 如果想要自定义画布可以使用UIPanel类
        Append(MyButton);
        base.OnInitialize();
    }
}

使用UI

在UI类创建完成后，就需要在ModSystem进行加载了，先创建一个我们自己的UI实例，然后创建UserInterface用来承载我们的UI。

[Autoload(Side = ModSide.Client)]
class UISystem : ModSystem
{
    public BzaUI bzaUI;//自己的UI
    public UserInterface userInterface;//用户接口
    
	public override void Load()
	{
        bzaUI = new BzaUI();
        bzaUI.Activate();//激活

        userInterface = new UserInterface();
        userInterface.SetState(bzaUI);//将接口状态设置为我们的UI

        base.Load();
    }
    
    public override void UpdateUI(GameTime gameTime)
	{
        //每帧都更新UI
        userInterface?.Update(gameTime);
        base.UpdateUI(gameTime);
    }
}

对于ModifyInterfaceLayers单独拉出来说，layers包含原版以及模组的全部UI层级。每个层级都有自己的名字。并且按照先后顺序进行绘制。具体可以使用ModderTool这个模组的一个用户接口层选项进行查看，我们就不定义他在谁之上谁之下了。直接往0处插入我们自己的图层。

使用List(集合)中的Insert()方法可以往指定索引处插入数据。这边我指定0，然后创建一个LegacyGameInterfaceLayer就是图层。

    public override void ModifyInterfaceLayers(List<GameInterfaceLayer> layers)
	{
        layers.Insert
		(
    		0, 
    		new LegacyGameInterfaceLayer(
             	"GensokyoWPNACC:Bza",	//我们层的名字
             	() =>{ bzaUI.Draw(Main.spriteBatch); return true;}, //一个func委托，里面是UI绘制的逻辑,返回UI是否可见
             	InterfaceScaleType.UI)	//我们图层的类型
        );
        base.ModifyInterfaceLayers(layers);
    }

现在进入游戏应该就能在不起眼的小角落看到你的按钮了当然他现在什么也干不了

添加点击事件

设置我们UI的Top和Left属性可以更改UI的位置

public override void OnInitialize()
{
	Top.Pixels = Main.screenHeight - 100;
	Left.Pixels = Main.screenWidth / 5;
}

现在我们为按钮添加点击事件(伪代码)

public override void OnInitialize()
{
        Asset<Texture2D> tex2d = Request<Texture2D>("ModName/xxxxx/imageName");
        MyButton = new UIImageButton(tex2d);
        //添加事件
    	XAddIB.OnLeftClick += new MouseEvent(this.XAdd);

        Append(MyButton);
}

private void XAdd(UIMouseEvent evt, UIElement listeningElement)
{
    //方法逻辑
}

这样我们单机按钮就会触发你的方法逻辑了使用Visual Studio查看MyButton其中小闪电的就代表事件

绘制鼠标悬停文本

直接上代码了，这个确实是没什么好讲的

public override void ModifyInterfaceLayers(List<GameInterfaceLayer> layers)
{
    layers.Insert
    (
        0, 
        new LegacyGameInterfaceLayer
            (
                 "GensokyoWPNACC:Bza",
                 () =>{
                        var sb = Main.spriteBatch;
                        var font = FontAssets.MouseText.Value;
                        var ms = Main.MouseScreen + new Vector2(0, -20);
                        var color = Color.White;
                        var rot = 0f;
                        var origin = Vector2.Zero;
                        var scale = new Vector2(1.2f, 1.2f);
                     	var drawText = "6666";

                        bzaUI.Draw(Main.spriteBatch);

                        //字体绘制
                     	//isOnButton使用OnMouseOver事件控制
                        if (BzaUI.isOnButton)
                        {
                            ChatManager.DrawColorCodedStringWithShadow(sb, font, drawText, ms, color, rot, origin, scale);
                        }
                        return true;
                 },
                 InterfaceScaleType.UI
            )
    );
    
    base.ModifyInterfaceLayers(layers);
}

tModLoader生物群落判断

Sat, 25 Jan 2025 18:46:00 +0800

如果是玩家，可使用player.+下面的英文

英文	说明
ZoneDungeon	地牢
ZoneCorrupt	腐坏
ZoneHallow	圣地
ZoneMeteor	陨石
ZoneJungle	丛林
ZoneSnow	雪地
ZoneCrimson	血腥
ZoneDesert	沙漠
ZoneGlowshroom	发光蘑菇
ZoneUndergroundDesert	地下沙漠
ZoneSkyHeight	天空
ZoneSpace	外太空
ZoneOverworldHeight	主世界高度
ZoneDirtLayerHeight	土层高度
ZoneUnderworldHeight	地狱高度
ZoneUnderworld	地狱
ZoneBeach	海边
ZoneRain	下雨
ZoneSandstorm	沙尘暴
ZoneGranite	花岗岩
ZoneMarble	大理石
ZoneHive	蜂巢
ZoneGemCave	宝石洞
ZoneLihzardTemple	神庙
ZoneGraveyard	墓地
ZoneAether	微光
ZoneBelowSurface	地下
ZoneEvilBiome	邪恶生物群落

tModLoader 基础弹幕

Thu, 09 Jan 2025 11:30:00 +0800

基础弹幕

想要拥有自己的弹幕，只需要创建一个类然后继承ModProjectile其实就可以了
与基础物品一样，重写SetDefaults方法进行一些基础的设置
对于弹幕来说，SetDefaults的设置其实并不多，更多的内容是在AI还有Draw中的

字段 / 属性	说明
arrow	为`true`的话，弹幕会吃到箭的加成
friendly	为`true`的话就是友好的为`false`的话就是不友好的
penetrate	弹幕可穿透的数量如果你设置为1然后又在`Projectile.NewProjectile`后设置弹幕穿透为无限那么将免疫无敌帧无限穿透是-1
ignoreWater	为`false`遇水减速为`true`不受影响
scale	缩放，会影响碰撞箱
timeLeft	弹幕存活时间 60是一秒
aiStyle	使用原版的`AI`的话可以设置这个建议使用`ProjAIStyleID`设置原版AI -1的话就是自己写AI了
tileCollide	`false`穿墙 `true`不穿墙

public class TempSumeProjectile : ModProjectile
{
    public override void SetDefaults()
    {
        Projectile.friendly = true;//友好
        Projectile.aiStyle = 1;   //不建议使用神秘数字
        Projectile.timeLeft = 60;  //时间
        Projectile.penetrate = -1; //无限穿透
        Projectile.ignoreWater = true; //不受水
        Projectile.tileCollide = false;//穿墙
        Projectile.scale = 1.1f;
        base.SetDefaults();
    }
}

武器使用

在物品那边，我没有给出一个属性，那就是shoot他可以设置物品射出的弹幕

以下是一个武器示例，发射出上面定义的弹幕，主要内容是最后一行。shootSpeed可以设置弹幕的速度

public class TempSume : ModItem
{
    public override void SetDefaults()
    {
        Item.damage = 12;
        Item.width = 40;
        Item.height = 40;
        Item.useTurn = true;
        Item.useTime = 20;
        Item.autoReuse = true;
        Item.knockBack = 6;
        Item.useAnimation = 20;
        Item.rare = ItemRarityID.Blue;
        Item.value = Item.buyPrice(silver: 1);
        Item.UseSound = SoundID.Item1;
        Item.useStyle = ItemUseStyleID.Shoot;
        Item.DamageType = DamageClass.Summon;

        Item.shootSpeed = 10f;
        Item.shoot = ModContent.ProjectileType<TempSumeProjectile>();
    }
}

这边出现了ModContent.ProjectileType<MyProjectile>()，单说ProjectileType没有太大的意义，我们从名字上来看 ModContent 模组内容。

这是一个类，提供了很多静态方法，用来获取模组的内容然后使用到实际中。

这边的ProjectileType就是获取模组的弹幕，返回的是该弹幕的唯一ID

现在回到游戏，使用你的武器，你应该就能看到武器发射了你自己的弹幕了

弹幕AI

弹幕的AI逻辑需要重写AI方法，我们继续使用上面定义的弹幕，注意我将aiStyle设置为了-1，我们要自定义AI了

public class TempSumeProjectile : ModProjectile
{
    public override void SetDefaults()
    {
        Projectile.friendly = true;//友好
        Projectile.aiStyle = -1;   //不建议使用神秘数字
        Projectile.timeLeft = 60;  //时间
        Projectile.penetrate = -1; //无限穿透
        Projectile.ignoreWater = true; //不受水
        Projectile.tileCollide = false;//穿墙
        Projectile.scale = 1.1f;
        base.SetDefaults();
    }
    
    public override void AI()
	{
    }

}

该方法每秒会执行60次，如果要进行额外更新，可以在SetDefaults方法添加extraUpdates的设置

开始之前，先了解几个基本的Vector2方法，大多数来源于Terraria对其的扩展

方法	说明
ToRotation()	获取向量的方向角建议这样使用`Projectile.velocity.ToRotation()` 先获取弹幕速度，然后获取角度，来源于扩展方法
SafeNormalize()	安全的归一化向量，传入一个失败的默认值用来计算速度时非常有用，来源于扩展方法

还有一些关于Main我们需要知道的

属性 / 字段 / 方法	说明
player	全部的玩家，通常用来获取弹幕的主人
MouseWorld	玩家鼠标在世界中的位置
screenPosition	玩家屏幕在世界中的位置
myPlayer	该玩家在`player`数组中的索引，`255`说明是服务器

想让弹幕朝着既定的方向运行，我们需要使用 目标位置 - 弹幕位置

开始

现在，我们设计一个弹幕，要求弹幕追随玩家鼠标

如果你不想让弹幕始终向你的贴图一样的方向，请使用Projectile.rotation = Projectile.velocity.ToRotation();让弹幕的旋转角度等于速度的方向角
要让弹幕追随鼠标，我们需要使用目标位置 - 弹幕位置

Main.MouseWorld - Projectile.Center

需要注意的是，这样做向量有方向，也有速度，而且速度你是没法确定的，因为这取决于他们之间的距离，这时候我们就需要归一化了，让向量的速度为1，方向仍然存在，需要设置他的速度就将归一化的向量乘以速度就行了

1
2

Vector2 velocity = 
    (Main.MouseWorld - Projectile.Center).SafeNormalize(Vector2.Zero) * 12f;

这样我们就得到了一个速度12的，追随鼠标方向的向量
需要注意的是，我们将他写了AI中，也就是说，该向量的方向每秒更新60次，但是速度是不变的，如果你只希望他在第一次发射时想着鼠标，那你大可不自定义AI了，因为基础武器的射弹默认就是这样的。
让我们设置弹幕的速度等于我们计算的向量注意，写在AI方法中

Vector2 velocity = (Main.MouseWorld - Projectile.Center).SafeNormalize(Vector2.Zero) * 12f;
//弹幕的旋转等于弹幕速度的旋转角
Projectile.rotation = Projectile.velocity.ToRotation();
Projectile.velocity = velocity;

tModLoader 基础绘制

Sun, 05 Jan 2025 11:55:00 +0800

基础绘制

没有理论直接上手，我们创建一个新类，放哪里看你心情，然后使用他继承PlayerDrawLayer，我这边不打算直接讲重写弹幕绘制，而是在Player的绘制层进行绘制，我认为知道这个东西比知道重写弹幕绘制更有用。

1
2
3

public class MyPlayerDrawLayer : PlayerDrawLayer
{
}

继承后会报错，ALT + 回车 重写两个方法

public class MyPlayerDrawLayer : PlayerDrawLayer
{
	public override Position GetDefaultPosition()
	{
    	throw new NotImplementedException();
	}


    protected override void Draw(ref PlayerDrawSet drawInfo)
    {
        throw new NotImplementedException();
    }
}

关于GetDefaultPosition是返回要绘制在哪个层的，Draw就是实际进行绘制的地方，我们还需要重写一个方法用来控制图层的可见性GetDefaultVisibility

public class MyPlayerDrawLayer : PlayerDrawLayer
{
    public override bool GetDefaultVisibility(PlayerDrawSet drawInfo)
    {
        return base.GetDefaultVisibility(drawInfo);
    }
}

这个我给出几个有关玩家的字段/属性便于你们去进行判断什么时候需要启用绘制层

字段 / 属性	说明
dead	true玩家死亡
itemAnimation == 0	为0玩家没有在使用物品
HeldItem.type	玩家手持物品的ID
pulley	true玩家被绑在绳子上
isPettingAnimal	是否在抚摸动物

给出几个有关玩家的字段/属性便于你们进行绘制

字段 / 属性	作用
direction	玩家的朝向 1右边 -1左边
gravDir	玩家的重力方向 1正 -1反
(方法) RotatedRelativePoint	给定一个位置自动调整为正确方位自动计算玩家旋转方向等
mount.Active	是否骑坐骑

现在我们开始进行绘制，作为演示，我将GetDefaultVisibility始终返回true 注意始终为 true是默认的，你不重写该方法，就是true

public override bool GetDefaultVisibility(PlayerDrawSet drawInfo)
{
    return true;
}

现在我们将目光放到GetDefaultPosition方法，我们需要返回我们所需绘制的层级，可以CTRL + 左键进入Position探索一番，我这里直接给出说明

BeforeParent在给定图层之前绘制

AfterParent在给定图层之后绘制

我们这边使用AfterParent，图层我们使用HairBack 是哪一层可以使用Visual Studio的文档提示进行观察，玩家的所有图层基本上都在PlayerDrawLayers 使用 .(成员访问操作符) 如果字段/属性的类型是PlayerDrawLayer就是可以用的

public override Position GetDefaultPosition()
{
    return new AfterParent(PlayerDrawLayers.HairBack);
}

开始进行绘制了，drawInfo中可以获取太多太多东西，这个可以自行研究，我们探讨的是基础的绘制，我们本次绘制要基于玩家中心，我们可以使用drawInfo获取玩家

using Terraria;
protected override void Draw(ref PlayerDrawSet drawInfo)
{
    Player player = drawInfo.drawPlayer;
}

准备一张贴图 / 一张长帧图，(来自于同学)

MeleeWeapon

我这张图每个图片大小为32，没有线条分割

MeleeWeapon

2

我们前往Mod主类中的Load()方法加载贴图

using ReLogic.Content;
public class TempMod : Mod
{
    public static Asset<Texture2D> TempTex2D;
    public override void Load()
    {
        //这里注意以下，使用这个方法加载 字符串内容从 模组名称开始
        //名字名称/存储文件夹/贴图名称	不带后缀.png
        //贴图需要png格式
        //如果贴图放在根目录 那就=> 	模组名称/贴图名称
        TempTex2D = ModContent.Request<Texture2D>("TempMod/Content/Items/MeleeWeapon");
    }
}

这边我们定义一个字段来存储这个贴图的资源，为了方便访问，我使用static修饰

现在我们回到MyPlayerDrawLayer的Draw方法

我们获取用于绘制的画笔Main.spriteBatch

protected override void Draw(ref PlayerDrawSet drawInfo)
{
    Player player = drawInfo.drawPlayer;
    SpriteBatch sb = Main.spriteBatch;
}

我们使用sb的Draw()方法开始绘制，由于Draw本身是在sb.Begin()中的所以我们直接调用 Draw()，他有7个重载，我们使用

public void Draw(
	Texture2D texture,	//贴图
	Vector2 position,	//绘制位置 屏幕坐标
	Rectangle? sourceRectangle,		//绘制贴图的哪一部分,null全部
	Color color
)

更泛用的方法

public void Draw(
	Texture2D texture,	//贴图
	Vector2 position,	//绘制位置 屏幕坐标
	Rectangle? sourceRectangle,		//绘制贴图的哪一部分,null全部
	Color color,		//染色 我们给白色
	float rotation,		//绘制的旋转角度，一般获取特定对象的角度确保正确绘制
	Vector2 origin,		//贴图的原点
	float scale,		//绘制的缩放大小
	SpriteEffects effects,	//特效
	float layerDepth	//图层深度，影响绘制顺序
)

我们开始进行绘制

protected override void Draw(ref PlayerDrawSet drawInfo)
{
    Player player = drawInfo.drawPlayer;
    SpriteBatch sb = Main.spriteBatch;
    sb.Draw(
        //我们使用的是资源，而不是直接的贴图，所以需要 Value 取值
        texture: 		TempMod.TempTex2D.Value,
        //由于是屏幕坐标系，所以我们需要获取玩家所在屏幕的位置
        //Main.screenPosition是屏幕左上角在世界中的位置
        position: 		player.Center - Main.screenPosition,
        //绘制范围 x,y是绘制原点，高宽是基于原点绘制的高宽
        sourceRectangle: new Rectangle(0, 0, 32, 32),
        color: 			Color.White
        );
}

图1

想要绘制帧图的话，我们只需循环改变 new Rectangle中 x,y的位置就行了

private int num = 0;
protected override void Draw(ref PlayerDrawSet drawInfo)
{
    Player player = drawInfo.drawPlayer;
    SpriteBatch sb = Main.spriteBatch;
    sb.Draw(
        texture: TempMod.TempTex2D.Value,
        position: player.Center - Main.screenPosition,
        //注意这里，我们使num乘上了单个贴图宽度 num为0就是第一张了，num为1就第二张了，以此类推
        //num的最大大小应该为 贴图数量 - 1
        sourceRectangle: new Rectangle(num * 32, 0, 32, 32),
        color: Color.White
        );
    num++;
    if (num > 4)
        num = 0;
}

我们现在如果进入游戏看效果，会发现贴图快的要命，因为绘制速度是与玩家FPS相关的，默认情况下是60FPS也有特殊情况，例如玩家将 设置 -> 视频 -> 跳帧 设置为 关 / 隐蔽 时，会超越，达到等同于屏幕的FPS

我们可以进行一些更改

private int num = 0;
protected override void Draw(ref PlayerDrawSet drawInfo)
{
    Player player = drawInfo.drawPlayer;
    SpriteBatch sb = Main.spriteBatch;
    sb.Draw(
        texture: TempMod.TempTex2D.Value,
        position: player.Center - Main.screenPosition,
        sourceRectangle: new Rectangle(num / 100 * 32, 0, 32, 32),
        color: Color.White
        );
    num++;
    if (num > 400)
        num = 0;
}

现在我们的绘制就缓慢了许多，如果想要绘制在鼠标位置，position 更改为 Main.MouseWorld - Main.screenPosition ，对于弹幕与这个一样，绘制在弹幕位置Projectile.Center - Main.screenPosition，要绘制拖尾需要在弹幕SetStaticDefaults()中增加如下

public override void SetStaticDefaults()
{
    //记录轨迹和旋转 Type是本弹幕自身的ID
    ProjectileID.Sets.TrailingMode[Type] = 2;
    //记录多少帧
    ProjectileID.Sets.TrailCacheLength[Type] = 20;
    base.SetStaticDefaults();
}

访问Projectile.oldPosition[i]可以i帧前的数据，想让绘制正常旋转需要使用Projectile.oldRot[i]获取角度，并使用更泛用的Draw，并使position为Projectile.oldRot[i]

tModLoader 物品基础及其属性

Tue, 31 Dec 2024 19:06:00 +0800

基础物品

如果你的物品是材料，只需要继承ModItem 然后tModLoader会为你自行标记为材料

前提是改物品被用于合成
如果你要制作武器，需要重写SetDefaults方法

public class TempSume : ModItem
{
    public override void SetDefaults()
    {

    }
}

对于物品的属性，可以使用Visual Studio的自动提示窥探一二，大部分的属性都能从名字直接获取关键字

我们主要设置设置一些基础的属性就可以做出一把普通的武器

public class TempSume : ModItem
{
    public override void SetDefaults()
    {
		Item.damage = 12;
		Item.width = 40;
		Item.height = 40;
		Item.useTime = 20;
		Item.knockBack = 6;
		Item.useAnimation = 20;
		Item.UseSound = SoundID.Item1;
		Item.useStyle = ItemUseStyleID.Shoot;
		Item.DamageType = DamageClass.Summon;
    }
}

其实还可以更简单，这边解释一下都代表什么。某种意义上来说翻译一下就行了

对于useTime和useAnimation建议去看看另一个文档
对于DamageType使用Visual Studio的自动提示，在打上DamageClass后就可以窥探一二
对于useStyle，使用自动提示，在打上ItemUseStyleID后就可以窥探一二，对于效果可以点击这里

属性/字段	说明
damage	基础攻击力
width	宽度，影响碰撞箱
height	高度，影响碰撞箱
useTime	使用时间
useAnimation	使用动画
UseSound	使用声音
knockBack	击退
useStyle	使用时的动画类型
DamageType	伤害类型

一些其他的属性，可以自行探索，这里再说一个属性 holdStyle 可以在玩家手持物品时展现一些动作具体效果可以点击这里

以下字段/属性说明来源Wiki

属性/字段	说明
useTurn	物品在使用时是否可以转身
autoReuse	是否自动使用
rare	物品的稀有度, 使用`ItemRarityID.` 具体样式点击这里
value	物品的价值，建议使用`Item.buyPrice()`设置，而不是直接输入数值
consumable	是否为消耗品
scale	缩放倍率，影响碰撞箱
createTile	设置物品放置的物块，默认是`-1`的不放置
noMelee	让你的武器挥舞无法对敌人造成伤害
accessory	是否为饰品
defense	防御力
crit	暴击率（玩家基础暴击率是`4`）
noUseGraphic	物品在使用时，贴图是否可见，默认是`false`的，注意是`no`开头
useAmmo	物品使用的弹药类型使用`AmmoID.`进行设置，点击查看具体详情
ammo	如果你的物品是弹药，请设置这个，使用`AmmoID` 决定你弹药的类型
notAmmo	默认`false` 也就是不是弹药，如果设置为`true` 它就是弹药了捡起来的时候会放在弹药栏
mana	物品在使用时消耗的魔力值
channel	一般用来做手持弹幕，可以获取玩家的某个状态
expert	是否为专家模组物品（就物品描述多个专家模式）
bait	鱼饵的鱼饵力
fishingPole	钓竿的垂钓力
questItem	是否为任务物品 (就物品描述多个任务物品)
mech	是否为电线
material	是否为材料
maxStack	最大堆叠

alpha	使用时的透明度
buy	能否在商人处被购买
expertOnly	设置为`true` 这个饰品在非专家世界，不生效
makeNPC	生成指定的NPC (使用NPCID)
active	是否为存在的实体默认是true
mountType	玩家只有在骑着指定坐骑的时候才能使用此物品建议使用`Terraria.ID.MountID.`进行设置
wet	物品是否处于潮湿状态 / 是否在水里

药水

属性/字段	说明
buffType	使用物品后给予玩家一个`buff` 建议使用 `Terraria.ID.BuffID.`进行设置
buffTime	使用物品后基于玩家buff的时长(一秒60)
healLife	使用物品后回复玩家多少生命
healMana	使用物品后回复玩家多少魔力值
potion	使用物品后是否造成药水疾病，药水疾病期间武器无法再次使用

工具

属性/字段	说明
axe	斧力 (工具)
pick	镐力 (工具)
hammer	锤力 (工具)

tModLoader 玩家物品使用时间

Sat, 28 Dec 2024 13:23:00 +0800

ItemTime

在ItemTime为0但itemAnimation没到0时，会一直运行物品的逻辑，大多数的物品都会判断player.itemTime = = 0 然后设置 player.itemTime = player.useTime

这就是为什么有些武器挥舞的很慢，但是弹幕出的很多的原因

ItemAnimation

ItemAnimation与 player.itemAnimationMax 结合使用，用于确定玩家在使用动画时的进度。

所有物品的使用都会判断play.itemAnimation > 0 因为他决定物品是否正在被使用

注意：

如果 useTime 等于 useAnimation 没有任何问题
如果 useTime 小于 useAnimation 那么在一次动画中，武器会使用多次
如果 useTime 大于 useAnimation 那么武器动画已经完成了，但是你还是无法切换武器除非useTime 为0

reuseDelay

这个东西的作用是强迫玩家在使用物品后等待指定的时间才能再次使用, 设置Item.reuseDelay

如果物品是Item.melee（近战），Item.createTile > 0 Item.createWall > 0 免疫这个东西

对于Player的一些控制方法

ItemAnimationJustStarted	玩家动画是否处于第一帧
ItemTimeIsZero	使用时间是否为0
ItemAnimationActive	使用动画是否正在进行
ItemAnimationEndingOrEnded	使用动画是否结束
ItemUsesThisAnimation	动画使用多少次了(物品被使用了多少次)

Item

attackSpeedOnlyAffectsWeaponAnimation	攻击速度是否只影响武器的挥舞速度(动画速度)
shootsEveryUse	每次动画开始都会发射弹幕，而不是UseTime
useLimitPerAnimation	每次使用生效的次数(运行多少次物品逻辑)
consumeAmmoOnFirstShotOnly	每次使用的开始消耗一枚弹药(喷火器)
consumeAmmoOnLastShotOnly	每次使用的结束消耗一枚弹药(发条突击步枪)
channel	当左键(攻击)被按住时可以有特殊的行为通常用来制作手持弹幕同时player的channel会为true

调整使用速度和动画速度

切记不要动态修改Item.useTime和Item.useAnimation。tModLoader提供了钩子来帮助调整使用使用时间和动画时间。对于需要动态调整的效果，应该使用已经提供的钩子来更改，这样兼容性是最高的。

方法

ModPlayer\|ModItem\|GlobalItem	UseTimeMultiplier	更改Item的useTime
ModPlayer\|ModItem\|GlobalItem	UseAnimationMultiplier	更改Item的useAnimation
ModPlayer	GetAttackSpeed	更改攻击速度是个乘数，+0.15f等于增加15% 比如修改远程攻击速度
static DamageClass	MeleeNoSpeed	攻速对于其没有影响

TModLoader on 南亭

tModLoader 认识一下Shader

Effect的引入

Effect的应用时机

Effect的参数更改

立即模式

批处理模式

灰度fx

计算亮度fx

tModLoader 自绘UI中的位置计算问题

自绘UI中的位置计算问题

tModLoader 零群问题收纳

2025/08/11

模组联动中其他模组类型Type获取问题

2025/08/12

无Key物块合成站汉化问题

如何监听护士治疗等(未试验)

2025/08/13

其他玩家受伤也调用方法问题

世界生成时如何生成NPC

2025/08/14

关于静态类

加载XNB字体

2025/08/15

关于Dust的问题

2025/08/16

模组加载顺序问题

音频播放的位置移动

tModLoader 关于物品收藏的联机同步

tModLoader 基础饰品

饰品

方法

常用加成

Mod Player

本地化

tModLoader 类似打字机的文本出现

1.前提准备

2.开始绘制

tModLoader 动态更改显示文本(多语言切换)

tModLoader 禁用给定模组

禁用模组逻辑

UIMods实例在那里?

如何在自己模组被加载时，禁用其他模组?

tModLoader IL钩子

IL钩子

步骤1

步骤2

步骤3

tModLoader 基础UI

基础准备

创建UI

使用UI

添加点击事件

绘制鼠标悬停文本

tModLoader生物群落判断

tModLoader 基础弹幕

基础弹幕

武器使用

弹幕AI

开始

tModLoader 基础绘制

基础绘制

MeleeWeapon

MeleeWeapon

2

图1

tModLoader 物品基础及其属性

基础物品

以下字段/属性 说明来源Wiki

药水

工具

tModLoader 玩家物品使用时间

ItemTime

ItemAnimation

注意 ：

reuseDelay

对于Player的一些控制方法

调整使用速度和动画速度

方法

模组联动中其他模组类型`Type`获取问题

以下字段/属性说明来源Wiki

注意：