@etothepii/satisfactory-file-parser 0.4.14 → 0.4.15
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENCE.md +1 -1
- package/README.md +25 -10
- package/package.json +1 -1
- package/CHANGELOG.md +0 -12
package/LICENCE.md
CHANGED
package/README.md
CHANGED
|
@@ -8,7 +8,7 @@ This parser can read, modify and write:
|
|
|
8
8
|
- Save Files `.sav`
|
|
9
9
|
- Blueprint Files `.sbp`, `.sbpcfg`
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
# Supported Versions
|
|
12
12
|
The version support of the packages is indicated below. Some bugs might still be present, see Bug Reporting further down.
|
|
13
13
|
|
|
14
14
|
Game Version Files of U5 and below are NOT supported.
|
|
@@ -20,13 +20,10 @@ Game Version Files of U5 and below are NOT supported.
|
|
|
20
20
|
| U8 | ✅ 0.1.20 - 0.3.7 |
|
|
21
21
|
| U1.0 | ✅ >= 0.4.14 |
|
|
22
22
|
|
|
23
|
-
|
|
24
|
-
The Changelog is alongside the readme [here](./CHANGELOG.md)
|
|
25
|
-
|
|
26
|
-
## Installation via npm
|
|
23
|
+
# Installation via npm
|
|
27
24
|
`npm install @etothepii/satisfactory-file-parser`
|
|
28
25
|
|
|
29
|
-
|
|
26
|
+
# Usage of Save Parsing
|
|
30
27
|
|
|
31
28
|
I recommend parsing via stream, to save RAM. The binary data of the whole save will still be in memory, but the converted JSON can be streamed. (You can of course keep reading the stream in memory).
|
|
32
29
|
The returned `stream` is a readable WHATWG stream of type string and represents a `SatisfactorySave` object. this object can be serialized again.
|
|
@@ -89,7 +86,7 @@ fs.writeFileSync('./MyModifiedSave.sav', Buffer.concat([fileHeader!, ...bodyChun
|
|
|
89
86
|
```
|
|
90
87
|
|
|
91
88
|
|
|
92
|
-
|
|
89
|
+
## Old Save Parsing. Deprecated.
|
|
93
90
|
For reading a save file (`.sav`) and parse In-Memory, just pass a Buffer to the parser with the file content.
|
|
94
91
|
```js
|
|
95
92
|
import * as fs from 'fs';
|
|
@@ -100,7 +97,7 @@ const parsedSave = Parser.ParseSaveFile('MySave', file);
|
|
|
100
97
|
```
|
|
101
98
|
|
|
102
99
|
|
|
103
|
-
|
|
100
|
+
# Usage of Blueprint Parsing
|
|
104
101
|
Note, that blueprints consist of 2 files. The `.sbp` main file and the config file `.sbpcfg`.
|
|
105
102
|
|
|
106
103
|
```js
|
|
@@ -136,11 +133,29 @@ fs.writeFileSync('./MyModifiedBlueprint.sbp', Buffer.concat([mainFileHeader!, ..
|
|
|
136
133
|
fs.writeFileSync('./MyModifiedBlueprint.sbpcfg', Buffer.from(summary.configFileBinary));
|
|
137
134
|
```
|
|
138
135
|
|
|
139
|
-
|
|
136
|
+
# Bug Reports or Feedback
|
|
140
137
|
So far this was just a private hobby project. But i figure some people actually use it.
|
|
141
138
|
If you find a bug or have feedback about the parser, you can just hit me up on the satisfactory discord `etothepii`.
|
|
142
139
|
|
|
143
|
-
|
|
140
|
+
# Changelog
|
|
141
|
+
|
|
142
|
+
### [0.4.15] (2024-10-02)
|
|
143
|
+
#### updated README
|
|
144
|
+
* changelog document doesn't seem linkable, so it is in the readme for now.
|
|
145
|
+
|
|
146
|
+
### [0.4.14] (2024-10-02)
|
|
147
|
+
#### updated README
|
|
148
|
+
* updated the code examples with more context
|
|
149
|
+
|
|
150
|
+
### Internal renamings (won't affect you if you stick to the code examples)
|
|
151
|
+
* improved the interface for abstract parser classes
|
|
152
|
+
* extended some error log messages
|
|
153
|
+
* added an additional check when parsing struct property InventoryItem, since ported saves often have a few more bytes.
|
|
154
|
+
* changed function name `writeFloat()` to `writeFloat32()` of the save writer.
|
|
155
|
+
* changed variable name `saveOrBlueprintIndicator` to `objectVersion` for objects, since the meaning of that number became now more clear.
|
|
156
|
+
|
|
157
|
+
|
|
158
|
+
# License
|
|
144
159
|
MIT License
|
|
145
160
|
|
|
146
161
|
Copyright (c) 2024 etothepii
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@etothepii/satisfactory-file-parser",
|
|
3
3
|
"author": "etothepii",
|
|
4
|
-
"version": "0.4.
|
|
4
|
+
"version": "0.4.15",
|
|
5
5
|
"description": "A file parser for satisfactory files. Includes save files and blueprint files.",
|
|
6
6
|
"types": "./build/index.d.ts",
|
|
7
7
|
"main": "./build/index.js",
|
package/CHANGELOG.md
DELETED
|
@@ -1,12 +0,0 @@
|
|
|
1
|
-
# Changelog
|
|
2
|
-
|
|
3
|
-
## [0.4.14] (2024-10-02)
|
|
4
|
-
### updated README
|
|
5
|
-
* updated the code examples with more context
|
|
6
|
-
|
|
7
|
-
### Internal renamings (won't affect you if you stick to the code examples)
|
|
8
|
-
* improved the interface for abstract parser classes
|
|
9
|
-
* extended some error log messages
|
|
10
|
-
* added an additional check when parsing struct property InventoryItem, since ported saves often have a few more bytes.
|
|
11
|
-
* changed function name `writeFloat()` to `writeFloat32()` of the save writer.
|
|
12
|
-
* changed variable name `saveOrBlueprintIndicator` to `objectVersion` for objects, since the meaning of that number became now more clear.
|