/ddlcdecrypt

Quick and dirty decryptor for Doki Doki Literature Club Plus! encrypted Unity assets.

Primary LanguagePythonMIT LicenseMIT

ddlcdecrypt

A quick and dirty Python 3.10+ decryptor for encrypted Doki Doki Literature Club Plus! Unity asset files.

Disclaimer and motivations

I originally created this tool as a way to prepare the assets bundles for extraction, for personal use.

In no way shall I be responsible for your use of any assets you extract. Make sure to review Team Salvato's IP guidelines concerning the "Additional Notes About DDLC Plus".

Installation

Simply head to the releases page and download the latest release's .whl file. Then, to install for the current user of a Linux-based system, execute:

python3 -m pip install --user <filename>

If your system is Windows, simply replace python3 with python.exe.

Usage

A brief help message can be displayed by running:

ddlcdecrypt -h

Here, valid assets files are those ending in .cy. Additionally, the output directory shall be created if missing, including any intermediate directories.

Once processed, the resulting .bin files can be loaded and inspected in your Unity assets explorer of choice.

Overriding key verification

This tool contains basic verification to ensure that the files supplied to it can be decrypted with the hardcoded key. If a file appears to be invalid, a warning is emitted and the file is skipped.

While this behavior is most likely what you want, you can force such files to be processed by passing the --no-verify flag - but be warned that the resulting files may be unusable.

Open an issue if you notice a warning concerning an invalid key.

Displaying progress information

This tool doesn't normally output info unless errors occur, you can display the file being processed by passing the -v flag.

License

This program is licensed under the terms of the MIT license.

Check LICENSE.txt for further info.