Repository files navigation

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

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

UE4 Plugin Features:

• Slight validation for ensuring necessary Live++ flags are set (!Target.bAllowLTCG, !Target.bDisableDebugInfo, !Target.bOmitPCDebugInfoInDevelopment)
• Support for PrePatchHook/PostPatchHook through engine delegates.
• Support for syncing hotreload at engine's BeginFrame, EndFrame, or None (No syncing).
• Plugin loads in PostEngineInit(), loads Live++ as an external module, iterates over all loaded modules and registers the game modules.
• Plugin is disabled from running in commandlet mode.

Tested Configuration:

• Live++ 1.2.5 - 1.3.3
• UE 4.19 - 4.21.2
• Win64
• In UE4 Editor
• Plugin as a game project plugin

Usage instructions

1. Enable VS required compilation flags:

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

   • The cl.exe flag:/Gw (Optimize Global Data)
   • The Linker flag:/FUNCTIONPADMIN (Create Hotpatchable Image)

   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 ofVCToolChain::AppendCLArguments_CPP addArguments.Add("/Gw");
   • At the top ofVCToolChain::AppendLinkArguments addArguments.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 theTargetRules.cs:TargetRules class:

      [RequiresUniqueBuildEnvironment] [XmlConfigFile(Category = "BuildConfiguration")] public string AdditionalCompilerArguments; [RequiresUniqueBuildEnvironment] [XmlConfigFile(Category = "BuildConfiguration")] public string AdditionalLinkerArguments;

   • Add the following to theReadOnlyTargetRules class:

      public string AdditionalCompilerArguments { get { return Inner.AdditionalCompilerArguments; } }  public string AdditionalLinkerArguments { get { return Inner.AdditionalLinkerArguments; } }

   • Add the following toUEBuildTarget.SetupGlobalEnvironment():

      GlobalCompileEnvironment.AdditionalArguments = Rules.AdditionalCompilerArguments; GlobalLinkEnvironment.AdditionalArguments = Rules.AdditionalLinkerArguments;

   • Follow the instructions below.

   C. 4.20+ ModifyGame.Target.cs:

   • Add the following to yourGame.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 thebuildconfiguration.xml file instead ofGame.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 yourGame.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 theEnable 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 attributeto determine if a source file has been touched. If so, it will pull that file out of the unity build. So you just have toensure 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.

Incredibuild

• Can't find compiler/must override cl/link.exe pathsIncredibuild caches the compiler toolchain in a directory and then deletes it after a build so L++ won't be able to find it.You can manually override the toolchain paths: C:\Program Files (x86)\Microsoft Visual Studio\2017\Professional\VC\Tools\MSVC\14.13.26128\bin\Hostx64\x64\cl.exe && C:\Program Files (x86)\Microsoft Visual Studio\2017\Professional\VC\Tools\MSVC\14.13.26128\bin\Hostx64\x64\link.exe

  Watch out for UE4 using 2015 toolchain (default) even if you are generating VS2017 projects.Turned out that even though he had a VS 2017 project and toold VS/UE to use the VS 2017 toolchain, somehow UBT insisted on using VS 2015. The overridden paths would point to his VS 2017 cl.exe, so the compiler would complain about the PCH being from a previous version of the compiler