为Unity游戏开发ModdingAPI时无直接引用调用游戏内函数的问题咨询

你遇到的问题本质是ModdingAPI类库作为独立项目，编译阶段没有游戏程序集的元数据，所以无法直接识别游戏内定义的exampleClass类型，可通过以下三种常用方案解决：

方案1：引用游戏编译后的程序集（最简便） #

• 操作步骤：
  1. 完成Unity游戏项目的编译打包后，在打包输出目录的[游戏名]_Data/Managed路径下找到游戏主程序集Assembly-CSharp.dll（如果你给游戏代码分了自定义程序集，就找对应存放exampleClass的dll文件）
  2. 打开你的ModdingAPI类库项目，右键「依赖项」选择「添加项目引用」，浏览选中刚才导出的Assembly-CSharp.dll完成引用
  3. 此时你在API项目中就可以直接引用exampleClass类型，原有代码无需额外修改即可正常编译
• 注意事项：每次游戏核心逻辑更新后，都需要重新导出最新的Assembly-CSharp.dll替换API项目中的引用文件，避免出现类型不匹配错误。

方案2：运行时反射调用（无需编译期引用） #

如果你不想将完整游戏程序集暴露给API项目，可以选择在运行时通过反射获取类型并调用方法，代码示例如下：

using System;
using System.Reflection;

public class moddingClass : MonoBehaviour
{
    public static void callExampleFunction()
    {
        // 加载游戏主程序集
        Assembly gameAssembly = Assembly.Load("Assembly-CSharp");
        // 获取exampleClass类型
        Type exampleClassType = gameAssembly.GetType("exampleClass");
        // 获取exampleFunction方法信息
        MethodInfo exampleMethod = exampleClassType.GetMethod("exampleFunction", BindingFlags.Public | BindingFlags.Static);
        // 调用静态方法，实例参数传null即可
        exampleMethod.Invoke(null, null);
    }
}

• 注意事项：如果方法有参数，需要把参数按顺序放到Invoke的第二个参数数组里；类或方法的访问修饰符不是public的话，需要调整BindingFlags参数添加对应标记。

方案3：接口/委托解耦（适合标准化API管控） #

你可以在ModdingAPI项目中先定义好要暴露的方法契约，游戏侧实现后注册到API中，完全解耦双向依赖：

1. 首先在ModdingAPI项目中定义静态委托或者公共接口：

// ModdingAPI项目内代码
public static class APIContract
{
    public static Action ExampleFunctionImpl { get; set; }
}

public class moddingClass : MonoBehaviour
{
    public static void callExampleFunction()
    {
        APIContract.ExampleFunctionImpl?.Invoke();
    }
}

2. 然后在Unity游戏项目启动时，把exampleFunction注册到API的契约中：

// Unity游戏项目内启动类代码
private void Awake()
{
    moddingAPI.APIContract.ExampleFunctionImpl = exampleClass.exampleFunction;
}

• 优势：不需要API项目引用任何游戏程序集，还可以灵活控制要暴露给模组的能力范围，避免游戏内部代码泄露。

内容的提问来源于stack exchange，提问作者ChilledOwl