1.3 配置模组环境
Last updated
Was this helpful?
Last updated
Was this helpful?
将游戏主目录的empty_mod
文件夹完整地复制粘贴到游戏主目录的devmods
文件夹内,作为将要开发Mod的模组文件夹,并将文件夹名称重命名为模组名称。
注:本教程以“ExampleMod”为例子,将文件夹重命名为ExampleMod,请按自己想要开发的模组名称给文件夹命名。
在VS Code中点击菜单项的File->Open Folder...,打开刚刚创建的模组文件夹。
在tcmod.json文件中编写模组的基本信息。
详细描述见:模组配置表
模组命名空间(modid
,又称作namespace
)是当前模组在整个模组包的唯一标识符。如果在所有加载的模组中出现了两个或多个命名空间相同的模组,这两个模组会发生冲突导致模组包加载失败。因此在命名modid
时请尽可能选择一个不容易发生冲突的模组命名空间。TerraCraft原版的命名空间为tc
或者空
。
模组命名空间的重要作用是确保所有的对象(比如方块、物品、NPC、抛射物、特效等)的名称在全局空间中是独一无二的,每个对象在全局空间的唯一名称是命名空间:名称
。通过如下简单的例子来理解:
假设当前加载了命名空间为happy_days和coco_world的两个模组,两个模组都有一个叫做dirt的方块,那么在全局空间中: (1)dirt和tc:dirt均表示TerraCraft原版的泥土方块 (2)happy_days:dirt表示happy_days模组的泥土方块 (3)coco_world:dirt表示coco_world模组的泥土方块
对于TerraCraft原版的所有对象,它们在全局空间的唯一名称是名称
或者tc:名称
,请注意区别。
请将所有JSON文件保存为UTF8
格式,否则在游戏运行过程中可能会出现乱码问题。
正确配置模组的界面如图,注意右下角必须使用UTF8
格式对JSON文件编码。
直接运行TerraCraft.exe,在菜单界面中点击“模组”按钮,若看到自己的模组在模组列表内,表示你的模组加载成功!
当游戏本体更新时,您需要将最新的empty_mod/apis
文件夹覆盖到您的模组项目的apis
文件夹中。apis文件夹用于给EmmyLua插件提供自动补全的功能。
您可以直接将鼠标置于字段上方,快速查看该字段的描述信息。
您可以按住Ctrl键并单击指定字段,可以查看对应API文件。在每个API文件最上方可以跳转到对应的文档页面。