更新 README.md
This commit is contained in:
132
README.md
132
README.md
@@ -1,18 +1,124 @@
|
||||
#文件前32个十六进制位是头部数据，
|
||||
分别是[4位表示的version][4位表示的header_size][4位表示的timestamp][4位表示的unknown1][4位表示的unknown2][4位表示的unknown3][4位表示的material_count][4位表示的reserved]
|
||||
其中header_size不知为何总为错误的
|
||||
# 幸福工厂蓝图编辑器 - 项目文档
|
||||
|
||||
#下面为蓝图材料数据：
|
||||
## 项目概述
|
||||
|
||||
[4位表示的路径长度(包括00结束符)] [材料路径(结束用1位的00表示)] [4位表示的数量] [4位表示的参数]
|
||||
当所有材料结束时，在末尾添加4个十六进制未表示的0代表材料部分结束
|
||||
注：[4位表示的参数] 目前具体是什么未知. 但只有蓝图的最后一个材料才会有数据其他都为0. 其数值可能和蓝图绑定不得修改，蓝图的最后一个的参数必须有数据
|
||||
这是一个用于解析和编辑《幸福工厂》(Satisfactory)游戏蓝图(.sbp文件)的Web工具。用户可以上传蓝图文件，查看和修改其中的材料信息，然后下载修改后的蓝图文件。
|
||||
|
||||
#下面为建筑部分：
|
||||
## 文件结构解析
|
||||
|
||||
[4位表示的路径长度(包括00结束符)] [建筑路径(结束用1位的00表示)] [4位表示的参数]
|
||||
当建筑部分结束时尾部添加4个十六进制未的22222222代表建筑部分结束
|
||||
注：[4位表示的参数] 目前具体是什么未知. 但只有蓝图的最后一个建筑才会有数据其他都为0. 其数值可能和蓝图绑定不得修改，蓝图的最后一个的参数必须有数据
|
||||
### 1. 文件头部 (32字节/64位十六进制)
|
||||
结构如下：
|
||||
```
|
||||
[4位] version - 版本号
|
||||
[4位] header_size - 头部大小(目前总是错误的)
|
||||
[4位] timestamp - 时间戳
|
||||
[4位] unknown1 - 未知字段1
|
||||
[4位] unknown2 - 未知字段2
|
||||
[4位] unknown3 - 未知字段3
|
||||
[4位] material_count - 材料数量
|
||||
[4位] reserved - 保留字段
|
||||
```
|
||||
|
||||
#下面是压缩部分：
|
||||
此部分为Zlib压缩后数据 具体内容没分析 不做分析
|
||||
### 2. 材料部分
|
||||
每个材料的结构：
|
||||
```
|
||||
[4位] 路径长度(包括null结束符)
|
||||
[变长] 材料路径(以00结束)
|
||||
[4位] 数量
|
||||
[4位] 参数(只有最后一个材料有值)
|
||||
```
|
||||
材料部分以`00000000`结束
|
||||
|
||||
### 3. 建筑部分
|
||||
每个建筑的结构：
|
||||
```
|
||||
[4位] 路径长度(包括null结束符)
|
||||
[变长] 建筑路径(以00结束)
|
||||
[4位] 参数(只有最后一个建筑有值)
|
||||
```
|
||||
建筑部分以`22222222`结束
|
||||
|
||||
### 4. 压缩数据部分
|
||||
Zlib压缩的数据，工具不做解析
|
||||
|
||||
## 功能说明
|
||||
|
||||
### 主要功能
|
||||
1. **文件上传**：支持.sbp蓝图文件上传
|
||||
2. **头部信息展示**：显示蓝图文件的头部信息
|
||||
3. **材料编辑**：
|
||||
- 查看所有材料及其属性
|
||||
- 修改材料路径和数量
|
||||
- 添加/删除材料
|
||||
4. **建筑信息展示**：显示建筑信息(只读)
|
||||
5. **数据下载**：将修改后的数据保存为.sbp文件
|
||||
|
||||
### 特殊处理
|
||||
1. 材料部分的最后一个条目必须有参数值
|
||||
2. 建筑部分的最后一个条目必须有参数值
|
||||
3. 自动更新材料数量计数
|
||||
|
||||
## 使用说明
|
||||
|
||||
1. 点击"选择文件"按钮上传.sbp蓝图文件
|
||||
2. 在"材料资产"部分可以：
|
||||
- 修改材料路径(需使用正确的游戏资源路径)
|
||||
- 修改材料数量
|
||||
- 添加新材料(点击"添加材料"按钮)
|
||||
- 删除材料(点击材料条目右侧的删除按钮)
|
||||
3. 修改完成后点击"下载蓝图"按钮保存文件
|
||||
|
||||
## 注意事项
|
||||
|
||||
1. 材料路径需要正确的游戏资源路径格式，可以参考其他蓝图文件中的路径
|
||||
2. 最后一个材料的参数值必须保留，不能删除
|
||||
3. 建筑信息目前是只读的，不能修改
|
||||
4. 压缩数据部分目前不做解析，下载时会原样保存
|
||||
|
||||
## 技术实现
|
||||
|
||||
- 前端框架：Vue.js
|
||||
- UI组件库：DaisyUI
|
||||
- 文件处理：使用JavaScript的FileReader和ArrayBuffer处理二进制数据
|
||||
- HEX转换：自定义方法实现字符串与十六进制的相互转换
|
||||
|
||||
## 项目结构
|
||||
|
||||
```
|
||||
├── index.html
|
||||
├── src/
|
||||
│ ├── App.vue # 主组件
|
||||
│ ├── main.js # 入口文件
|
||||
│ └── assets/ # 静态资源
|
||||
└── README.md # 项目说明
|
||||
```
|
||||
|
||||
## 开发说明
|
||||
|
||||
1. 克隆仓库：
|
||||
```
|
||||
git clone https://git.liulikeji.cn/xingluo/satisfactory-BlueprintsEdit.git
|
||||
```
|
||||
2. 安装依赖：
|
||||
```
|
||||
npm install
|
||||
```
|
||||
3. 运行开发服务器：
|
||||
```
|
||||
npm run dev
|
||||
```
|
||||
4. 构建生产版本：
|
||||
```
|
||||
npm run build
|
||||
```
|
||||
|
||||
|
||||
## 未来计划
|
||||
|
||||
1. 添加建筑配方或超频编辑功能
|
||||
2. 支持压缩数据的解析和修改
|
||||
3. 添加材料图标
|
||||
|
||||
## 贡献指南
|
||||
|
||||
欢迎提交Pull Request或Issue报告问题。对于新功能建议，请先创建Issue讨论。
|
||||
Reference in New Issue
Block a user