Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

Compiling with PCK encryption key

The export dialog gives you the option to encrypt your PCK file with a 256-bit AES key when releasing your project. This will make sure your scenes, scripts and other resources are not stored in plain text and can not easily be ripped by some script kiddie.

Of course, the key needs to be stored in the binary, but if it's compiled, optimized and without symbols, it would take some effort to find it.

これが機能するためには、同じキーを使用してソースからエクスポートテンプレートを構築する必要があります。

警告

This will not work if you use official, precompiled export templates. It is absolutely required to compile your own export templates to use PCK encryption.

警告

By default, Android exports store assets directly in the APK file and aren't affected by PCK encryption. To use PCK encryption on Android, enable APK expansion in the export options.

ステップ・バイ・ステップ

  1. Generate a 256-bit AES key in hexadecimal format. You can use the aes-256-cbc variant from this service.

    Alternatively, you can generate it yourself using OpenSSL command-line tools:

    openssl rand -hex 32 > godot.gdkey

    The output in godot.gdkey should be similar to:

    # NOTE: Do not use the key below! Generate your own key instead.
aeb1bc56aaf580cc31784e9c41551e9ed976ecba10d315db591e749f3f64890f

    出力をファイルにリダイレクトせずにキーを生成できますが、その方法でキーを公開するリスクを最小限に抑えることができます。

  2. 次のように、このキーをGodotのコンパイルに使用するコンソールの環境変数として設定します:

    export SCRIPT_AES256_ENCRYPTION_KEY="your_generated_key"

  3. Godotエクスポートテンプレートをコンパイルし、エクスポートプリセットオプションでカスタムエクスポートテンプレートとして設定します。

  4. Set the encryption key in the Encryption tab of the export preset:

    ../../../_images/encryption_key.png

  5. Add filters for the files/folders to encrypt. By default, include filters are empty and nothing will be encrypted.

  6. Export the project. The project should run with the files encrypted now.

トラブルシューティング

If you get an error like below, it means the key wasn't properly included in your Godot build. Godot is encrypting PCK file during export, but can't read it at runtime.

ERROR: open_and_parse: Condition "String::md5(md5.digest) != String::md5(md5d)" is true. Returning: ERR_FILE_CORRUPT
   At: core/io/file_access_encrypted.cpp:103