Country/Language

Understanding

Global Language Policy

The language shown to STOVE platform and game users is provided by default per STOVE's global language operation policy. It's applied based on the high-level policy below, and details can be adjusted to fit your operations, so please discuss with the publishing technical contact.

Global language high-level policy

STOVE service language-display criteria

What is the Country/Language Service?

The STOVE SDK provides the ability to look up, after initialization, the currently connected user's country info (GDS) and the game-constant info registered in Partners.
You can also change the STOVE platform's display language to match the game language, keeping the language the player experiences consistent.
All features work only after the SDK initialize completes.

Feature Composition

Supported Platform Display Languages

A total of 10 languages are supported.

Development

Getting Country/Game Info

This section covers how to get two kinds of info.

• Get GDS: gets the currently connected user's country info (Global Domain Service). Includes nation, lang, regulation, timezone, etc. (supported on both Mobile / PC)
• Get game-constant info: looks up the key-value registered in Partners from the client. (Mobile only, not supported in the PC environment)

GDS response example: {"is_default":false,"nation":"KR","lang":"ko","regulation":"KOREA","timezone":"Asia/Seoul","utc_offset":540,"ip":"211.34.57.xxx"}

Mobile

Prerequisites

• Call it after SDK initialization (initialize) completes.
• Constants.get is a synchronous function. No separate callback registration is needed.
• Additional prep when using get-game-constant-info: you must add the game_config module to the Partners SDK Config.
  • Location: Partners > GM > SDK Config Settings > Per-Game Config Management (mo) > game_config module

Development Flow

Get GDS

1. Inside the SDK-initialization-complete callback, call Constants.get("gds", "") to look up GDS info.
2. Parse and use nation, lang, regulation, timezone, etc. from the return value (JSON string).
3. If you only need the country code, you can simply look it up with Constants.get("nation", "").
4. If is_default is true, the country couldn't be determined by IP, so STOVE's default value was returned. Apply default handling or a retry policy in your branch logic.

Get game-constant info

1. Register the key-value items the game will use in the Partners game_config module.
2. Inside the SDK-initialization-complete callback, call Constants.get("game_config", "") to receive the registered values as a JSON string.
3. Parse the JSON and use the key values you need.

Troubleshooting

Get GDS

Get game-constant info

Sample Code

Get GDS

public void GetGds() {
    string gds = Constants.Get("gds");
    //ex) {"is_default":false,"nation":"KR","lang":"ko","regulation":"KOREA","timezone":"Asia/Seoul","utc_offset":540,"ip":"211.34.57.xxx"}
    string nation = Constants.Get("nation"); // ex) KR
}

Get game-constant info

public void GetGameConstants() {
    string gameConfig = Constants.Get("game_config");
}

PC (PCSDK)

Prerequisites

• Call it after BaseSDK initialization (Base_Initialize) completes. Calling before initialization returns a BASE_NOT_INITIALIZED (16) error.
• Base_GetGds is a synchronous function. No callback registration is needed.
• Game-constant info (game_config) isn't provided by PCSDK. It's a mobile-only feature.

Development Flow

1. At game start, after the Base_RestartAppIfNecessary callback → Base_Initialize completes, call Base_GetGds(&gds) to look up GDS info.
2. Verify the returned result (Result) with IsSuccessful().
3. On success, use the GetNation(), GetLanguage(), GetRegulation(), GetTimeZone(), GetUtcOffset(), and IsDefault() values from the StovePCGds object.
4. On failure, handle it per error code (see the troubleshooting table).

Troubleshooting

Sample Code

// Called inside the BaseSDK-initialization-complete callback (legacy API)
Stove::PCSDK::Base::StovePCGds gds;
auto result = Stove::PCSDK::Base::Base_GetGds(&gds);
if (result.IsSuccessful())
{
    const wchar_t* nation = gds.GetNation();
    const wchar_t* language = gds.GetLanguage();
    // Implement branch logic based on country/language.
}
else
{
    // Implement the failure logic. (see per-error-code handling)
}

Changing the Platform Display Language

Mobile

Prerequisites

• Call it after SDK initialization completes.
• 10 languages are supported, and passing Language.System follows the device-set language.
• Attempting to set an unsupported language shows the default language, English.

Development Flow

1. Call Localization.setLanguage(...) when the in-game language setting changes or when applying the user's language at game start.
2. To change to an explicit language, pass the desired Language value as the argument. (e.g., Language.English)
3. To return to the device language, pass Language.System. (used when the game doesn't set a language separately or wants to return to the initial state)

Troubleshooting

Sample Code

Setting the language

Pass the desired language code to explicitly change the platform language.

public void SetLanguage(Localization.Language language)
{
    Localization.SetLanguage(language);
}

Changing to the device language

Pass Language.System to set it to follow the device's default language.

public void SetDefaultLanguage()
{
    Localization.SetLanguage(Localization.Language.System);
}

PC (PCSDK)

Prerequisites

• Call it after BaseSDK initialization completes.
• The language can be specified by enum or string (ISO 639-1).
  • Enum-based: Base_SetLanguage(StoveLanguage) — pass a predefined StoveLanguage enum value.
  • String-based: Base_SetLanguageEx (C/C++ const wchar_t*, C# string) — pass the ISO 639-1 language code used in the game as-is.
• PCSDK supports 12 languages (system / en / ko / ja / zh-cn / zh-tw / de / fr / es / pt / th / vi).

Development Flow

1. Call it when the in-game language setting changes or when applying the user's language at game start.
2. Call Base_SetLanguageEx specifying the language by string (ISO 639-1), or call Base_SetLanguage with an enum value.
3. To return to the device language, pass the string "system".
4. Verify the returned result with IsSuccessful().

Troubleshooting

Sample Code

// Enum-based (legacy API)
auto result = Stove::PCSDK::Base::Base_SetLanguage(Stove::PCSDK::Base::StoveLanguage::ko);
if (result.IsSuccessful())
{
    // Implement the success logic.
}
else
{
    // Implement the failure logic.
}

// String-based (ISO 639-1)
Stove::PCSDK::Base::Base_SetLanguageEx(L"ko");

// Return to the device language
Stove::PCSDK::Base::Base_SetLanguageEx(L"system");

Frequently Asked Questions