Game > Gamebase > Release Notes > Unreal

2.71.1 (2025. 4. 29.)

SDK Download

기능 개선/변경

  • (Windows) 결제 API 오류 발생 시 디버깅을 돕기 위해 상세 오류 메시지를 보강했습니다.
  • 내부 로직을 개선했습니다.

버그 수정

  • (Windows) FGamebaseConfiguration 내 DisplayLanguageCode 적용 시 점검 언어 값을 잘못 가져오는 문제가 수정되었습니다.
  • (Windows) 인증 과정 중 일부 실패 케이스에서 재인증이 불가능했던 문제가 수정되었습니다.

플랫폼별 변경 사항

2.71.0 (2025. 4. 15.)

SDK Download

기능 추가

기능 개선/변경

  • (Windows) 시스템 설정에서 '지역 > 국가 또는 지역'를 바탕으로 CountryCode를 생성하도록 수정했습니다.
    • 변경 전에는 엔진에서 제공하는 FInternationalization::Get().GetDefaultCulture()를 통해 '지역 > 사용지역 언어' 정보를 가져왔습니다.

버그 수정

  • (Windows) WebView를 열고 프로그램 종료 시 크래시가 발생하지 않도록 수정했습니다.
  • (Windows) 엔진에 포함된 Steamworks 모듈을 에디터에서 사용할 수 없으므로 Steam 인증 및 결제 기능을 에디터에서 사용할 수 없도록 수정했습니다.
  • (Windows) 로그 전송 필터링이 정상적으로 동작하지 않는 문제가 수정되었습니다.
  • 내부 로직을 개선했습니다.

플랫폼별 변경 사항

2.70.0 (2025. 3. 11.)

SDK Download

기능 추가

  • 로그인 시 IdP 서버로부터 에러가 발생했음을 나타내는 신규 에러 코드가 추가되었습니다.
    • AUTH_AUTHENTICATION_SERVER_ERROR(3012)
  • WebView에 네비게이션 바 title 컬러와 icon tint 컬러 설정 옵션을 추가했습니다.
    • FGamebaseWebViewConfiguration::NavigationBarTitleColor
    • FGamebaseWebViewConfiguration::NavigationBarIconTintColor
  • (Android) 'GPGS 자동 로그인' 기능 연동시 유저에게 GPGS 로그인을 앱 설치 후 한번만 물어보는 초기화 옵션을 추가했습니다.
    • FGamebaseConfiguration::bEnableGPGSSignInCheck
    • 기본 설정은 true로, 유저가 GPGS 로그인을 거부하더라도 Gamebase 초기화 때 GPGS 로그인 창을 다시 표시합니다.
    • false로 설정하면 앱 최초 실행시에만 GPGS 로그인 창이 한번 표시됩니다.

기능 개선/변경

  • 내부 로직을 개선하였습니다.

버그 수정

  • (Windows) 로그인 시 FGamebaseVariantMap로 추가 정보를 받는 경우 크래시가 발생하지 않도록 수정했습니다.

플랫폼별 변경 사항

2.69.1 (2025. 3. 4.)

SDK Download

기능 추가

  • 런칭 정보에서 약관 정보를 확인할 수 있도록 추가했습니다.
    • FGamebaseLaunchingInfo::FApp::FTermsService

기능 개선/변경

  • API 호출 시 매개변수로 전달받는 UGamebaseJsonObject를 FGamebaseVariantMap(TMap<FName, FVariant>)으로 변경했습니다.
  • 내부 로직을 개선하였습니다.

버그 수정

  • (Windows) 게스트 로그인 시 UUID 발급 과정 오류로 인해 모두 동일한 값이 생성되는 문제를 수정했습니다.
  • (Windows) Line IDP 로그인 시 region 설정이 동작하지 않는 문제를 수정했습니다.
  • (Windows) 킥아웃 시 ServerPushAppKickOut 이벤트 발생과 팝업이 노출되지 않는 문제를 수정했습니다.
  • (Windows) 심볼 생성 시 엔진의 Build Configuration이 Development가 아닌 경우 오류가 발생하는 문제를 수정했습니다.
  • (Android) 환경에 따라 RegisterPush가 동작하지 않는 문제를 수정했습니다.

플랫폼별 변경 사항

2.69.0 (2025. 2. 11.)

SDK Download

기능 추가

  • RequestLastLoggedInProvider 비동기 API를 추가했습니다.
    • GetLastLoggedInProvider() 동기 API가 타이밍상 정상적인 값을 반환하지 못할 때가 있습니다.
    • (Android) GPGS의 Auto Login 기능을 사용 시 GPGS 서버에서 데이터를 획득하는 시간이 필요하므로 Gamebase 초기화 직후 GetLastLoggedInProvider() 동기 API를 호출하면 정상적인 값을 획득할 수 없습니다. 이때 RequestLastLoggedInProvider 비동기(GamebaseDataCallback<String>) 비동기 API는 정확한 값을 보장합니다. Auto Login을 사용하지 않는다면 GetLastLoggedInProvider() 동기 API를 사용해도 무방합니다.
  • (Android) GPGS v2 인증 추가되었습니다.
  • (Android) FGamebaseWebViewConfiguration::CutoutColor 필드를 추가했습니다.
    • GamebaseWebView의 FGamebaseWebViewConfiguration::bRenderOutSideSafeArea 필드를 false로 설정한 경우, cutout 영역에 자동으로 padding 여백을 추가합니다.
    • CutoutColor 필드는 이렇게 추가된 padding 영역의 색을 설정할 수 있습니다.
    • RenderOutsideSafeArea 필드를 false로 설정했지만 CutoutColor 필드는 설정하지 않는 경우에는 웹 페이지 'body'의 'background-color' 값으로 자동으로 padding 영역의 색상을 결정합니다.

기능 개선/변경

  • 내부 로직을 개선하였습니다.

버그 수정

  • 약관 조회 결과 API인 FGamebaseQueryTermsResult가 수정되었습니다.
    • TermsCountryType의 값이 설정되지 않는 문제를 수정했습니다.
    • bPushEnabled, bAdAgreement, bAdAgreementNight가 제거되었습니다.
  • (Android) Windows 환경에서 빌드 시 포스트 빌드 프로세스에서 오류가 발생하지 않도록 수정했습니다.

플랫폼별 변경 사항

2.68.1 (2025. 01. 21.)

SDK Download

기능 개선/변경

버그 수정

  • (Windows) 내부 로그 전송 시 크래시가 발생할 수 있는 로직이 수정되었습니다.

플랫폼별 변경 사항

2.68.0 (2024. 12. 10.)

SDK Download

Feature Updates

  • Improved internal logic.
  • (Windows) Twitter changed its authentication method to OAuth 2.0, so login will not work without changing the settings below.
    • Issue OAuth 2.0 Client ID and Client Secret
      • Create an OAuth 2.0 Client ID and Client Secret in the Twitter Developer Portal, then register them in the Gamebase console.
    • Set Callback URL
      • Set the Callback URL (https://id-gamebase.toast.com/oauth/callback) in the Gamebase console.
      • Add the same Callback URL to the Twitter Developer Portal.
    • For more information, see the link below.

Bug Fixes

  • (Windows) Fixed so that crash would not occur when making payment.
  • (Windows) Fixed an issue where, when exiting the payment with an ESC key on Steam payment, the following payment APIs would not work.

Platform-Specific Changes

2.67.2 (2024. 11. 26.)

SDK Download

Feature Updates

  • Improved internal logic.

Bug Fixes

  • (Windows) Fixed an issue that prevented Apple ID sign-in from proceeding properly.

Platform-Specific Changes

2.67.1 (2024. 11. 14.)

SDK Download

기능 개선/변경

  • (Windows) Purchase 설정 시 스토어를 하나만 선택할 수 있도록 변경되었습니다.
    • 스토어 재설정이 필요합니다.
  • (Windows) Epic Games Store 사용 시 EOS SDK의 핸들을 등록하는 과정이 변경되었습니다.
    • Online Subsystem EOS를 사용하는 경우 Gamebase 초기화 시 StoreCode가 Epic Games Store의 해당하는 값이면 자동으로 핸들을 등록합니다.
    • Online Subsystem EOS를 사용하지 않는 경우 Windows Settings 가이드를 참고하여 EOS의 핸들을 등록하는 과정이 필요합니다.
  • (Windows) Steamworks SDK 지원 버전이 1.59로 변경되었습니다.

버그 수정

  • 헤더 파일을 정상적으로 참조할 수 있도록 수정했습니다.
  • (Windows) 초기화를 여러번 시도 시 크래시가 발생하지 않도록 수정되었습니다.
  • (Windows) 초기화 시 StoreCode가 Steam 혹은 Epic Games Store에 해당하는 코드를 입력 시 크래시가 발생하지 않도록 수정되었습니다.
  • (Windows) 외부 브라우저를 이용한 로그인 시도 시 크래시가 발생할 수 있는 로직이 수정되었습니다.

플랫폼별 변경 사항

2.67.0 (2024. 10. 30.)

SDK Download

Added Features

  • Added the Steam authentication.
  • Added Steam payments.
  • Added a new type to the image notice feature.
    • Added the rolling popup type.
    • Existing image notices appear as pop-ups and are not supported on Windows.
  • (Windows) Added the LINE authentication.

Feature Updates

  • Changed the supported version of the engine from 4.27 to 5.4.
  • Improved internal logic.

Bug Fixes

  • Fixed logic that could cause a crash when a crash log is generated.

Platform-Specific Changes

2.66.1 (2024. 09. 10.)

SDK Download

Feature Updates

  • Improved internal logic.

Platform-Specific Changes

2.66.0 (2024. 08. 27.)

SDK Download

Feature Updates

  • Made changes to how to use APIs.
    • Changed the API from being provided by IGamebase, which inherits from IModuleInterface, to being provided by UGamebaseSubsystem, which inherits from UGameInstanceSubsystem.
    • As a subsystem of GameInstance, UGamebaseSubsystem follows the GameInstance lifecycle and you must find the subsystem through the GameInstance you use when calling the SDK APIs for use.
  • Removed the GamebaseInterface module. When using the Gamebase plugin, delete the GamebaseInterface module before using it.
  • (Windows) GameInstance is available in different individual environments.

Platform-Specific Changes

2.64.0 (2024. 06. 11.)

SDK Download

Feature Updates

  • Improved internal logic.

Bug Fixes

  • Fixed code that caused warnings depending on C++ environment, resulting in errors on build
  • (Android) Fixed an error that occurred on API calls due to missing ProGuard declaration.

Platform-Specific Changes

2.63.0 (2024. 04. 23.)

SDK Download

기능 추가

  • (Android) Firebase Notification 설정 방식이 변경되어 플러그인 내부에 google-services-json.xml 파일 수정이 아닌 Android 설정 툴에서 google-services.json 파일 경로를 지정하도록 변경되었습니다.
  • (iOS) Gamebase Unreal SDK에 Privacy manifest와 서명을 적용했습니다.

기능 개선

  • (iOS) 빌드 시 오류가 발생하지 않도록 수정되었습니다.

플랫폼별 변경 사항

2.62.0 (2024. 03. 26.)

SDK Download

Added Feature

  • (iOS) Applied privacy manifest and signature to Gamebase SDK.

Feature Updates

  • Improved internal logic.

Platform-specific Changes

2.60.0 (2024. 02. 15.)

SDK Download

Feature Updates

  • Updated internal logic.

Platform-specific Changes

2.58.0 (2023. 11. 28.)

SDK Download

Bug Fixes

  • (Windows) Fixed an issue where server push would not work.
  • Fixed logic that could cause a crash on initialization.

Platform-specific Changes

2.57.0 (2023. 11. 14.)

SDK Download

Added Features

  • Added support for Windows platform
    • Added Windows Settings Tool.
    • To check APIs supported by platforms, see UNREAL-WINDOWS in each documentation.

Platform-specific Changes

2.56.0 (2023. 10. 17.)

SDK Download

Added Features

  • Added Store settings in the Android settings tool.
    • Added Amazon Appstore, Huawei AppGallery, and MyCard to the list.
    • Added the option to select the version of the store when selecting ONE Store.
  • Added the Naver IdP setting in the iOS settings tool.
  • (Android) Added a new API to specify an option to hide the loading animation during the LoginForLastLoggedInProvider call.
  • (Android) Added the FGamebasePushConfiguration.requestNotificationPermission field to prevent the Push permission request popup from automatically appearing when calling the RegisterPush API on Android 13 and later.
  • (iOS) Added the FGamebasePushConfiguration.alwaysAllowTokenRegistration field to allow users to register tokens even if they deny push permissions.

Feature Updates

  • Modified the provided type from USTRUCT to a generic structure.
    • If the type received as a result is a value that is not provided by default, it is provided in TOptional form.

Bug Fixes

  • Modified to ensure that the withdrawal delay information and payment abusing auto cancellation information are delivered normally after logging in.

Platform-specific Changes

2.49.1 (2023. 04. 14.)

SDK Download

Bug Fixes

  • (iOS) Fixed a crash when calling the API to query purchases.

Platform-specific Changes

2.49.0 (2023. 04. 11.)

SDK Download

Added Features

  • Please update to a new API due to changes to the Query Unconsumed Purchases API.

    // Deprecated API
void RequestItemListOfNotConsumed(const FGamebasePurchasableReceiptListDelegate& onCallback);
// New API
void RequestItemListOfNotConsumed(const FGamebasePurchasableConfiguration& Configuration, const FGamebasePurchasableReceiptListDelegate& onCallback);

  • Make sure to update to a new API due to changes to the Query Activated Subscription API.

    • To get the same results as the existing API, set FGamebasePurchasableConfiguration.allStores to true.
      // Deprecated API
void RequestActivatedPurchases(const FGamebasePurchasableReceiptListDelegate& onCallback);
// New API
void RequestActivatedPurchases(const FGamebasePurchasableConfiguration& Configuration, const FGamebasePurchasableReceiptListDelegate& onCallback);

  • (Android) Added the RequestSubscriptionsStatus API to view the IAP subscription status.

  • (Android) Re-supported the field to set whether to use fixed font sizes from the WebView.
    • GamebaseWebViewConfiguration.enableFixedFontSize
  • (Android) Added a setting to allow WebView to render using all available screen spaces, including cutout (notched) areas.
    • GamebaseWebViewConfiguration.renderOutsideSafeArea

Feature Updates

  • Raised the minimum supported version of Unreal to 4.26.
  • (iOS) Fixed an error that occurred when running a build from Xcode 14.1.

Platform-specific Changes

2.43.3 (2022. 10. 04.)

SDK Download

Feature Updates

Platform-specific Changes

2.42.1 (2022. 08. 09.)

SDK Download

Added Features

  • Added the mappedUserValid field that represents the mapped user status to the FGamebaseForcingMappingTicket class.
  • Added the Xcode Path setting to specify the path for Xcode in iOS Setting Tool.

Feature Updates

  • The following field has been deprecated because whether to display the kickout popup window can be set during kickout registration in the Gamebase console.
    • FGamebaseConfiguration.bEnableKickoutPopup
  • Default values have been added to some fields in FGamebaseConfiguration.
    • The default value of bEnableLaunchingStatusPopup is set to true.
    • The default value of bEnableBanPopup is set to true.
  • The field to set whether to use the fixed font size in FWebView is no longer used.
    • FGamebaseWebViewConfiguration.enableFixedFontSize
  • Default values have been added to some fields in FGamebaseWebViewConfiguration.
    • The default values of navigation bar colorR, colorG, colorB, and colorA are set to 18, 93, 230, 255.
    • The default value of the isNavigationBarVisible field to enable the navigation bar is set to true.
    • The default value of the isBackButtonVisible field to enable the Go Back button in WebView is set to true.

Platform-specific Changes

2.41.0 (2022. 07. 05.)

SDK Download

Added Features

Platform-specific Changes

2.40.1 (2022. 06. 14.)

SDK Download

Bug Fixes

  • Fixed the logic that could cause a crash.
  • (iOS) Fixed an issue where the callback was not passed normally when calling the same API consecutively.

2.40.0 (2022. 05. 24.)

SDK Download

Added Features

  • Provides iOS settings tool.
    • In the previous project settings, it was displayed as Gamebase, but after the update, it is displayed as Gamebase - Android, Gamebase - iOS.
    • Made modifications so that only the necessary frameworks when running a build are included, with the iOS settings tool.
  • Added the VO class to determine whether the Terms UI is displayed after calling the Common Terms API.
    • FGamebaseShowTermsViewResult
  • Added an API to determine whether the device has allowed notifications or not.
    • UGamebaseSubsystem* Subsystem = UGameInstance::GetSubsystem(GetGameInstance()); Subsystem->GetPush().QueryNotificationAllowed()
  • Added an API to determine whether terms and conditions have been displayed.
    • UGamebaseSubsystem* Subsystem = UGameInstance::GetSubsystem(GetGameInstance()); Subsystem->GetTerms().IsShowingTermsView()
  • Added an option to hide the navigation bar in WebView.
    • FGamebaseWebViewConfiguration.isNavigationBarVisible
  • (Android) Added an option to fix the font size in WebView
    • FGamebaseTermsConfiguration.enableFixedFontSize
  • (Android) Added an option to fix the font size in terms and conditions window.
    • FGamebaseTermsConfiguration.enableFixedFontSize
  • Added the isPromotion field to determine whether it is a promotion or not when making payment.
    • FGamebasePurchasableReceipt.isPromotion
  • Added the isTestPurchase field to determine whether it is a test purchase or not when making payment.
    • FGamebasePurchasableReceipt.isTestPurchase
  • Added the following field to add parameters after the Customer Center URL.
    • FGamebaseContactConfiguration.additionalParameters

Feature Updates

  • Made modifications so that, when calling an API result callback, the callback is called after switching to GameThread.
  • Fixed an issue where, when calling the RequestActivatedPurchases API, the API is called twice internally.
  • Changed the name of the following APIs.
    • FGamebaseAnalyticsLevelUpData → FGamebaseAnalyticsLevelUpData
    • FGambaseBanInfoPtr → FGamebaseBanInfoPtr
  • Deprecated the following fields, because it is possible to set whether to display the kickout popup window during kickout registration in the Gamebase console.
    • FGamebaseConfiguration.enableKickoutPopup

Platform-specific Changes

2.33.1 (2022. 02. 22.)

SDK Download

Bug Fixes

  • Fixed an error that occurred when running the iOS build.

2.33.0 (2022.01.25)

SDK Download

Added Features

Feature Updates

  • Added and changed error codes
    • Changed the error code mapped to the GamebaseErrorCode::UNKNOWN_ERROR error from 999 to 9999.
    • Newly added the GamebaseErrorCode::SOCKET_UNKNOWN_ERROR error mapped to the error code 999.

Platform-specific Changes

2.26.1 (2021.11.23)

SDK Download

Bug Fixes

  • Fixed a typo of Finnish language on GamebaseDisplayLanguageCode
    • Finish → Finnish

2.26.0 (2021.09.28)

SDK Download

Added Features

  • Added a common Terms and Conditions feature
    • Added an API that opens the Terms and Conditions webview
    • Added an API that views the Terms and Conditions list and agreement status per user
    • Added an API that stores the user agreement data on the Gamebase server

Feature Updates

  • Changed to display the Customer Center without login if the Customer Center type is TOAST organization product (Online Contact).
  • Changed the internal launching URL
  • Removed Android multidex-related setting from Gamebase

2.19.2 (2021.06.29)

SDK Download

Bug Fixes

  • Fixed a crash that occurs when the Close button is clicked while onEventCallback is not registered when calling the Image Notification ShowImageNotices API
  • Android setting tools - Fixed a problem where Enable Hangame and Enable Weibo did not work properly

2.19.1 (2021.02.09)

SDK Download

Bug Fixes

  • Fixed a compile error caused by files excluded during Unity Build

2.19.0 (2021.01.26)

SDK Download

More Features

  • (Unreal) SDK distribution: accumulated features from 2.16.0 to 2.19.0 reflected
    • Android Settings Tool provided: please use this settings tool rather than modifying the Gamebase_Android_UPL.xml file.
    • Customer Center feature added
    • Authentication for Hangame, Weibo added
    • Galaxy Store added
    • Localized product information added in the Paid Item information field: localizedTitle, localizedDescription
    • Android settings tool provided
    • Unreal 4.26 supported

### 2.15.0 (October 27, 2020)

SDK Download

More Features

  • Added the Unreal SDK feature: SDK 2.15.0
    • Added GamebaseEventHandler that integrates all existing event systems
      • It includes the ServerPush and Observer features and checks promotion transaction event and push event.
    • Added API
      • Added an API that can be used to send a transaction request with product ID, enter additional information (UserPayload), and check them after the transaction is complete
      • Display image notification: showImageNotices
      • Check the Push token information: queryTokenInfo
    • Added a feature that allows foreground apps to receive push notifications using the NotificationOption setting if push token is registered.
    • Added the WebViewConfiguration contentMode setting

Feature Updates

  • [SDK] 2.15.0
    • (Unreal) TOAST SDK update: Android(0.23.0), iOS(0.26.0), Unity(0.21.0)

Bug Fixes

  • [SDK] 2.15.0
    • (Unreal) Fixed an issue where the ProGuard declaration was missing in the transaction module

### 2.9.1 (August 25, 2020)

SDK Download

More Features

  • [SDK] 2.9.1
    • (Unreal) Supports Unreal 4.22 ~ 4.25
    • (Unreal) Supports PLCrashReporter Issue: Guide

Feature Updates

  • [SDK] 2.9.1
    • (Unreal) Updated Gamebase SDK version for iOS within iOS Plugin (2.9.1)
    • (Unreal) Fixed the missing part of UObject referencing

2.9.0 (May 12, 2020)

SDK Download

More Features

  • [SDK] 2.9.0
    • (Unreal) Newly released SDK
Table of Contents
TOP