TerraFirma 技术文档

1. 安装指南

Windows 系统安装步骤：

1. 使用 Qt Creator 编译发行版本。
2. 将可执行文件复制到 packages/com.seancode.terrafirma/data 目录中。
3. 在开发者命令提示符中打开该目录，并运行适用于您环境的 c:\Qt\5.13.0\msvc2017_64\bin\qtenv2.bat。
4. 接下来运行 windeployqt terrafirma.exe，这将把所有必要的 dll 文件复制到该文件夹。
5. 最后，切换回 TerraFirma 主目录，并运行：

   c:\Qt\QtIFW-4.0.1\bin\binarycreator.exe -c config\config.xml -p packages terrafirmaInstall.exe
   

Linux 系统安装步骤：

1. 使用 qmake 生成 makefile，然后运行 make。
2. 要创建一个软件包，执行以下命令：

   $ debuild
   

3. 如果要为其他发行版创建软件包，执行以下命令：

   $ pbuilder-dist bionic create  # 生成环境
   $ debuild -S -us -uc
   $ cd ..
   $ pbuilder-dist bionic build *.dsc
   

OSX 系统安装步骤：

1. 使用 Qt Creator 编译 TerraFirma 的发行版本。
2. 将生成的 terrafirma.app 文件复制到 packages/com.seancode.terrafirma/data 目录中。
3. 在该目录内，运行适用于您环境的 ~/Qt/5.12.6/clang_64/bin/macdeployqt terrafirma.app。
4. 最后，切换回 TerraFirma 主目录，并运行：

   ~/Qt/QtIFW-4.0.1/bin/binarycreator -c config/config.xml -p packages terrafirmaMacOS
   

2. 项目的使用说明

TerraFirma 是一款跨平台地图工具，用于《泰拉瑞亚》游戏。最新版本支持《泰拉瑞亚》1.4 版本，并重新使用了游戏的语言文件。新增了对显示 beastiary（野兽志）的支持。

注意：由于使用《泰拉瑞亚》的本地化，TerraFirma 现在需要知道您的 Terraria.exe 的位置。默认情况下，它将使用 Steam 来帮助定位。如果无法找到，它将使用 tag 而不是翻译后的名称列出所有物品和方块。如果您希望 TerraFirma 中使用的名称与《泰拉瑞亚》中的一致，您可以手动指定 Terraria.exe 的位置。

3. 项目API使用文档

本文档中未提供关于项目 API 的具体信息。请参考项目源代码或联系项目开发者以获取详细的 API 使用说明。

4. 项目安装方式

项目的安装方式已在“安装指南”一节中详细描述，请参考相关步骤进行安装。