PC-Bang Integration

Understanding

PC-Bang integration is a feature that lets a game use the STOVE PC-Bang service.
For users who connect from a Smilegate PC-Bang affiliate IP, PC-Bang connection confirmation, login/logout, benefit refresh, and billing are handled automatically.
Integration uses a separate PCBang SDK provided by the STOVE PC SDK.

Application Environment and Operating Scope

PC-Bang Benefit Types

The benefit tier of a PC-Bang-connected user is delivered as a PCBangPremium enum value.

Automatic Benefit Refresh Every 4 Minutes

After a PC-Bang user's login completes, the PCBang SDK automatically refreshes PC-Bang benefits every 4 minutes.
The game doesn't need to implement its own timer.

Integration Guide

Integration Preparation

Development

PC (PCSDK) — PCBang SDK

Prerequisites

• BaseSDK integration and initialization (Base_Initialize) must come first. Initializing the PCBang SDK before initialization fails.
• Base_RunCallback() must be called periodically in the game loop for the callback to be delivered correctly.
• Include the PCBangSDK.h header and use the Stove::PCSDK::PCBang namespace.
• The cleanup order must proceed as PCBang_UserLogout → PCBang_UnInitialize → Base_UnInitialize.

Development Flow

1. Initialization After Base_Initialize completes, initialize the PCBang SDK with PCBang_Initialize(), and after it succeeds, call the PC-Bang status lookup.
2. PC-Bang status lookup Receive the PC-Bang status object with PCBang_CheckPCBangStatus(...) and inspect the benefit tier. Use StovePCBangStatus::GetPremiumStatus().
   • PCBANG_PREMIUM / PCBANG_FREE → PC-Bang connection. Proceed to the next step
   • PCBANG_FREE_OTHER / PCBANG_ERROR → don't proceed with subsequent steps
3. User login When the PC-Bang connection is confirmed, call PCBang_UserLogin(...). It registers the initial-login callback and the 4-minute-interval refresh callback at once. In the initial-login callback, get the benefit code, PC-Bang unique number (serial number), and remaining time, and reflect them in the game state.
4. Automatic benefit refresh After login, the benefit-refresh callback (StovePCRefreshUserBenefits) is called automatically every 4 minutes. No game-side timer is needed; just reflect the callback values.
5. User logout Right before the game exits, call PCBang_UserLogout(...) to end billing and benefit refresh.
6. Cleanup Clean up with PCBang_UnInitialize() then Base_UnInitialize(), and terminate the game process.
7. Version check (optional) When contacting technical support, include the version string obtained via PCBang_GetVersion(buffer, length).

Troubleshooting

Sample Code

// PCBang SDK C/C++ API example. Unreal uses it the same way.
#include "PCBangSDK.h"

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

// 1) Initialization (after Base_Initialize completes)
auto initResult = PCBang_Initialize();
if (!initResult.IsSuccessful())
{
    return;
}

// 2) Look up PC-Bang status
PCBang_CheckPCBangStatus(
    [](CallbackResult callbackResult, StovePCBangStatus status)
    {
        if (!callbackResult.GetResult().IsSuccessful()) return;

        auto premium = status.GetPremiumStatus();
        if (premium != PCBangPremium::PCBANG_PREMIUM &&
            premium != PCBangPremium::PCBANG_FREE)
        {
            // Not a PC-Bang connection. Don't proceed with subsequent steps
            return;
        }

        // 3) PC-Bang user login (registers the initial-login + 4-minute-interval refresh callbacks together)
        PCBang_UserLogin(
            [](CallbackResult loginResult, StovePCBangUserLogin login)
            {
                if (loginResult.GetResult().IsSuccessful())
                {
                    int32_t serial = login.GetPCBangSerialNumber();
                    int32_t remain = login.GetRemainTime();
                    // Reflect the benefit in the game state
                }
            },
            // 4) Benefit-refresh callback called automatically every 4 minutes
            [](CallbackResult refreshResult, StovePCRefreshUserBenefits benefits)
            {
                if (refreshResult.GetResult().IsSuccessful())
                {
                    // This callback is called even in the PCBANG_FREE state.
                    auto premium = benefits.GetPremiumStatus();
                }
            }
        );
    }
);

// 5) On game exit
PCBang_UserLogout([](CallbackResult result) { /* handle the result */ });
PCBang_UnInitialize();
// Then call Base_UnInitialize

Frequently Asked Questions