Game-Time Choice System

Understanding

The game-time choice system (shutdown system) is a system that lets guardians choose and restrict the game-play time of youths under 19.
The STOVE platform supports this feature for games rated under 19.

The STOVE PC SDK delivers the time remaining until game exit, the notification message, and the message-display time via a Base SDK callback.
The game should use this info to display an in-game notification and, when 0 minutes is reached, exit the game naturally.

Application Environment and Operating Scope

Info the SDK Delivers

When a target user logs in to the game, the following info is delivered via a callback at set times.
The game uses these values to build the notification UI and forcibly exits the game at the exit time.

Callback Timing and Notifications

The OnShutdownFinished callback is called up to 4 times, from near game-time expiry to the exit point.
The game UI should display a notification matching each point.

Integration Guide

Integration Preparation

To use the game-time choice system feature, the list of shutdown-target games and the play-time settings must be completed in advance.
For those settings, contact the publishing technical contact.

Basic Integration Structure

From game launch to exit, it operates in the order register notification → receive callback → display notification and handle exit.

StovePCShutdown Struct

The struct delivered via the callback provides the following methods.

Development

PC (PCSDK)

Prerequisites

• BaseSDK integration and initialization (Base_Initialize) must come first.
• The callback-driving function (Base_RunCallback()) must be called periodically in the game loop for the callback to be delivered correctly.
• The publishing technical contact must complete, in advance, adding to the shutdown game list, store registration and key issuance, building the game-time choice system page, and applying the one-stop shutdown service.
• Registration only needs to be called once. We recommend calling it after initialization succeeds.

Development Flow

1. Register the notification: After initialization completes, call the shutdown-notification-registration function (Base_ShutdownNotification).
2. PCSDK internal handling: The PCSDK looks up the user's shutdown info via a Web API. If they're a target user, the event is registered; if not, the callback isn't called.
3. Advance-notification callback (10/5/1 minutes before): The shutdown-notification callback is delivered. Get the remaining time with StovePCShutdown's GetInadvanceTimeInMinutes() (inadvanceTimeInMinutes in C#) and the message with GetShutdownMessage() (shutdownMessage in C#), and display them in the UI. Keep it for at least GetExposureTimeInSeconds() (exposureTimeInSeconds in C#).
4. Exit callback (0 minutes): When the remaining time (GetInadvanceTimeInMinutes()) is 0, display the exit-notice UI and take the user's confirmation input.
5. Exit the game: After the user confirms, terminate the game process immediately. Omitting the exit notice can be a policy violation.

Troubleshooting

Sample Code

using namespace Stove::PCSDK;
using namespace Stove::PCSDK::Base;

// 1) Register the shutdown notification — call once inside the Base_Initialize success callback
Base_ShutdownNotification(
    [](CallbackResult callbackResult, StovePCShutdown shutdown)
    {
        if (!callbackResult.GetResult().IsSuccessful())
        {
            // Non-target-user / exception handling
            return;
        }

        int32_t remaining   = shutdown.GetInadvanceTimeInMinutes();
        const wchar_t* msg  = shutdown.GetShutdownMessage();
        int32_t exposureSec = shutdown.GetExposureTimeInSeconds();

        // Display the message in the UI, keep it for at least exposureSec
        if (remaining == 0)
        {
            // Show the exit-notice UI → user confirmation input → terminate the game process
        }
    }
);

Frequently Asked Questions