GodotAssetBundle

GodotAssetBundle is an export plugin for the Godot editor. It splits assets in designated folders into independent .pck bundles during project export.

It separates DLC, chapter content, skins, level packs and optional art assets from the main package to reduce main package size, supporting on-demand distribution and asset loading.

Features

• Folder-level bundling: Place an AssetBundle file inside a folder to export the folder as an individual asset pack.
• Automatic main package exclusion: Assets included in sub-bundles will be excluded from the main build to avoid duplication.
• Automatic dependency collection: Analyzes asset references and packs related imported files, .import configs and remap files together.
• Full compatibility with scenes and regular assets: Preserves valid runtime file paths for all resource types.
• Native PCK format output: Bundles generated via official Godot PCKPacker, compatible with standard asset loading methods.

Usage

1. Put the addons/asset_bundle folder into your project's addons directory.
2. Navigate to Project > Project Settings > Plugins in editor and enable GodotAssetBundle.
3. Create an AssetBundle resource file inside the target folder for bundling.
4. Configure bundle parameters:
   • enabled: Toggle this asset pack on or off
   • export_enabled: Decide whether to generate the bundle on export
   • pack_external_dependencies: Include out-of-folder dependencies, enabled by default
5. Export the project normally. A subpackages folder containing generated .pck files will be created in the output directory.
6. Load bundles at runtime with official Godot API:

ProjectSettings.load_resource_pack("res://subpackages/example.pck")

Adjust the file path according to your publish directory and target platform.

Directory Structure

addons/
  asset_bundle/
    AssetBundle.gd                  # Bundle metadata resource
    AssetBundlePackUtils.gd          # Dependency collecting & packing tool
    export_plugin.gd                 # Core export logic
    plugin.gd                        # Plugin entry
    processors/
      AssetBundleResourceProcessor.gd

Notes

• This plugin only handles bundle exporting, automatic download and mounting are not supported.
• All bundled assets should be stored under the folder with the AssetBundle file.
• External dependencies will be packed automatically unless pack_external_dependencies is disabled.
• When external dependency packing is off, only intra-folder references are collected; external assets need to be provided by main package or other bundles.
• Exported .pck files inherit names from corresponding AssetBundle resources.