Home

Awesome

Good News Everyone: Natively integrated in UE4.22+

Details here: https://docs.unrealengine.com/en-us/Builds/4_22

UE4 LivePP: C/C++ live coding

A UE4 plugin wrapper for the amazing Molecular Matter's Live++ Hot-Reloading Library. (https://molecular-matters.com/products_livepp.html). One day we will get sub-second iteration in Unreal Engine 4.

Live++ Documentation: https://molecular-matters.com/docs/livepp/documentation.html

Status

UE4 Plugin Features:

Tested Configuration:

Usage instructions

  1. Enable VS required compilation flags:

    Live++ requires some additional compilation flags that Unreal doesn't have enabled out of the box.

    There are a few approaches that you can take to enable these depending on which engine version you are on.

    A. 4.19+ Modify VCToolChain.cs:

    • You will manually have to rebuild the entire solution if you want to hotreload engine modules.
    • At the top of VCToolChain::AppendCLArguments_CPP add Arguments.Add("/Gw");
    • At the top of VCToolChain::AppendLinkArguments add Arguments.Add("/FUNCTIONPADMIN");

    B. 4.19 Extend UBT Target rules:

    • The following engine changes shipped in 4.20, but you can backport them to 4.19, and then use the 4.20+ instructions below.
    • Add the following to the TargetRules.cs:TargetRules class: 
      [RequiresUniqueBuildEnvironment]
[XmlConfigFile(Category = "BuildConfiguration")]
public string AdditionalCompilerArguments;
[RequiresUniqueBuildEnvironment]
[XmlConfigFile(Category = "BuildConfiguration")]
public string AdditionalLinkerArguments;
    • Add the following to the ReadOnlyTargetRules class: 
      public string AdditionalCompilerArguments
{
	get { return Inner.AdditionalCompilerArguments; }
}

public string AdditionalLinkerArguments
{
	get { return Inner.AdditionalLinkerArguments; }
}
    • Add the following to UEBuildTarget.SetupGlobalEnvironment(): 
      GlobalCompileEnvironment.AdditionalArguments = Rules.AdditionalCompilerArguments;
GlobalLinkEnvironment.AdditionalArguments = Rules.AdditionalLinkerArguments;
    • Follow the instructions below.

    C. 4.20+ Modify Game.Target.cs:

    • Add the following to your Game.Target.cs file: 
      AdditionalCompilerArguments = "/Gw";
AdditionalLinkerArguments   = "/FUNCTIONPADMIN";

    NOTE: UBT support for UniqueBuildEnvironment doesn't work well if your game is not in a subdirectory of the UnrealEngine (e.g. UE_4.XX/Games where UE_4.XX is your UnrealEngine root director that has UE_4.XX/Engine, UE_4.XX/FeaturePacks, etc"). Your best bet is to follow Option A even for 4.20+ and modify the buildconfiguration.xml file instead of Game.Target.cs:

    <BuildConfiguration>
<AdditionalCompilerArguments>/Gw</AdditionalCompilerArguments>
<AdditionalLinkerArguments>/FUNCTIONPADMIN</AdditionalLinkerArguments>
</BuildConfiguration>

  2. Clone this repo into your game or engine plugins directory (eg \GameModule\Plugins\LivePP)

  3. Extract LPP.zip into this folder: \Plugins\LivePP\Source\ThirdParty\LPPExternalLib

    The result should look like the following:

    \Plugins\LivePP\Source\ThirdParty\LPPExternalLib\LivePP
\Plugins\LivePP\Source\ThirdParty\LPPExternalLib\LivePP\API\*
\Plugins\LivePP\Source\ThirdParty\LPPExternalLib\LivePP\x64\*
\Plugins\LivePP\Source\ThirdParty\LPPExternalLib\LivePP\x86\*

    etc

  4. Enable the LivePP plugin:

    • In your Game.Build.cs file add: PrivateDependencyModuleNames.Add("LivePP");
    • Build and launch the editor and navigate to the Project Settings, scroll down to Plugins -> LivePP and check the Enable box. By default, it is set to false so if you checkin the plugin, it won't attempt to load itself on every team members computer. Enable setting is persisted to your local machine only (EditorPerProjectUserSettings)

  5. Optional suggestions:

    These are other settings that you can play with which may improve Live++ reloading times.

    A. Force off UnityBuilds (slower full recompilation but faster L++ hotreloading)

    • bUseUnityBuild = false && bForceUnityBuild = false

    B. Ensure adaptive unity builds are working (UBT uses git status or if it detects perforce, the file's readonly attribute to determine if a source file has been touched. If so, it will pull that file out of the unity build. So you just have to ensure to touch the file before you launch UE4 with L++

    • Settings to use: bUseAdaptiveUnityBuild, bAdaptiveUnityDisablesPCH, MinGameModuleSourceFilesForUnityBuild

    C. Force all game modules to not use unity builds.

    • bFasterWithoutUnity = true

    The best workflow I've found is use adaptive unity builds for the engine while forcing all game modules to not use unity builds.

Troubleshooting:

Incredibuild