原作者:裙子 / 2020年3月6日 再版:夜谷紫幽
模板Mod
像第一版裙中世界一样,我们的第一个Mod一定是一个配置好的模板Mod。为什么不推荐手动配置呢?因为从各种意义上讲,配置都比较麻烦,而且容易出错。相比于以前的TML v0.10.5,v0.11以后的版本TML官方都提供了自动配置的方案,所以使用起来实在是方便。由裙中世界出版的模板Mod有个好处就是包含了很多独有的工具,虽然一时半会用不上,但是以后这些工具会成为强大的助力。
注:当前模板Mod适配TML版本为v2022.5.103.25(即Stable 6月份版本)
与此同时,Github上 https://github.com/CXUtk/TemplateMod2 会实时更新Mod最新版本的源码。
同时我强烈建议,在教程第一部分的学习结束之前一定要全程使用TemplateMod2,而不是改成自己的Mod,否则可能会出现各种意料之外的问题!
Mod源码放置位置
注意,Mod源码的位置和TML安装的位置是不一样的。如果要访问Mod源码的安装位置,请打开TML,然后选择模组源码。
这就是我们MOD源码编译和加载的地方,点击打开源码文件夹
打开以后应该是在Documents\My Games\Terraria\tModLoader\ModSources
这个文件夹
这就是我们MOD源码放置的位置,每个文件夹就对应着一个MOD的源码。
源码使用
接下来我们要新建一个名叫TemplateMod2(名字在这里很重要,不要写错)的文件夹,然后把TemplateMod2.zip里面的文件全部解压到这个新的文件夹。
那么第一个Mod就配置好了, 由于它已经配置好了,所以我们来测试一下它是否能正常工作吧。
回到TML,打开模组源码,点击生成并重新加载,这个按钮的作用就是把源码编译了以后加载到游戏里
它旁边的那个生成按钮的作用仅仅是编译Mod,要装到游戏里面一定要确保加载了!
注:如果仅仅想加载,可以从主菜单->模组管理里面重新加载。
在进入世界的时候你或许会发现,你的玩家存档和世界存档都不见了!!但是不用紧张,因为TML的存档区域与原版的存档是分开的,也就是说,如果打开的是原版泰拉瑞亚,那么你就能看到原版存档。如果打开的是TML,那么就会看到TML存档。这是因为TML存档和原版存档格式不同的原因(毕竟是Mod存档啊)。
所以新建个玩家,然后进游戏里看一看吧,如果你拥有一些土块,就能在工作台合成。
如果它出现了,就代表你的第一个Mod正式启动了!!
不过接下来我还要讲一些重要的概念。
自动生成Mod
如果你想使用TML自带的Mod创建模板,可以去模组源码点击创建模组
然后就能看见下图
我来解释一下这些条目的意思。
首先ModName是你的Mod主名字/命名空间名字,这个名字一定要是英文,不能有空格,特殊字符,因为它不但代表了命名空间以及全局的Mod名称,还是文件夹的名字,更是代码里面的主类名。可能现在你不知道这意味着什么,但是以后你会经常遇到的,如果这个名字填的不好会极大地影响你的代码体验。TemplateMod2这个就是我们模板Mod的主名字。
Mod DisplayName就比较随意了,它是你的Mod显示名字,可以填中文、空格和特殊字符,它会出现在此处
注意,如果在源码中使用中文字符,一定要确认文件的编码是UTF-8,否则就会出现乱码。如果你的武器名称或者描述出现了乱码,可以用以下方法转换编码,在VS里,进入物品的那个文件,点击左上角 文件
Mod Author是作者的名字,随便填
BasicSword需要填写的是初始剑的类名,同样也是不能有空格、中文、特殊字符。
最后点击创建即可,此时在源码文件夹下就出现了一个和主名字同名的文件夹,里面的配置和TemplateMod类似,但是功能和注释肯定不如TemplateMod齐全。
如果加载Mod以后能够用泥土在工作台合成那把初始剑,就算完成了。