宝藏世界模组开发指南——制作TMod文件

TMod文件是宝藏世界的模组文件格式，它可以将你编辑的资源打包为单个文件。
还可以增加作者、描述、封面、标签等信息。

相比于将多个资源文件放入对应的override文件夹来载入，TMod文件只需要放入游戏目录的mods文件夹即可。

所以在发布你的Mod之前，一定要打包为TMod文件。
模组列表

准备

资源文件

在打包之前要确保你的资源文件能够通过override文件夹载入。

封面

其次，要为你的模组添加一个封面，格式可以是png、jpg或是blueprint。
图片的大小是400 x 230，放入游戏目录的\ui\override文件夹。

虽然资源文件放在override文件夹下，但是实际上是载入到了override的上级目录。
例如有一个文件是 ui\override\HelloWorld.png ，而它实际上被载入到了 ui\HelloWorld.png 。
所以下列操作需要填写目录时，请忽略override文件夹进行填写。

打包

接下来，你可以通过以下方法之一来生成你的TMod文件。

进行以下操作后，可到游戏目录的 mods 文件夹查看生成的模组文件。

这种方式不能精确控制打包哪些资源文件，它会打包所有通过override文件夹加载的资源文件。

在聊天窗口输入以下指令。
/buildmod title="模组名称" author="作者名称" notes="模组注释" preview="预览图片路径" tags="标签1,标签2"

指令参数中，除了title参数必须要指定，其他参数均是可选的。

例如：
/buildmod title="你好,世界!" author="Android" notes="我的第一个模组。" preview="ui/HelloWorld.png"

![BuildMod指令][BuildMod指令]
执行后，聊天区域会显示被打包的资源文件。
之后会提示指定名称的模组已创建完成。

这种方式可以精确的指定打包哪些资源文件。
但是值得吐槽的是，如果你执行的命令内包含中文则会出现乱码。

在游戏目录空白处Shift+右键，在此处打开命令窗口。
输入命令行:
Trove.exe -tool buildmod -title "模组名称" -author "作者名称" -notes "模组注释" -preview "预览图片路径" -tags "标签a,标签b,标签c,标签d" - <文件1> <文件2>

指令参数中必须要包含title、author以及要包含的文件。
命令最后文件的那一部分，需要填写模组要包含的所有资源文件，包括封面。

例如:
Trove.exe -tool buildmod -title "HelloWorld!" -author "Android" -notes "My first mod." -preview "ui/HelloWorld.png" - ui/HelloWorld.png blueprints/equipment_weapon_1h_sword_001.blueprint

这种方式可以精确的指定打包哪些资源文件，而且看起来更加易读。
个人强烈建议使用这种方式。

首先，我们在任意目录创建一个文本文件，将其扩展名命名为.yaml。
字符编码必须为UTF-8。

然后，按照以下格式编辑YAML文件。

---
title: 模组名称
author: 作者名称
notes: 模组注释
previewPath: 预览图片路径
files:
- 文件1
- 文件2
tags:
- 标签1
- 标签2
...

YAML文件中必须要指定title、author以及files。
files中你需要填写模组要包含的所有资源文件，包括封面。

例如:

---
title: 你好,世界!
author: Android
notes: 我的第一个模组。
previewPath: ui/HelloWorld.png
files:
- ui/HelloWorld.png
- blueprints/equipment_weapon_1h_sword_001.blueprint
...

然后，在游戏目录空白处Shift+右键，在此处打开命令窗口。
输入命令行:
Trove.exe -tool buildmod -meta "YAML文件路径"

例如:
Trove.exe -tool buildmod -meta "D:\TroveMod\HelloWorld\HelloWorld.yaml"