SatisfactoryTools 安装与配置指南

1. 项目基础介绍

SatisfactoryTools 是一款用于规划和构建完美基地的工具，适用于《Satisfactory》游戏。这款工具可以帮助玩家更有效地管理资源，规划工厂布局。项目主要使用 TypeScript 进行开发，辅以 HTML、SCSS、PHP 和 JavaScript 等编程语言。

2. 项目使用的关键技术和框架

• TypeScript：一种由微软开发的开源编程语言，它是 JavaScript 的一个超集，为 JavaScript 提供了静态类型检查和面向对象编程特性。
• HTML/CSS：用于构建网页结构和样式的基础技术。
• PHP：一种广泛使用的开源服务器端脚本语言，用于处理服务器端的逻辑。
• Node.js：基于 Chrome V8 引擎的 JavaScript 运行环境，用于运行 JavaScript 代码。
• Yarn：一个快速、可靠、安全的依赖关系管理工具，用于管理和安装 Node.js 应用程序的依赖项。

3. 安装和配置准备工作

在开始安装之前，请确保您的系统已安装以下软件和依赖项：

• Node.js 版本 16（较低版本可能也可以，但 17+ 版本不行）。
• Yarn 包管理器。
• PHP 版本 7.1+。

安装步骤

1. 克隆项目仓库

   打开命令行工具，运行以下命令以克隆项目仓库：

   git clone [e-mail]:greeny/SatisfactoryTools.git
   

2. 安装依赖项

   切换到项目目录，然后使用 Yarn 安装项目依赖项：

   cd SatisfactoryTools
   yarn install
   

3. 构建项目

   安装完依赖项后，运行以下命令构建项目：

   yarn build
   

4. 设置虚拟主机

   使用 Apache 或 Nginx 等服务器软件，设置一个指向 /www 目录的虚拟主机。

5. 更新数据文件

   从游戏安装目录中获取最新的 Docs.json 文件，将其放置在项目的 data 文件夹中。然后运行以下命令更新 data.json 文件：

   yarn parseDocs
   

   这将自动生成一个 diff.txt 文件，记录两个文件之间的差异，以及一个 imageMapping.json 文件，用于更新图标。

6. 更新图标

   使用 umodel（UE Viewer）程序从游戏包中提取图片。运行以下命令（根据需要替换路径）：

   .\u\model.exe -path="C:\Program Files\Epic Games\SatisfactoryExperimental\FactoryGame\Content\Paks" -out="./out256" -png -export *256.uasset -game=ue4.22
   .\u\model.exe -path="C:\Program Files\Epic Games\SatisfactoryExperimental\FactoryGame\Content\Paks" -out="./out256" -png -export *256_New.uasset -game=ue4.22
   

   将提取的 out256 文件夹复制到 data/icons 目录下，然后运行以下命令：

   yarn generateImages
   

   注意：在运行 yarn generateImages 命令之前，必须先运行 yarn parseDocs 命令。

完成以上步骤后，您就可以开始使用 SatisfactoryTools 来规划您的游戏基地了。