Coming from other C++-based game dev, you might be used to having singletons that are globally-accessible. With Unreal it requires a bit more work.

How to set up a vanilla C++ singleton


Seriously in Unreal you will cause more problems than you solve.

  • Easy to leave instances hanging around between using Run Game in the Editor
  • Easy to create instances from the Class Default Object being loaded, or viewing a Blueprint subclass in-editor
  • Nightmare for automated testing.

No but seriously, how do I do it?

Have you considered some of the many alternatives?

Add your code to some of the easily-accessible classes like AGameState, APlayerState, and use UGameplayStatics helper functions to get access to them.

You could use subsystems, a more Unreal but decoupled way of making something globally-accessible.

What about making a plugin of your code, and accessing the code through that?

Hey kid, over hereā€¦.

OK so you really want to know? Here's the gross hacky way to do it.

UBUIMyEvilSingleton* UBUIMyEvilSingleton::Instance = nullptr;

UBUIMyEvilSingleton::UBUIMyEvilSingleton( const FObjectInitializer& ObjectInitializer )
	: Super( ObjectInitializer )
	// Don't set up Singleton instance in CDO constructor
	// or other Unreal-style constructors
	if ( !HasAnyFlags( RF_ClassDefaultObject
		| RF_NeedLoad
		| RF_NeedPostLoad
		| RF_NeedPostLoadSubobjects ) )
		ensureMsgf( pInstance == nullptr, TEXT( "Uh-oh two singletons!" ) );
		pInstance = this;

	if ( pSingleton != nullptr )
		if ( ensureMsgf( pSingleton == this, TEXT( "We have a singleton that isn't this!" ) )
			pInstance = nullptr;