-
-
Notifications
You must be signed in to change notification settings - Fork 14
/
program_readme.txt
200 lines (133 loc) · 7.07 KB
/
program_readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
================================================================================
SII Decrypt project - programs
version 1.5.3
================================================================================
Index
------------------------------
Index ................................................... 9
Description ............................................. 23
Use of the program ...................................... 41
Changelog ............................................... 96
Known problems and limitations .......................... 161
Repositories ............................................ 168
Licensing ............................................... 180
Authors, contacts ....................................... 188
Copyright ............................................... 198
Description
------------------------------
This program is designed to decrypt and/or decode SII files that are used as a
mean of storing save data in truck games developed by SCS Software. It was
successfully tested on saves from Euro Truck Simulator 2 and American Truck
Simulator and therefore should work for those games.
Unlike in previous version, you do not need to change save format the game is
using. Current version of this program can understand the now used binary format
and will convert it to a human readable textual form. However, as the binary
format specification is not public, the decoding cannot be fully tested and
therefore might not work in rare circumstances or in future games. If that
happens, you can disable it by command no_decode (but in that case, you have to
configure the game to again store the saves in textual form).
The program can also decode 3nK-encoded SII files used for example in
localization.
Use of the program
------------------------------
Using the GUI program should be simple enough. Just run it and use provided
controls (buttons, edits, ...) to select input and output files, set processing
settings and so on.
To use command line utility, run it with proper command line parameters.
For normal user not familiar with command line, it simple means dropping file
that has to be decrypted on the utility icon.
More advanced user can use one of two available parameter schemes - simple and
extended.
Simple scheme
SII_Decrypt.exe InputFile [OutputFile]
There are no commands available in the simple scheme. Program just takes first
parameter as input file path and second parameter, if present, as an output
file path. If output path is not specified, the result is stored back into
input file.
Extended scheme
SII_Decrypt.exe [commands] -i InputFile [-o OutputFile]
Extended scheme allows you to use commands when invoking the utility. Output
file is optional and when not specified, the result is stored back into input
file.
Available commands are:
--no_decode When present, the program will not attempt to decode the
file, only decryption will be done. Can be used when there
are problems with the decoding.
--dec_unsupp Enables experimental decoding of unsupported types when the
decoding is attempted. As the implementation cannot be
checked in any way, use of this option is dangerous (might
damage saves) and you will be using it at your own risk.
--sw_aes AES decryption will be done completely in software.
Normally, AES can use hardware acceleration when supported
by hardware, this command disables it.
--on_file All processing will be done directly on the file. When not
present, entire file is loaded into memory and processed
there, this command can therefore lower memory use (but not
by a much).
--wait Program will not close the console when processing is done
and will wait for user input. Can be used when you want to
see possible error code.
Changelog
----------------------------------------
List of changes between individual versions of this program.
SII Decrypt program 1.5.2 -> SII Decrypt program 1.5.3
- value type 0x32 moved from experimental to supported
- added support for format version 3
SII Decrypt program 1.5.1 -> SII Decrypt program 1.5.2
- added support for decoding of value types 0x2F and 0x07
SII Decrypt program 1.5 -> SII Decrypt program 1.5.1
- added button for copying input file path to output file path
- added donation banner to GUI program
SII Decrypt program 1.4.2 -> SII Decrypt program 1.5
- added an option to activate experimental decoding of unsupported types
in binary SII files
- added support for decoding of value type 0x17
- added decryptor object functions to the library (DLL)
SII Decrypt program 1.4.1 -> SII Decrypt program 1.4.2
- GUI program now parses command line parameters and uses them to preset
input and output files
- added support for decoding of value type 0x0A
SII Decrypt program 1.4.0 -> SII Decrypt program 1.4.1
- corrected behaviour in case a value in binary format contains NaN
SII Decrypt program 1.3.2 -> SII Decrypt program 1.4.0
- added program with graphical user interface (window)
- added support for decoding of 3nK-encoded files
- reduced memory use by implementing streaming conversion
- changed behaviour of the DLL library, added new functions
SII Decrypt program 1.3.1 -> SII Decrypt program 1.3.2
- changed decoding of encoded strings
SII Decrypt program 1.3.0 -> SII Decrypt program 1.3.1
- corrected managing of erroneous data in IDs
SII Decrypt program 1.2.2 -> SII Decrypt program 1.3.0
- added support for BSII file of format version 1
- some minor internal changes
SII Decrypt program 1.2.1 -> SII Decrypt program 1.2.2
- added support for new value types (0x37)
SII Decrypt program 1.2 -> SII Decrypt program 1.2.1
- small optimizations
- internal and implementation changes
Known problems and limitations
----------------------------------------
As mentioned before, decoding might not be 100% reliable. In case of
problems, contact author or run the tool with command no_decode.
Repositories
----------------------------------------
You can get actual copy and source code of SII Decrypt project on the following
git repository:
https://github.com/TheLazyTomcat/SII_Decrypt
Note - master branch does not contain binaries, you can find them in a branch
called "bin".
Licensing
----------------------------------------
Program is licensed under Mozilla Public License Version 2.0. You can find full
text of this license in file license.txt or on web page
https://www.mozilla.org/MPL/2.0/.
Authors, contacts, links
----------------------------------------
František Milt, [email protected]
If you find this program useful and don't know what to do with your money ;),
consider making a small donation using the following link:
https://www.paypal.me/FMilt
Copyright
----------------------------------------
©2016-2023 František Milt, all rights reserved