rakaly/cli

Rakaly server commands exposed locally

Rakaly CLI

The Rakaly CLI provides a convenient way of accessing Rakaly functionality locally.

Features

• ✔ Supports converting (melting) EU4, CK3, HOI4, and Imperator Rome saves to their plaintext equivalent
• ✔ Cross platform: run rakaly-cli on mac, windows, and linux
• ✔ Lightweight: Small executable that can be download and ran -- no dependencies

Install

• Go to the latest releases
• Download desired build (mac, windows, or linux)
• Extract
• (optional): Add to your computers path for easier access
  • For windows, PATH can be modified through the GUI or the terminal
• Enjoy

Documentation

Melting Save Files

Rakaly CLI can convert binary encoded saves to their plaintext equivalent in a process called melting.

rakaly melt aq.eu4

The above example will create a plaintext aq_melted.eu4 file that one can open up and inspect in a text editor. Moreover, this melted save may be continued in EU4 as if it was a normal game (the other games remain untested in this aspect).

The melt command determines how to interpret the save file by looking at the extension (.eu4, .rome, .hoi4, or .ck3).

If outputting to stdout is more your style:

rakaly melt --to-stdout aq.eu4

Whenever there is a content patch for the supported games, the rakaly-cli will be out of date until the next update. The default behavior of the melt command is to fail when unexpected tokens from the new content is encountered. To make the melt command perserve through the tokens and encode them as hexadecimals in the output:

rakaly melt --unknown-key stringify aq.eu4

When unknown tokens are encountered with the stringify strategy then the unknown tokens are printed to stderr and the exit code is 1.

The melter knows how to melt a given file based on its file extension. In the event this heuristic is incorrect, one can explicitly provide the desired format:

rakaly melt --format eu4 --to-stdout gamestate

Conversion to JSON

The json subcommand will convert game and save files (including binary ones) into JSON output on stdout.

rakaly json aq.eu4

The output can be pretty printed:

rakaly json --pretty aq.eu4

By default, duplicate keys are preserved in the JSON, but this can be configured:

rakaly json --duplicate-keys preserve  aq.eu4
rakaly json --duplicate-keys group aq.eu4
rakaly json --duplicate-keys key-value-pairs aq.eu4

When converting game files, pass the character encoding so that non-ascii characters are represented correctly:

rakaly json --format windows-1252 achievements.txt

cli's Issues

Expose additional rakaly API endpoints

Not sure what this would look like but if this is about exposing server commands locally:

• PATCH aar
• PATCH filename
• DELETE save
• List saves
• Download save

Vicky 3 dates parsed wrong

When trying to parse a vicky 3 save it will fail to parse the dates. It turns the date string into an int causing the save to be loaded wrong. For an example melt a vicky 3 file and check admirals/generals cooldown_repair_date value.

Json command not working as expected with ck3 saves

With 0.5.1, the JSON command does not work directly with the original ck3 saves. Ironman saves must be melted, then removing .ck3 from the deserialized save. Non-Ironman must be unzipped first now.

Exe in Windows is not working

Hi ,
i have downloaded the latest version for windows and extracted it but nothing happens when i try to open. I have tried the previous version as well.
Even with checking my registry entries regarding exe values and calling the exe out of the cmd it just shows a short window for if i really want to start it and when i confirm nothing happens. Any idea what i'm doing wrong? The Antivir program is disabled as well.

Is there a simple way to add this to path on windows?

Simple question. I know this is probably a general skill and not specific to this app but I think it would be good to link a tutorial in the readme.