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