Documentation

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

Release packaging

Fab packaging uses fab-plugin-release-tools at the commit recorded in PackageForFab.ps1 (version 0.4.0). 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. It stages the package under a renamed Plugins/FabReviewRenamedFolder directory, then removes only the temporary packaged Assimp DLLs and verifies both file and memory imports fail cleanly with diagnostic logs. 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.1_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.

The Fab package carries the required Assimp runtime payload and assimp.tps notice container. Source license provenance files remain in the repository but standalone license files are excluded from the Fab package.

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