A collection of utilities around basic functions regarding the environment of the Engine we're working with. More...

Static Public Member Functions
static void	WriteJson (object input, AbsolutePath path)
	Write data in JSON with Unreal conventions of JSON format.

static void	InvalidateEnginePathCache ()
	In the rare and unlikely case that the Engine location may have changed during one session.

static AbsolutePath	GetEnginePath (string engineAssociation, bool ignoreCache=false)
	Get the Unreal Engine path based on an input association text. (version, GUID or absolute path)

static EngineVersion	Version (UnrealBuild build)
	Get high-level version of currently used Engine.

static UnrealCompatibility	AndLater (this UnrealCompatibility compatibility)
	Create a compatibility flag mask which indicates that a feature is available un-broken in given and the following versions of Unreal Engine.

static bool	Is4 (UnrealBuild build)
	Are we working with UE4.

static bool	Is5 (UnrealBuild build)
	Are we working with UE5.

static bool	IsInstalled (AbsolutePath enginePath)
	Is given path a vanilla engine most probably installed via the Marketplace?

static bool	IsInstalled (EngineVersion ofVersion)
	Are we working with a vanilla engine most probably installed via the Marketplace?

static bool	IsInstalled (UnrealBuild build)
	Are we working with a vanilla engine most probably installed via the Marketplace?

static bool	IsSource (AbsolutePath enginePath)
	Is given path an engine built from source?

static bool	IsSource (EngineVersion ofVersion)
	Are we working with an engine built from source?

static bool	IsSource (UnrealBuild build)
	Are we working with an engine built from source?

static AbsolutePath	GetEnginePath (UnrealBuild build)

static UnrealPlatformFlag	GetDefaultPlatform ()
	Get the current development platform Nuke.Unreal is ran on.

static AbsolutePath	MacRunMono (EngineVersion ofVersion)
	On Mac many Unreal tools need the Mono bootstrap.

static Tool	BuildTool (EngineVersion ofVersion)
	Prepare invocation for UBT.

static Tool	BuildTool (EngineVersion ofVersion, Action< UbtConfig > config)
	Prepare invocation for UBT with extra fluent-API configuration.

static Tool	BuildTool (UnrealBuild build)
	Prepare invocation for UBT.

static Tool	BuildTool (UnrealBuild build, Action< UbtConfig > config)
	Prepare invocation for UBT with extra fluent-API configuration.

static Tool	AutomationTool (EngineVersion ofVersion)
	Prepare invocation for UAT.

static Tool	AutomationTool (EngineVersion ofVersion, Action< UatConfig > config)
	Prepare invocation for UAT with extra fluent-API configuration.

static Tool	AutomationTool (UnrealBuild build)
	Prepare invocation for UAT.

static Tool	AutomationTool (UnrealBuild build, Action< UatConfig > config)
	Prepare invocation for UAT with extra fluent-API configuration.

static void	ClearFolder (AbsolutePath folder)
	Clear intermediate folders of Unreal from a given folder.

static string	ReadCopyrightFromProject (AbsolutePath projectFolder)
	Read copyright info from the project's `DefaultGame.ini`

static Tool	GetTool (UnrealBuild build, string name)
	Get a native binary tool from `Engine/Binaries` folder. Unreal tools written in C# or stored in other folders/sub-folders are not supported. You can omit the `Unreal` part of the tool name.

Static Public Attributes
static readonly? HashSet< AbsolutePath >	EngineSearchPaths
	Frankly this is not really relevant anymore.

static ? AbsolutePath	EnginePathCache = null
	Once the Engine location is found for the current session, it ain't gonna move around, so we cache it.

static readonly JsonSerializerSettings	JsonReadSettings
	Common `JsonSerializerSettings` for Unreal conventions of JSON format.

Detailed Description

A collection of utilities around basic functions regarding the environment of the Engine we're working with.

Definition at line 23 of file Unreal.cs.

Constructor & Destructor Documentation

◆ Unreal()

static Nuke.Unreal.Unreal.Unreal ( )

staticprivate

Definition at line 36 of file Unreal.cs.

Member Function Documentation

◆ AndLater()

static UnrealCompatibility Nuke.Unreal.Unreal.AndLater ( this UnrealCompatibility compatibility )

static

Create a compatibility flag mask which indicates that a feature is available un-broken in given and the following versions of Unreal Engine.

◆ AutomationTool() [1/4]

static Tool Nuke.Unreal.Unreal.AutomationTool ( EngineVersion ofVersion )

static

Prepare invocation for UAT.

Returns: A Tool delegate for UAT

Definition at line 266 of file Unreal.cs.

◆ AutomationTool() [2/4]

static Tool Nuke.Unreal.Unreal.AutomationTool	(	EngineVersion	ofVersion,
		Action< UatConfig >	config )

static

Prepare invocation for UAT with extra fluent-API configuration.

Parameters

ofVersion
config	Auto-generated Configuration facilities mirroring UAT arguments

Returns: A Tool delegate for UAT

Definition at line 283 of file Unreal.cs.

◆ AutomationTool() [3/4]

static Tool Nuke.Unreal.Unreal.AutomationTool ( UnrealBuild build )

static

Prepare invocation for UAT.

Returns: A Tool delegate for UAT

◆ AutomationTool() [4/4]

static Tool Nuke.Unreal.Unreal.AutomationTool	(	UnrealBuild	build,
		Action< UatConfig >	config )

static

Prepare invocation for UAT with extra fluent-API configuration.

Parameters

build
config	Auto-generated Configuration facilities mirroring UAT arguments

Returns: A Tool delegate for UAT

◆ BuildTool() [1/4]

static Tool Nuke.Unreal.Unreal.BuildTool ( EngineVersion ofVersion )

static

Prepare invocation for UBT.

Returns: A Tool delegate for UBT

Definition at line 219 of file Unreal.cs.

◆ BuildTool() [2/4]

static Tool Nuke.Unreal.Unreal.BuildTool	(	EngineVersion	ofVersion,
		Action< UbtConfig >	config )

static

Prepare invocation for UBT with extra fluent-API configuration.

Parameters

ofVersion
config	Auto-generated Configuration facilities mirroring UBT arguments

Returns: A Tool delegate for UBT

Definition at line 239 of file Unreal.cs.

◆ BuildTool() [3/4]

static Tool Nuke.Unreal.Unreal.BuildTool ( UnrealBuild build )

static

Prepare invocation for UBT.

Returns: A Tool delegate for UBT

◆ BuildTool() [4/4]

static Tool Nuke.Unreal.Unreal.BuildTool	(	UnrealBuild	build,
		Action< UbtConfig >	config )

static

Prepare invocation for UBT with extra fluent-API configuration.

Parameters

build
config	Auto-generated Configuration facilities mirroring UBT arguments

Returns: A Tool delegate for UBT

◆ ClearFolder()

static void Nuke.Unreal.Unreal.ClearFolder ( AbsolutePath folder )

static

Clear intermediate folders of Unreal from a given folder.

Definition at line 311 of file Unreal.cs.

◆ GetDefaultPlatform()

static UnrealPlatformFlag Nuke.Unreal.Unreal.GetDefaultPlatform ( )

static

Get the current development platform Nuke.Unreal is ran on.

Definition at line 197 of file Unreal.cs.

◆ GetEnginePath()

static AbsolutePath Nuke.Unreal.Unreal.GetEnginePath	(	string	engineAssociation,
		bool	ignoreCache = false )

static

Get the Unreal Engine path based on an input association text. (version, GUID or absolute path)

Definition at line 116 of file Unreal.cs.

◆ GetTool()

static Tool Nuke.Unreal.Unreal.GetTool	(	UnrealBuild	build,
		string	name )

static

Get a native binary tool from Engine/Binaries folder. Unreal tools written in C# or stored in other folders/sub-folders are not supported. You can omit the Unreal part of the tool name.

Parameters

build
name	You can omit the `Unreal` part of the tool name.

Returns: A Tool delegate for selected Unreal tool

Definition at line 345 of file Unreal.cs.

◆ InvalidateEnginePathCache()

static void Nuke.Unreal.Unreal.InvalidateEnginePathCache ( )

static

In the rare and unlikely case that the Engine location may have changed during one session.

◆ Is4()

static bool Nuke.Unreal.Unreal.Is4 ( UnrealBuild build )

static

Are we working with UE4.

◆ Is5()

static bool Nuke.Unreal.Unreal.Is5 ( UnrealBuild build )

static

Are we working with UE5.

◆ IsInstalled() [1/3]

static bool Nuke.Unreal.Unreal.IsInstalled ( AbsolutePath enginePath )

static

Is given path a vanilla engine most probably installed via the Marketplace?

◆ IsInstalled() [2/3]

static bool Nuke.Unreal.Unreal.IsInstalled ( EngineVersion ofVersion )

static

Are we working with a vanilla engine most probably installed via the Marketplace?

◆ IsInstalled() [3/3]

static bool Nuke.Unreal.Unreal.IsInstalled ( UnrealBuild build )

static

Are we working with a vanilla engine most probably installed via the Marketplace?

◆ IsSource() [1/3]

static bool Nuke.Unreal.Unreal.IsSource ( AbsolutePath enginePath )

static

Is given path an engine built from source?

◆ IsSource() [2/3]

static bool Nuke.Unreal.Unreal.IsSource ( EngineVersion ofVersion )

static

Are we working with an engine built from source?

◆ IsSource() [3/3]

static bool Nuke.Unreal.Unreal.IsSource ( UnrealBuild build )

static

Are we working with an engine built from source?

◆ MacRunMono()

static AbsolutePath Nuke.Unreal.Unreal.MacRunMono ( EngineVersion ofVersion )

static

On Mac many Unreal tools need the Mono bootstrap.

◆ ReadCopyrightFromProject()

static string Nuke.Unreal.Unreal.ReadCopyrightFromProject ( AbsolutePath projectFolder )

static

Read copyright info from the project's DefaultGame.ini

Definition at line 321 of file Unreal.cs.

◆ Version()

static EngineVersion Nuke.Unreal.Unreal.Version ( UnrealBuild build )

static

Get high-level version of currently used Engine.

◆ WriteJson()

static void Nuke.Unreal.Unreal.WriteJson	(	object	input,
		AbsolutePath	path )

static

Write data in JSON with Unreal conventions of JSON format.

Definition at line 82 of file Unreal.cs.

Member Data Documentation

◆ EnginePathCache

? AbsolutePath Nuke.Unreal.Unreal.EnginePathCache = null

static

Once the Engine location is found for the current session, it ain't gonna move around, so we cache it.

Definition at line 34 of file Unreal.cs.

◆ EngineSearchPaths

readonly? HashSet<AbsolutePath> Nuke.Unreal.Unreal.EngineSearchPaths

static

Frankly this is not really relevant anymore.

Definition at line 28 of file Unreal.cs.

◆ JsonReadSettings

readonly JsonSerializerSettings Nuke.Unreal.Unreal.JsonReadSettings

static

Initial value:

= new()
        {
            MissingMemberHandling = MissingMemberHandling.Ignore,
            DefaultValueHandling = DefaultValueHandling.Populate,
            NullValueHandling = NullValueHandling.Include,
            Converters = {
                new StringEnumConverter(false)
            }
        }

Common JsonSerializerSettings for Unreal conventions of JSON format.

Definition at line 69 of file Unreal.cs.

The documentation for this class was generated from the following file:

/home/runner/work/Nuke.Unreal/Nuke.Unreal/src/Nuke.Unreal/Unreal.cs

Static Public Member Functions

Static Public Attributes

Detailed Description

Constructor & Destructor Documentation

◆ Unreal()

Member Function Documentation

◆ AndLater()

◆ AutomationTool() [1/4]

◆ AutomationTool() [2/4]

◆ AutomationTool() [3/4]

◆ AutomationTool() [4/4]

◆ BuildTool() [1/4]

◆ BuildTool() [2/4]

◆ BuildTool() [3/4]

◆ BuildTool() [4/4]

◆ ClearFolder()

◆ GetDefaultPlatform()

◆ GetEnginePath()

◆ GetTool()

◆ InvalidateEnginePathCache()

◆ Is4()

◆ Is5()

◆ IsInstalled() [1/3]

◆ IsInstalled() [2/3]

◆ IsInstalled() [3/3]

◆ IsSource() [1/3]

◆ IsSource() [2/3]

◆ IsSource() [3/3]

◆ MacRunMono()

◆ ReadCopyrightFromProject()

◆ Version()

◆ WriteJson()

Member Data Documentation

◆ EnginePathCache

◆ EngineSearchPaths

◆ JsonReadSettings