Game > Gamebase > User Guide for Unreal SDK > Getting Started

This document describes the environment and initial setting to enable Unreal Gamebase SDK.



Support Versions for Unreal

  • UE 4.26 ~ UE 5.0
  • To get support for a lower version of Unreal, please contact Customer Center.

Supported Platforms

  • iOS
  • Android
  • Windows

When unsupported Gamebase API is called on a selected platform, errors like below are returned as callback; if a callback is not available, warning logs show as output.

  • GamebaseErrorCode::NOT_SUPPORTED
  • GamebaseErrorCode::NOT_SUPPORTED_IOS
  • GamebaseErrorCode::NOT_SUPPORTED_ANDROID
  • GamebaseErrorCode::NOT_SUPPORTED_UE4_EDITOR

Platforms supported by each API can be categorized by the following icon:





  1. Download Unreal Gamebase SDK and create a folder named Plugins in the project path and add NHN Cloud Folder in the downloaded SDK.
  2. From the Unreal editor, display the Settings > Plugins window, and find and enable Project > NHN Cloud > Gamebase Plugin.

  3. Download Gamebase Unreal SDK

Module Settings

  • To use the Gamebase code, you need to add 2 modules as shown below when setting up dependencies in the module's Build.cs file.

Android Settings

  1. Select Edit > Project Settings from the editor menu.
  2. In the Project Settings window, under Plugin category, select Gamebase - Android.

Unreal Project Settings - Android

  • Authentication
    • Activate the IdP to use.
    • To use Hangame IdP, please contact our Customer Center.
  • Purchase
    • Select the store to use.
    • ONE Store
      • Select View Option - Full payment screen (Full) or Payment popup window (Popup).
  • Push
    • Enable the push service to use.

An issue where Google Play authentication and payment does not complete

Processing the authentication and payment for the Google Play service requires Distribution settings. To find out more, see the following document.

Enable AndroidX

  • From Gamebase Android SDK 2.25.0, AndroidX has been introduced. Therefore, you must add the following setting to the UPL (Unreal Plugin Language) file.

Enable multidex

  • From Gamebase Unreal SDK 2.26.0, the multidex-related setting within Gamebase has been removed. Therefore, you must add the following setting to the UPL (Unreal Plugin Language) file.
  android {
    defaultConfig {
      multiDexEnabled true

    <addAttribute tag="application" name="android:name" value="androidx.multidex.MultiDexApplication"/>

iOS Settings

To use the Gamebase SDK for Unreal, UE4 Github source code has to be used, and the Github account must be linked after joining the Epic games in order to expose the UnrealEngine repository. See below for relevant guides.

!Important If you ignore this process, the following guide link does not properly work and the Gamebase SDK for Unreal will become unavailable.

Project Settings

  1. Select the editor menu Edit > Project Settings.
  2. In the Project Settings window, select Gamebase - iOS from the Plugin category.

Unreal Project Settings - iOS

  • Path
    • Xcode Path: Enter the path of Xcode. (default: /Applications/
  • Authentication
    • Enable the IdP to use.
  • Purchase
    • Select the store to use.
  • Push
    • Enable the push service to use.

Sign in with Apple

To enable Sign in with Apple, must be added to entitlement.

If login to Gamebase AppleId is attempted without a key value added, error shall occur like below:

Authorization failed: Error Domain=AKAuthenticationError Code=-7026 "(null)"

Since UE4(4.24.3) does not support the feature, below codes must be added above line 196 of the following file. Engine/Source/Programs/UnrealBuildTool/Platform/IOS/IOSExports.cs.

// AS-IS
if (bRemoteNotificationsSupported)
    Text.AppendLine(string.Format("\t<string>{0}</string>", bForDistribution ? "production" : "development"));

// TO-BE
if (bRemoteNotificationsSupported)
    Text.AppendLine(string.Format("\t<string>{0}</string>", bForDistribution ? "production" : "development"));

Facebook SDK

To use Facebook IdP, you need to add the following code in the Engine/Source/Programs/UnrealBuildTool/Platform/IOS/IOSToolChain.cs file.

// need to tell where to load Framework dylibs
Result += " -rpath /usr/lib/swift";                 // Added code
Result += " -rpath @executable_path/Frameworks";

Remote Notification

  1. To enable Gamebase Remote Notification, go to Project Settings > Platforms > iOS and activate Enable Remote Notifications Support. (available only on Github sources)
  2. To receive the Foreground push notification, the code shown below must be removed from the Engine/Source/Runtime/ApplicationCore/Private/IOS/IOSAppDelegate.cpp file, or

    - (void)userNotificationCenter:(UNUserNotificationCenter *)center
        willPresentNotification:(UNNotification *)notification
            withCompletionHandler:(void (^)(UNNotificationPresentationOptions options))completionHandler
        // Received notification while app is in the foreground

    modify it as follows:

        // AS-IS
        // TO-BE

Rich Push Notification

Cannot use the Rich Push Notification function due to the following issues:

Error in Unreal Builds due to Warning Messages of iOS SDK

If a warning message from iOS SDK is converted as error for Unreal build, leading into failure in the buildup, handle the clang compile option code of the following file as footnotes: Engine/Source/Programs/UnrealBuildTool/Platform/IOS/IOSToolChain.cs

// Result += " -Wall -Werror";


There is an issue where the device using the architecture cannot get the memory address because the PLCrashReporter used by UE4 does not support the arm64e architecture.

Game developers using the crash analysis of the NHN Cloud Log & Crash Search must refer to the following guide to modify the UE4 internal PLCrashReporter:

  1. Unzip the GamebaseSDK-Unreal/Source/Gamebase/ThirdParty/IOS/GamebaseSDK-iOS/externals/ file.
  2. Replace the file and header file of the UE4 internal PLCrashReporter with the unzipped file.
    • Engine/Source/ThirdParty/PLCrashReporter/plcrashreporter-master-xxxxxxx

Windows Settings

    1. Select Edit > Project Settings from the editor menu.
  1. In the Project Settings window, in the Plugin category, select Gamebase - Windows.

Unreal Project Settings - Windows

  • Authentication
    • Activate the IdP to use.
  • Purchase
    • Select the store to use.
    • Epic Store
      • Enter the EOS service information as appropriate for each field.

Epic Store Services

  • Supported by UE 4.27 and later, the EOSSDK module is used inside the engine.
  • To use the Epic Store, you must be logged in using the EOSSDK.
  • The EOS version used by Gamebase is, which requires an upgrade by installing it in the engine path Engine\Source\ThirdParty\EOSSDK\SDK.
  • EOS Handle settings are required when starting the game.
    • If you're using the Online Subsystem EOS included in the engine, you can set it up like the code below.

      #include "OnlineSubsystemEOS.h" 
      #include "IEOSSDKManager.h"
      #include "GamebaseStandalonePurchaseEpicAdapterModule.h"
      void UGamebasePurchaseEpicSupportTestCase::SetEosPlatformInstance()
          IOnlineSubsystem* Subsystem = Online::GetSubsystem(GetWorld());
          if (const FOnlineSubsystemEOS* EosSubsystem = static_cast<FOnlineSubsystemEOS*>(Subsystem))
              EOS_HPlatform PlatformHandle = *EosSubsystem->EOSPlatformHandle;

      Including the OnlineSubsystemEOS.h header causes a build error, so you must move the header file from the OnlineSubsystemEOS plugin's private folder to the public folder. (Reference: EOS Error-related Inquiry) - SocketSubsystemEOS.h - EOSSettings.h - EOSHelpers.h - [Platform]/[Platform]EOSHelpers.h

API Deprecate Governance

APIs that are no longer supported by Gamebase are to be deprecated. Once deprecated, APIs might be deleted without previous notice if they fulfill the following conditions:

  • Updated more than 5 times for a minor version

    • Gamebase Version Format - XX.YY.ZZ
      • XX : Major
      • YY : Minor
      • ZZ : Hotfix
  • At least 5-month old