七日杀DLL类MOD开发入门：从零完成第一个MOD

<?xml version="1.0" encoding="UTF-8"?>
<xml>
    <ModInfo>
        <Name>我的DLL MOD</Name>
        <Description>第一个DLL MOD</Description>
        <Author>KK</Author>
        <Version>1.0.0</Version>
    </ModInfo>
</xml>

using UnityEngine;
using HarmonyLib;

public class EntityScannerMod
{
    // Harmony 补丁：在游戏 Update 中注入扫描逻辑
    [HarmonyPatch(typeof(XUi))]
    [HarmonyPatch("Update")]
    public class XUiUpdatePatch
    {
        static float lastScanTime = 0f;
        static float scanInterval = 2f; // 每2秒扫描一次
        
        static void Postfix(XUi __instance)
        {
            if (Time.time - lastScanTime < scanInterval) return;
            lastScanTime = Time.time;
            
            // 获取本地玩家
            EntityPlayerLocal player = __instance.xui.playerUI.entityPlayer;
            if (player == null) return;
            
            // 扫描周围10格内的实体
            Vector3 playerPos = player.position;
            float scanRadius = 10f;
            
            // 使用游戏API获取实体列表
            var entities = GameManager.Instance.World.GetEntitiesInBounds(
                typeof(Entity), 
                new Bounds(playerPos, Vector3.one * scanRadius * 2)
            );
            
            int entityCount = 0;
            foreach (var entity in entities)
            {
                if (entity is EntityAlive alive && alive != player)
                {
                    entityCount++;
                    float distance = Vector3.Distance(playerPos, alive.position);
                    // 可以在这里添加自定义逻辑
                }
            }
        }
    }
}

// 前置补丁：在原方法执行前运行
[HarmonyPatch(typeof(ClassName))]
[HarmonyPatch("MethodName")]
[HarmonyPrefix]
static bool Prefix() { return true; } // 返回 false 则跳过原方法

// 后置补丁：在原方法执行后运行
[HarmonyPatch(typeof(ClassName))]
[HarmonyPatch("MethodName")]
[HarmonyPostfix]
static void Postfix() { }

// 转译补丁：替换原方法的 IL 代码
[HarmonyPatch(typeof(ClassName))]
[HarmonyPatch("MethodName")]
[HarmonyTranspiler]
static IEnumerable<CodeInstruction> Transpiler(IEnumerable<CodeInstruction> instructions) { }

// 日志输出
Debug.Log("[我的MOD] 扫描完成，发现 " + entityCount + " 个实体");

// 控制台命令注册
public class MyConsoleCommand : IConsoleCommand
{
    public string GetDescription() => "测试命令";
    public string[] GetCommands() => new[] { "testcmd" };
    
    public void Execute(string[] _params, int _minParams)
    {
        SdtdConsole.Instance.Output("命令执行成功！");
    }
}