创建你的第一个 MOD

本教程假设你了解一些基本的 Lua 概念(函数、变量等),并且对 Mod 的文件结构有基本认识。

首先创建一个新文件夹,名字就是 Mod 的名字。你所有的 Mod 文件都放在这里,下文称它为根文件夹。

最小文件集

一般情况下,一个 Mod 至少需要以下 4 个文件:

文件 描述
modmain.lua 包含可运行的代码,Mod 启用时会执行
modinfo.lua 包含 Mod 信息,例如版本号、名称,以及 Mod 配置选项
modicon.tex Mod 图标及纹理文件,包含图像数据
modicon.xml Mod 图标的 xml 文件,声明纹理名称与纹理尺寸

开始创建

先制作 modinfo.lua,参照 Modinfo 文件说明 填写所需字段。

然后需要一个 modicon。按照 Modicon tex 文件的说明创建 modicon.tex,确保文件名正确并放在 Mod 根文件夹下。接着创建 modicon.xml,把下面的代码复制进去:

1
2
3
4
5
6
<Atlas>
<Texture filename="modicon.tex" />
<Elements>
<Element name="modicon.tex" u1="0" u2="1" v1="0" v2="1" />
</Elements>
</Atlas>

想深入了解的话,可以查阅 modicon xml 文件说明,了解各个 XML 标签的意义。

到这里你已经掌握了 Mod 的基础结构。

延伸阅读