UnityMod开发教程 04 第一个Mod

一. HelloWorld

  打开VS,我们新建一个.Net Framework类库项目,框架版本选择4.5,这是一个非常通用的版本。项目名称命名为HelloUMM。
  建好项目之后,我们先给默认的类Class1改个名字,我一般习惯用Main作为主体,你也可以选择使用别的名字。
  然后我们要为Mod项目添加引用,主要是引用一些常用的东西,在解决方案资源管理器,右键引用->添加引用,选择浏览->浏览,然后找到游戏文件夹下存放AC的位置,我们主要引用以下库。

  • Assembly-CSharp.dll
  • UnityEngine.dll
  • UnityEngine.CoreModule.dll
  • UnityEngine.IMGUIModule.dll
  • UnityEngine.UI.dll
  • UnityEngine.UIElementsModule.dll
  • UnityEngine.UIModule.dll
    还有UnityModManager文件夹下的:
  • 0Harmony12.dll
  • UnityModManager.dll
      这些是比较常用的dll,如果你还想做其他的,比如物理,就可以引用UnityEngine.PhysicsModule.dll,做AB包加载就引用UnityEngine.AssetBundleModule.dll,按需添加。
      然后我们全选所有引用,把属性里的复制本地改为False,这样在编译的时候不会把引用的dll都复制到输出目录。
      添加之后,我们来写第一个函数,为了加载我们的mod,我们需要一个入口函数,这里我写作Load。using一下UMM的命名空间UnityModManagerNet,然后创建如下函数:
using UnityModManagerNet;

namespace HelloUMM
{
    public static class Main
    {
        public static bool Load(UnityModManager.ModEntry modEntry)
        {
            return true;
        }
    }
}

  Load函数有一个参数modEntry,这是mod的入口,我们返回true通知管理器加载成功了。接下来,我们添加一个日志。

using UnityModManagerNet;

namespace HelloUMM
{
    public static class Main
    {
        public static bool Load(UnityModManager.ModEntry modEntry)
        {
            modEntry.Logger.Log("Hello MyMod");
            return true;
        }
    }
}

  这样我们第一个Mod的逻辑就写完了,但是现在编译我们的mod的话,游戏并不能加载,记不记得上一节我们添加的配置中,有一个标签叫ModInfo<ModInfo>Info.json</ModInfo>?是的,我们需要给Mod准备一个说明文件来让UMM知道如何加载我们的Mod。
  我们为当前项目添加一个新建项,在Web分类下找到JSON文件,修改名字为info.json,添加然后写下如下配置。

{
  "Id": "HelloUMM",
  "DisplayName": "我的第一个Mod",
  "Author": "xiaoye97",
  "Version": "1.0.0",
  "AssemblyName": "HelloUMM.dll",
  "EntryMethod": "HelloUMM.Main.Load"
}

  Id就是Mod的唯一ID,不应该与其他mod相重复。DisplayName就是在游戏中显示的Mod名字,作者和版本号顾名思义,就不在介绍,AssemblyName是我们程序集的名称,如果我们没有多做修改的话,程序集的名称就是我们项目的名称,所以我们写HelloUMM.dll,EntryMethod就是我们重要的入口函数,我们写上我们刚才创建的Load函数即可。
  在解决方案管理器中选中我们的info.json,在下面的属性栏找到"复制到输出目录",改成"如果较新则复制",这样info文件就会在我们编译的时候一起输出。
  到此为止,我们的工作就完成了,现在选择生成->生成HelloUMM来编译我们的Mod,然后打开输出的文件夹,找到我们的HelloUMM.dll和info.json,复制,然后在游戏文件夹里的Mods文件夹下,新建一个文件夹叫做HelloUMM,然后把我们的两个文件粘贴到里面。
  打开游戏,如果没有意外,UnityMod管理面板上已经显示了我们的Mod,打开Logs查看日志,也能够找到我们输出的Hello MyMod。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
禁止转载,如需转载请通过简信或评论联系作者。
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,125评论 6 498
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,293评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 162,054评论 0 351
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,077评论 1 291
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,096评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,062评论 1 295
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,988评论 3 417
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,817评论 0 273
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,266评论 1 310
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,486评论 2 331
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,646评论 1 347
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,375评论 5 342
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,974评论 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,621评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,796评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,642评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,538评论 2 352