- 마지막 업데이트
점검·업데이트 확인하기
스토브 가입
스토브 로그인
기기등록
게임진입
결제
기타설정
게임해지
스토브 탈퇴서비스 소개
게임 서버를 점검하거나 게임의 새 버전(업데이트)이 배포되면, 이용자는 게임에 들어가기 전에 그 사실을 미리 알 수 있어요. 게임을 실행하는 순간 안내 팝업이 뜨는데, 모바일에서는 앱을 실행할 때, PC에서는 스토브 PC 클라이언트(런처)에서 게임을 실행할 때 나타나요. 점검 중에는 접속이 제한되고, 업데이트가 있으면 최신 버전을 받도록 안내해요.
이건 꼭 알아 두세요
스토브의 안내 팝업은 상황을 알리는 용도예요. 실제 접속 차단, 강제 종료(Kick), 리소스 업데이트는 게임사가 직접 구현해요.
핵심개념
| 용어 | 설명 |
|---|---|
| 점검 안내 | 게임 서버가 점검 중일 때 이용자에게 노출되는 안내. 점검이 끝날 때까지 게임 접속이 제한됨 |
| 필수 업데이트 | 새 버전으로 업데이트해야만 게임에 들어갈 수 있는 안내. 접속 중이던 이용자도 업데이트를 위해 종료됨 |
| 선택 업데이트 | 업데이트 여부를 이용자가 직접 고르는 안내. '나중에 하기'를 선택하면 현재 버전으로 계속 이용 가능 |
| 업데이트 진행 | 안내에 따라 최신 버전을 받는 과정. 모바일은 마켓(Google Play·App Store), PC는 스토브 PC 클라이언트(런처)에서 설치됨 |
이용 시나리오
점검 안내받기
점검이 시작되면 이용자는 게임을 실행할 때 점검 안내 팝업을 보고, 점검이 끝날 때까지 접속이 제한돼요. 게임에 접속 중이던 이용자는 안내와 함께 접속이 종료되고, 점검이 끝난 뒤 다시 실행하면 정상적으로 게임에 진입할 수 있어요.
| 이용자 상황 | 이용자가 겪는 화면·동작 |
|---|---|
| 게임에 접속 중인데 점검이 시작될 때 | 점검 안내 팝업과 함께 접속이 종료됨 '확인' 선택 시 앱이 종료되거나 대기 화면으로 이동 |
| 점검 중에 게임을 실행할 때 | 실행 직후 점검 안내 팝업이 노출되고 게임 진입이 제한됨 등록된 점검 시간·안내 메시지를 팝업에서 확인 |
| 점검이 끝난 뒤 다시 실행할 때 | 점검 팝업 없이 정상적으로 게임에 진입 |
이건 꼭 알아 두세요
ㆍ점검 팝업은 게임사가 파트너스·게임 운영툴에 등록한 점검 정보로 노출돼요.
ㆍ접속 중인 이용자 종료(Kick)는 게임사가 게임서버에서 처리해요.
ㆍ백그라운드에서 점검이 시작되면 SDK 팝업이 안 뜰 수 있어 게임서버 Kick이 필요해요.
ㆍ화이트리스트(파트너스·게임 운영툴)에 등록된 QA·운영 인력은 점검 중에도 접근할 수 있어요.
모바일 환경은 이용자의 네트워크 상태와 앱 상태(포그라운드·백그라운드)가 다양해 점검 중 예외 상황이 생길 수 있어요. SDK만으로는 이를 완전히 처리할 수 없으니, 게임 서버 기반의 안전장치를 함께 구현해야 해요.
| 예외 상황 | 권장 대응 방법 |
|---|---|
| 점검 시작 전 앱을 백그라운드에 내려놓은 경우 | 포그라운드 전환 시 SDK 팝업 누락 가능 → 게임서버 Kick 또는 점검 상태 재확인 로직 구현 |
| 서버 통신이 없는 구간에서 점검 시작 (로비, 싱글 플레이 중) |
→ 서버 통신 재개 시 점검 상태 확인 로직 구현 다음 서버 요청에 점검 응답을 반환해 팝업 노출 |
| Kick 처리가 누락된 이용자가 접속을 유지하는 경우 | → 게임서버에서 외부 접속 차단 구현 클라이언트 우회 접속 방지 |
| 비행 모드·지하철 등 네트워크가 단절된 구간 | → 재연결 후 서버 통신 시 점검 상태 확인 initialize 실패 시 재시도(retry) 처리 |
이건 꼭 알아 두세요
ㆍSDK 점검 팝업은 안내용이라, 접속 차단·Kick·입력 차단은 게임사가 구현해요.
ㆍ게임 클라이언트는 위변조에 취약하니 실제 차단은 게임서버에서 처리해요.
ㆍPC는 런처가 진입을 직접 차단해 예외 상황이 적어요. 단, 접속 중 이용자 Kick·점검 안내는 게임서버에서 동일하게 구현해요.
필수 업데이트 하기
파트너스에서 업데이트를 필수로 지정하면, 이용자는 최신 버전으로 업데이트해야만 게임에 접속할 수 있어요. 게임을 실행하면 업데이트 팝업이 자동으로 뜨고, 이미 접속 중인 이용자는 강제로 접속이 종료(Kick)돼요.
| 단계 | 처리 주체 | 내용 |
|---|---|---|
| 1 | 파트너스 (스토브) | 앱 업데이트 버전 등록, 업데이트 옵션을 '필수'로 지정 |
| 2 | 게임 운영툴 (게임사) | 접속 중인 미업데이트 이용자 Kick 처리 (최신 버전 이용자 제외) |
| 3 | SDK / 런처 (스토브) | 앱 실행 시 업데이트 팝업 자동 노출 ㆍ모바일: SDK initialize 시 노출 ㆍPC: 스토브 클라이언트(런처)가 노출 |
| 4 | 이용자 | '업데이트' 선택 시 최신 버전 설치 ㆍ모바일: 마켓(Google Play / App Store)으로 이동 ㆍPC: 스토브 클라이언트(런처)에서 설치 |
| 5 | 게임 클라이언트 (게임사) | 앱 재실행 → 리소스 업데이트 확인 → 게임 접속 |
이건 꼭 알아 두세요
Kick은 미업데이트 이용자만 대상이에요 (최신 버전 이용자 제외).
'업데이트' 선택 시 마켓(모바일) / 스토브 클라이언트(PC)로 이동해요. 재실행·리소스 업데이트는 게임사가 구현해야 해요.
선택 업데이트 하기
업데이트를 필수로 지정하지 않으면, 이용자가 업데이트 여부를 직접 선택할 수 있어요. '나중에 하기'를 선택하면 현재 버전 그대로 게임에 진입할 수 있고, 이미 접속 중인 이용자도 강제로 종료되지 않아요.
| 단계 | 처리 주체 | 내용 |
|---|---|---|
| 1 | 파트너스 (스토브) | 앱 업데이트 버전 등록, 업데이트 옵션을 '선택'으로 지정 |
| 2 | 게임 운영툴 (게임사) | 접속 중인 이용자 Kick 미적용 (다음 앱 실행 시 업데이트 팝업 노출) |
| 3 | SDK / 런처 (스토브) | 앱 실행 시 '업데이트' + '나중에 하기' 팝업 자동 노출 ㆍ모바일: SDK initialize 시 노출 ㆍPC: 스토브 클라이언트(런처)가 노출 |
| 4 | 이용자 | ㆍ'업데이트' 선택 시: 최신 버전 설치 (모바일은 마켓, PC는 런처) ㆍ'나중에 하기' 선택 시: 현재 버전으로 계속 진입 |
| 5 | 게임 클라이언트·서버 (게임사) | ㆍ업데이트 시: 앱 재실행 → 리소스 업데이트 확인 → 게임 접속 ㆍ미업데이트 시: 게임서버에서 구버전 클라이언트 호환성 유지 |
이건 꼭 알아 두세요
선택 업데이트에서 '나중에 하기'를 선택한 이용자는 구버전으로 접속하므로, 게임서버에서 구버전 클라이언트와의 호환성을 유지해야 해요.
필수·선택 여부에 따라 Kick 대상 범위가 달라지므로, 게임서버에서 업데이트 옵션을 정확히 확인하고 처리해야 해요.
연동개요
전체 적용 흐름
| 단계 | 주체 | 활동 | 상세 내용 |
|---|---|---|---|
| 1단계 | 게임사 기획·운영팀 | 정책 결정 | Kick 대상 범위, 화이트리스트 관리 대상, 모바일 예외 처리 범위를 결정해 개발팀에 전달 |
| 2단계 | 게임사 운영팀·퍼블리싱 기술팀 | 파트너스 설정 | 점검 시간·안내 메시지 등록 (모바일·PC) 앱 버전 및 필수/선택 옵션 등록 화이트리스트 디바이스 ID 등록 |
| 3단계 | 게임사 개발팀 | 게임서버 구현 | 게임서버 점검 설정 및 접속 차단 이용자 Kick (서버 통신 기반) 게임 화이트리스트 관리 앱 버전·업데이트 옵션 관리 |
| 4단계 | 게임사 개발팀 | 클라이언트 구현 | Kick 팝업 및 앱 종료·재실행 처리 (모바일·PC) 포그라운드 전환 시 점검 상태 재확인 (모바일) initialize 실패 시 재시도(retry) (모바일) |
| 5단계 | 게임사 QA팀 | 검증 및 배포 | 체크리스트로 환경별 시뮬레이션 후 Sandbox → Live 순서로 검증·배포 |
시작 전 결정 항목
점검·업데이트 기능 연동 전, 아래 항목을 게임팀 내부에서 먼저 결정해 주세요.
| 결정 항목 | 선택지 및 내용 | 결정 후 처리 |
|---|---|---|
| ① Kick 대상 범위 | 상황별 Kick 대상을 구분해 처리 (점검: 전체 / 필수 업데이트: 미업데이트 이용자) | Kick 대상 필터링 로직 개발팀에 전달 |
| ② 화이트리스트 관리 대상 | 플랫폼: 파트너스에 디바이스 ID 등록 게임: 게임 운영툴에 계정 등록 점검 중 완전 접근은 두 곳 모두 등록 필요 |
QA·운영 인력 디바이스 ID 수집 후 등록 |
| ③ 모바일 예외 처리 범위 | 권장 구현 포그라운드 전환·서버 통신 재개 시 점검 상태 재확인 initialize 실패 시 재시도(retry) |
구현 범위 확정 후 개발팀에 전달 게임서버 외부 접속 차단은 필수 |
역할 분담
점검·업데이트 연동에서 스토브가 처리하는 영역과 게임사가 직접 구현하는 영역이에요.
스토브 플랫폼이 제공하는 것
게임사가 구현해야 하는 것체크리스트
| 구분 | 역할 | 점검항목 |
|---|---|---|
| 필수 | 게임 클라이언트 | 파트너스 점검 설정 및 SDK 점검 팝업 노출 확인 (모바일)
|
| 필수 | 게임 클라이언트 | PC 게임 점검 설정 및 런처 노출 확인 (PC)
|
| 필수 | 게임 클라이언트 | 앱 업데이트 파트너스 설정 및 팝업 노출 확인
|
| 권장 | 게임 클라이언트 | 모바일 예외 상황 안전장치 구현 확인 (모바일 한정)
|