unreal-plugin-pkg v0.1.5
Unreal Plugin Packager
A simple CLI tool to batch build and package Unreal plugins across multiple versions of Unreal.
Installation
npm install unreal-plugin-pkg
yarn global add unreal-plugin-pkg
Usage
Usage: unreal-plugin-pkg [options] [uplugin]
Options:
--unrealDirs <paths...> List of directories to search for Unreal installations in
--versions <versions...> List of Unreal versions to build your plugin for
--out <outDir> Directory to compile the packages into. One folder will be created inside per version.
--platforms <platforms...> Platforms to build for. Will be pruned to those supported by the current OS.
--keepIntermediate Don't cleaning the Intermediate folders after builds
--cleanBinaries Delete Binaries folders after builds
--nozip Don't zip packages once they've been built
-h, --help display help for command
Example
To build a plugin in the current directory for Windows and Android using Unreal versions 4.24, 4.25, and 4.26, run:
unreal-plugin-pkg --versions 4.24 4.25 4.26 --platforms Win64 Android --out out/
All packages will be placed in the output folder out/
Configuration File
If you're repeatedly using the same arguments, consider creating a unreal-package.json
file.
Example:
{
"UnrealEnginePaths": ["C:\\Program Files\\Epic Games", "E:\\Unreal Installs"],
"VersionsToInstall": ["4.26", "5"],
"PluginPath": ".",
"OutputPath": "out/",
"Platforms": ["Win64", "Android"],
"CleanBinaryFiles": true,
"CleanIntermediateFiles": true,
"ZipPackages": false
}
Unreal Installation Directories
By default, this program will search for Unreal installs at C:\Program Files\Epic Games
for Windows and Users/Shared/Epic Games
on Mac.
You can override this by changing the --unrealDirs
command-line options or UnrealEnginePaths
in unreal-package.json
. Both accept an array of arguments that can either be the exact directory of an Unreal installation (eg. `C:\Program Files\Epic Games\UE_4.26) OR a path that contains subfolders which are Unreal installations.
Version Numbers
When specifying versions to install, you can be as specific or general as you'd like. The program will select the newest version that matches the given version.
So specifying 4
would use the newest version of Unreal 4 installed. Specifying 4.26
will use the latest 4.26 installed. 4.26.1
will require that an installed version of Unreal matches 4.26.1
exactly.
Plugin Path
The plugin path can be either a .uplugin
file or a folder which contains a .uplugin
file.
Zipping
By default, this program will zip each packaged folder into a zip archive of the same name. If you don't want this, use --nozip
.
Binary and Intermediate Files
By default, this program deletes the Intermediate folder in each package before zipping it. If you don't want that, use --keepIntermediate
.
If you want to also delete the Binaries folder, use --cleanBinaries
.