Documentation

https://metyatech.github.io/unreal-plugin-docs/runtime-asset-import/

Release packaging

Fab packaging uses fab-plugin-release-tools at commit de784111d9e88a3e13205494aa56ccb12a8740f3 (version 0.3.1). The product repository must be completely clean, and release output must be outside the product repository.

The local wrapper resolves the tools checkout from -ReleaseToolsRoot, FAB_PLUGIN_RELEASE_TOOLS_ROOT, or the sibling fab-plugin-release-tools directory, in that order:

pwsh .\PackageForFab.ps1 `
  -EngineVersion 5.8 `
  -ReleaseToolsRoot ..\fab-plugin-release-tools

To choose an explicit output directory:

pwsh .\PackageForFab.ps1 `
  -EngineVersion 5.8 `
  -ReleaseToolsRoot ..\fab-plugin-release-tools `
  -OutputDirectory ..\FabArtifacts\RuntimeAssetImport\UE5.8

The wrapper delegates packaging to the pinned central tool. It does not implement a product-specific ZIP or descriptor transformation. A successful release produces these four files:

RuntimeAssetImport_<VersionName>_UE<version>_Win64.zip
RuntimeAssetImport_<VersionName>_UE<version>_Win64.zip.sha256
RuntimeAssetImport_<VersionName>_UE<version>_Win64.zip.report.json
RuntimeAssetImport_<VersionName>_UE<version>_Win64.zip.log

Packaged smoke

The Shipping smoke validates the central release ZIP, checksum, report, log, safe extraction, and the existing FBX, OBJ, DAE, glTF, GLB, texture, buffer, geometry, material, collision, owner-transform, Assimp, memory-I/O, and compressed-texture checks. The default Sample repository is the clean main branch at commit b4c78058993e68a62fc9c16b673aec65ee668573.

To package and run the smoke in one command:

pwsh .\RunPackagedSmoke.ps1 `
  -EngineVersion 5.8 `
  -ReleaseToolsRoot ..\fab-plugin-release-tools `
  -SampleRoot ..\RuntimeAssetImportSample

To reuse an existing release ZIP, do not rerun packaging:

pwsh .\RunPackagedSmoke.ps1 `
  -EngineVersion 5.8 `
  -SampleRoot ..\RuntimeAssetImportSample `
  -PackageZipPath ..\FabArtifacts\RuntimeAssetImport_1.0.0_UE5.8_Win64.zip

The ZIP is inspected before extraction. Entry names must use safe relative paths, have one RuntimeAssetImport top-level directory, contain no case-insensitive duplicates or file/directory collisions, and remain under the temporary extraction root. The source Sample checkout is never modified; the smoke changes only its temporary main clone.

AGENTS.md is generated by compose-agentsmd and must not be edited by hand.