SII_Decrypt/program_readme.txt at master · AlexKERNEL/SII_Decrypt · GitHub

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
================================================================================

                         SII Decrypt project - programs

                                version 1.4.2

================================================================================

Index
------------------------------

  Index ...................................................   9
  Description .............................................  23
  Use of the program ......................................  41
  Changelog ...............................................  90
  Known problems and limitations .......................... 134
  Repositories ............................................ 141
  Licensing ............................................... 154
  Authors, contacts ....................................... 162
  Copyright ............................................... 175


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.

    --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.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 copies of complete SII Decrypt project, including source code
of this program, on either of these git repositories:

https://github.com/ncs-sniper/SII_Decrypt
https://bitbucket.org/ncs-sniper/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, frantisek.milt@gmail.com

Forum thread: https://forum.scssoft.com/viewtopic.php?f=34&t=245874

If you find this program useful and don't know what to do with your money ;),
consider making a small donation using one of the following links:
https://www.paypal.me/FMilt
https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=WE33UXX9ASCCJ


Copyright
----------------------------------------
©2016-2018 František Milt, all rights reserved