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.

Por supuesto, la clave necesita ser almacenada en el binario, pero si se compila, optimiza y se eliminan los símbolos, requeriría cierto esfuerzo encontrarla.

Para que esto funcione, necesitas compilar las plantillas de exportación desde el código fuente, utilizando la misma clave.

Advertencia

Esto no funcionará si utilizas plantillas de exportación oficiales precompiladas. Es absolutamente necesario compilar tus propias plantillas de exportación para usar el cifrado PCK.

Advertencia

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.

Paso a paso

  1. Genera una clave AES de 256 bits en formato hexadecimal. Puedes utilizar la variante aes-256-cbc de este servicio.

    Alternativamente, puedes generarla tú mismo utilizando las herramientas de línea de comandos de OpenSSL:

    openssl rand -hex 32 > godot.gdkey

    La salida en godot.gdkey debería ser similar a:

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

    Puedes generar la clave sin redirigir la salida a un archivo, pero de esta manera puedes minimizar el riesgo de exponer la clave.

  2. Establece esta clave como una variable de entorno en la consola que utilizarás para compilar Godot, de la siguiente manera:

    export SCRIPT_AES256_ENCRYPTION_KEY="your_generated_key"

  3. Compila las plantillas de exportación de Godot y establécelas como plantillas de exportación personalizadas en las opciones de configuración de la exportación.

  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.

Solución De Problemas

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