Overindulgence Prevention

Understanding

Games serviced online domestically must display an overindulgence-prevention message on the game screen at set intervals, per the Enforcement Decree of the 「Game Industry Promotion Act」.
To handle this mandatory display, the STOVE PC SDK delivers the overindulgence-warning message, elapsed play time, and minimum message-display time via a callback through the Base SDK.
The game can use the delivered info to build a UI that displays the message at an identifiable location in-game.

Application Environment and Operating Scope

Info the SDK Delivers

After play starts, the following info is delivered via a callback at set intervals.
The game uses these values to build the mandatory-display UI.

Message-Display Example

The message delivered via the callback has the form below. The elapsed-time info is included in the message.

"1 hour has passed since you started playing. Excessive gameplay can interfere with a normal daily life."

Application Methods

You can apply the overindulgence-prevention message by choosing one of two methods.
Both methods must satisfy the legal requirements (display interval, minimum display time, readability, etc.).

Integration Guide

Basic Integration Structure

• Register the notification
  • After Base SDK initialization completes, call the Base_OverImmersionNotification API to register the overindulgence-prevention notification.
  • This API only needs to be called once, and we recommend calling it inside the Base_Initialize success callback.
  • Once registered, the OnOverImmersionFinished callback is called automatically every hour from the start of play.

• Receiving the callback and extracting info
  • The callback delivers a StovePCOverImmersion struct. Look up the message, elapsed time, and minimum display time from the struct and display them on screen.
  • The message obtained via GetWarningMessage() is the result translated into the language set by Base_SetLanguage.
  • If called from a country other than Korea, the callback returns a NOT_SUPPORTED_COUNTRY (31) error. Implement it so that outside domestic service it's bypassed naturally with no special handling.

• Displaying the message
  • Display the message at an identifiable location in-game (e.g., a top/bottom banner area of the screen, the system-message area, etc.).
  • Keep it on screen for the delivered minimum message-display time (seconds), then have it disappear naturally.
  • Ensure the message area's z-order and readability so it isn't hidden by other UI.

Development

PC (PCSDK)

Prerequisites

• BaseSDK integration and initialization (Base_Initialize) must come first. Calling before initialization means the callback won't work.
• The callback-dispatch function (Base_RunCallback()) must be called periodically in the game loop for the callback to be delivered correctly.
• To display the message in multiple languages, set the language in advance with the language-setting API (Base_SetLanguage (enum-based) / Base_SetLanguageEx (string-based)). The message received in the callback is automatically translated into the set language.
• Registration only needs to be called once. We recommend calling it right after initialization succeeds.

Development Flow

1. Register the notification After initialization completes, call the notification-registration API (Base_OverImmersionNotification) to register the overindulgence-prevention notification.
2. Receive the callback The registered callback is called every hour from the start of play. The callback arguments are the callback result and the overindulgence-info object. (CallbackResult, StovePCOverImmersion)
3. Verify the result Check success via the callback result. (CallbackResult.IsSuccessful()) In countries other than Korea, NOT_SUPPORTED_COUNTRY (31) is returned.
4. Extract the info Get the message, elapsed time, and minimum display time from the overindulgence-info object. (GetWarningMessage(), GetElapsedTimeInHours(), GetMinExposureTimeInSeconds())
5. Display the message Show the message at an identifiable location in-game, keep it for at least the minimum display time (seconds), then have it disappear naturally.

Troubleshooting

Sample Code

// Legacy C/C++ API (common to Native C/C++ and Unreal)
using namespace Stove::PCSDK;
using namespace Stove::PCSDK::Base;

// (optional) Pre-set the language for multilingual display
Base_SetLanguageEx(L"ko");

// Register the overindulgence-prevention notification — call once inside the Base_Initialize success callback
Base_OverImmersionNotification(
    [](CallbackResult callbackResult, StovePCOverImmersion overImmersion)
    {
        if (callbackResult.GetResult().IsSuccessful())
        {
            const wchar_t* message   = overImmersion.GetWarningMessage();
            int32_t elapsedHours     = overImmersion.GetElapsedTimeInHours();
            int32_t minExposureSec   = overImmersion.GetMinExposureTimeInSeconds();
            // Display message in the game UI, keep it for at least minExposureSec, then dismiss
        }
        else
        {
            // Bypass naturally for cases like non-Korea countries (NOT_SUPPORTED_COUNTRY=31)
        }
    }
);

Frequently Asked Questions