ATLYSS: Atlyss old saves conversion tool

HELP FOR “ATLYSS CHARACTER DATA CONVERTER, version 1.0.0”

Written by
Nomid Lomysz

INDEX
0. INTRODUCTION
1. DATA FILES
1.1 CHARACTER DATA
1.2 SHARED INVENTORY
2. USING THE SOFTWARE
2.1 MAIN FORM
2.2 CONVERT FORM
3. F.A.Q.
4. CREDITS & THANKS

This software was created by Nomid Lomysz to convert the save data format from the pre-release
versions of the game ATLYSS to the new one.

In this help document, the “new format” refers to the one available at the time
of writing, which is version “Beta 1.0.0b”.

This program supports different alpha and beta formats for both itemBanks and
characterData files and should work out of the box.

Link to the tool: https://drive.google.com/file/d/1rHN5QqMzYfp67nohzTO6LRAgMhs6Gqx4/view?usp=drive_link

Originally posted by Nomid Lomysz:

Disclaimer: As a developer myself, I feel I must inform you that the game files were created using a potentially unsafe obsolete Microsoft technology, which this tool requires to use in order to function correctly.

The use of this program should be safe as long as the files have not been specifically crafted to be harmful.

That being said, by using this MIT-licensed software, you agree to the legal terms specified in the License.txt file that comes with this program.

=== 1.1 CHARACTER DATA ====

You can find them in your game folder at the path:
ATLYSS_Data\profileCollections

The files containing your characters data are named this way:
characterProfile_X

where “X” is the number corresponding to the order in which you see it
listed in the game profile selector, starting by number 0.

in the new version of the game (at the time of writing), the files are
named atl_characterProfile_X.

=== 1.2 SHARED INVENTORY ===
You can find the objects you put in the Storage (“Spike”) in your game folder
at the path:
ATLYSS_Data\profileCollections

The files containing your storage data are named this way:
itemBank => The first page of the storage
itemBank_01 => The second page of the storage
itemBank_02 => The third page of the storage

in the new version of the game, (at the time of writing), the files are
named the same, juxtaposed to the prefix “atl_”; for example: atl_itemBank

This software consists of 2 forms (windows), to which I’ll refer with
“Main Form” and “Convert Form”.

=== 2.1 Main Form ===

As you open the program, the Main Form shows.
You can interact with three UI elements:
A. The DROP FILES area, in which you drop the files to be converted
B. The HELP button, which opens this HELP file
C. The INFO link, which opens an URL to my Telegram channel

The DROP FILES area will accept any number of valid character or sotrage data
files, and reject the selection if the provided files are not considered to be
valid.

Start by dragging your files from your folder, and drop into the DROP FILES
area.

The files will be processed – it usually takes under one second – and the
Convert Form will open in case of success, or an error message box will be
displayed if failure occurs.

=== 2.2 Convert Form ===

On the left, you will be presented with the list of input files, organized in
columns with the metadata extracted by them.

Notice: for Character Data files, the Game Version will always match the
game version for which it was created; for Item Banks instead, either
“pre-Beta” or “Beta” will be shown, as the format for those did not change
in a sufficient way to discriminate the exact versions of the game.

On the right, will be presented with a read-only text box, initially with a
text asking you to select a file from the list.

Once you select the file, two things will happen:
– The Save button will be enabled
– The text box will be filled with the contents of the game file in JSON
format.

After that, you can click the Save button to choose the location of the new
file.
Please refer to section 1. “DATA FILES”, for the correct names and locations.

The button will save JUST THE SELECTED file; this choise was made for
simplicity so you always know what you are looking at.

3.1 WILL THE MAIN FORM ACCEPT THE NEW JSON FORMAT IN INPUT ?

If you drop a file with the new json format, it will be rejected, as it
only processed the pre-release binary format.

🎂 IS THE TOOL CREATOR PROFILE CHARACTER A BNNUY ?

No. It’s a blue red squirrel.
Red squirrels have long ear tufts.
Well, some do.

3.2 MY FILES ARE CORRECT AND PASS THE MAIN FORM. WHY DOES THE CONVERT FORM REJECT THEM?
It might be for two main reasons:
1. The game files are corrupted
2. The game files contain some metadata which I forgot to map.

Either the case, you are free to contact me or the tool creator and ask for a solution.

Notice: Because of the technology’s limitation, logs are not a suitable
way for debugging these specific conversion issues. He may ask for your
data files, in which case he encourages you to blank out sensible data
in those files like your character name. To do it, open the character
data file in a suitable hexadecimal editor like HxD (you can get it for
free at https://mh-nexus.de/en/hxd/), and replace the name with other
characters. WARNING: the length of the name must be the same and cannot
be removed, shrunk or enlarged because of the binary format
specification used by those files.

3.3 WHERE ARE MY ACTIVE QUESTS !?

Quests have changed in the new version of the game, and a 1:1 porting isn’t
directly possible. To avoid issues like the game crashing when
attacking mobs, he decided not to include the active quests in the
migrated data.

3.4 WHY ARE ALL MY ITEMS “DIVINE” ?

This is a known issue he is investigating. The only thing that this implies
is that the item cannot be further enchanted. The item otherwise works.

Originally posted by Nomid Lomysz:

The software is my own developement, but not only programming was part of the
process.

I give my thanks to Roundy and Miki, ones of my once-in-a-lifetime friends who
initially asked me if I could try writing the converter.

They supported me and provided me the required information for writing the
software, but most of all, first introduced me to the game.

Last but not least, thanks to “KisSoft”, which made this awesome little game we
all love in the community.

==== Enjoy !
Everything is Animation.