모험 게임을 만들며 배우는 GS2 on Game Server Services | Docs

개발 환경 준비하기

Mon, 01 Jan 0001 00:00:00 +0000

GS2 학습용 프로젝트와 빈 Unity 씬을 준비합니다. 여기서 만드는 GS2 계정은 게임 설정을 관리하는 개발자 계정입니다.

스크린샷은 일본어 UI입니다. 아래 절차에서는 영어 UI의 항목 이름을 사용합니다.

1. GS2에 가입하기

GS2 사이트(새 탭)에서 개발자 계정을 등록합니다. 받은 메일의 링크로 이메일 주소를 인증한 뒤 관리 콘솔(새 탭)에 로그인합니다.

2. 학습용 프로젝트 만들기

Project → Project list → Create project 를 엽니다.
프로젝트 이름에 adventure, 설명에 ‘모험 게임 연습’을 입력합니다.
처음 활성화할 리전을 Tokyo 로 선택합니다. 예제 코드도 Tokyo(ap-northeast-1)에 연결합니다.
계약 플랜 등의 내용을 확인하고 Create 를 누릅니다.

1. 계정을 만들고 로그인하기

Mon, 01 Jan 0001 00:00:00 +0000

먼저 게임에 로그인할 수 있게 만들어 봅시다. 로그인한 플레이어의 ID를 화면에 표시하고, Unity의 재생을 중지해도 같은 계정으로 돌아올 수 있게 합니다.

처음에는 계정을 만들고 플레이어 ID와 비밀번호를 저장합니다. 다음 실행부터는 저장한 정보로 로그인합니다. 로그인 후 받는 액세스 토큰에는 유효 기간이 있으므로 다음에 실행할 때도 로그인 절차를 거칩니다.

1. 플레이어 계정을 저장할 공간 만들기

GS2에서 설정과 데이터를 나누어 보관하는 공간을 네임스페이스 라고 합니다. 플레이어 계정을 저장할 GS2-Account 네임스페이스를 만들어 봅시다.

2. 퀘스트를 등록하고 목록에 표시하기

Mon, 01 Jan 0001 00:00:00 +0000

로그인이 되니 이제 모험 목록을 만들어 봅시다. 첫 모험은 숲 탐험 입니다. GS2에서는 모험을 퀘스트라고 부르며, 퀘스트 그룹으로 묶어 관리합니다. 이번에는 main 퀘스트 그룹에 forest라는 ID로 등록하고 화면에 이름을 표시합니다.

게임 설정 준비하기

퀘스트 이름이나 보상처럼 개발자가 정하는 게임 설정을 마스터 데이터 라고 합니다. 플레이어의 코인 잔액이나 진행 중인 퀘스트 정보는 유저 데이터 입니다. 먼저 목록에 표시할 마스터 데이터를 만듭니다.

forest는 코드에서 퀘스트를 지정할 때 쓰는 식별자이고, 숲 탐험 은 플레이어에게 보여 주는 이름입니다. 둘을 분리하면 화면의 이름을 바꾸어도 코드에서는 같은 퀘스트로 다룰 수 있습니다.

3. 퀘스트를 시작하고 보상 받기

Mon, 01 Jan 0001 00:00:00 +0000

목록에 표시된 숲 탐험 을 실제로 플레이할 수 있게 만들어 봅시다. 시작 으로 모험을 떠나고 클리어 로 돌아오면 10코인을 받습니다. 몇 번을 클리어해도 보상은 같고 첫 클리어 보너스는 넣지 않습니다.

클리어 보상은 GS2에 설정하기

보상 수량은 GS2의 퀘스트 설정에서 정합니다. 일반 클리어 보상을 무상 코인 10개로 설정하면 Unity가 클리어를 보고할 때 GS2가 코인을 지급합니다. Unity에서는 잔액 변경에 맞춰 화면을 갱신합니다.

코인은 GS2-Money2의 지갑 에 저장합니다. 지갑을 구분하는 번호를 슬롯 이라고 하며, 이 게임에서는 0을 사용합니다. 이 장에서 Money2 설정을 추가하고 이후에도 같은 지갑을 읽고 씁니다.

4. 다시 실행하여 이어서 플레이하기

Mon, 01 Jan 0001 00:00:00 +0000

3장까지 만든 게임을 다시 실행하여 모은 코인과 진행 중인 퀘스트가 남아 있는지 확인해 봅시다. 이 장에서는 코드나 서버 설정을 바꾸지 않습니다.

코인이 남아 있는지 확인하기

퀘스트를 클리어하여 코인을 10개 이상 모읍니다. 보상이 화면에 반영되면 플레이어 ID와 코인 잔액을 기록합니다.
Unity 재생을 중지했다가 다시 재생합니다. Studio는 자동으로 로그인하고, SDK에서는 로그인 버튼을 누릅니다. 이 장에서 다시 재생할 때는 매번 이 방법으로 로그인합니다.
플레이어 ID와 잔액이 기록한 값과 같은지 비교합니다. 퀘스트는 시작 전 상태여야 합니다.

코인과 퀘스트 진행 상태는 GS2에 저장됩니다. 1장에서는 같은 계정으로 로그인할 정보를 기기에 저장했습니다. 다시 실행하면 그 계정으로 로그인하고 3장의 표시 코드가 GS2에서 데이터를 가져옵니다.

5. 퀘스트 시작 시 스태미나 소비하기

Mon, 01 Jan 0001 00:00:00 +0000

이제 퀘스트에서 스태미나를 사용하도록 해 봅시다. 숲 탐험을 시작하는 데 5가 필요하고 부족하면 회복을 기다리는 규칙입니다.

시작하기 전에

진행 중인 퀘스트가 있다면 클리어한 뒤 스태미나 설정을 추가합니다.

추가할 설정

스태미나 설정 이름은 stamina입니다. 초기값과 일반 회복 상한은 모두 20으로 설정합니다. 사용한 스태미나는 300초마다 1씩 자연 회복되게 합니다.

따라 하기

스태미나 표 만들기

Add features 에서 Stamina 를 추가한 뒤 Tables → Stamina (Energy) 에 다음 행을 만듭니다.

6. 코인으로 스태미나 회복하기

Mon, 01 Jan 0001 00:00:00 +0000

퀘스트에서 모은 코인을 사용해 봅시다. 20코인으로 스태미나를 10 회복하는 상품을 refill이라는 이름으로 등록합니다. 퀘스트 보상으로 받은 무상 코인으로 구매할 수 있게 합니다.

결제와 회복을 함께 처리하기

코인 지불과 스태미나 회복을 하나의 트랜잭션으로 묶습니다. 코인이 부족하면 스태미나만 회복되는 일 없이 구매가 실패하도록 합니다.

따라 하기

상품 표 만들기

Add features 에서 Stamina Shop 을 추가하고 Tables → Stamina product (EnergyProduct) 에 다음 행을 만듭니다.

7. 설정을 바꾸고 게임에 반영하기

Mon, 01 Jan 0001 00:00:00 +0000

기본 기능이 완성되었으니 게임 내용을 바꿔 봅시다. 숲 탐험의 보상을 10코인에서 15코인으로 늘리고 동굴 탐험 도 추가합니다. 설정을 바꾸면 화면과 실제 보상이 어떻게 달라지는지 확인합니다.

시작하기 전에

진행 중인 퀘스트를 클리어하고 구매 등의 처리가 끝난 뒤 설정을 변경합니다.

변경할 내용

퀘스트	소비 스태미나	일반 보상	첫 클리어 보상
`forest` 숲 탐험	5	15코인	없음
`cave` 동굴 탐험	8	20코인	없음

따라 하기

기존 행 수정하고 새 행 추가하기

Tables → Quest (Quest) 를 열고 다음과 같이 편집합니다.

8. 통신 오류와 연속 클릭에 대응하기

Mon, 01 Jan 0001 00:00:00 +0000

구매 버튼을 연속으로 누르거나 통신을 끊어 봅시다. 지금까지 사용한 플레이어로 진행합니다.

처리 중에 다시 눌러 보기

코인을 20개 이상 준비합니다. 부족하면 퀘스트를 클리어하여 모읍니다.
20코인으로 스태미나 10 회복 을 누르고 곧바로 다시 눌러 봅니다.
처리 중에는 버튼이 비활성화되어 다음 구매를 시작할 수 없는지 확인합니다.

코드는 조작을 시작할 때 busy를 true로, finally에서 false로 되돌립니다. 버튼 비활성화뿐 아니라 Studio의 Run()과 SDK의 RunWrite()도 처리 중 호출을 막습니다.

구매가 끝나 버튼이 다시 활성화된 뒤 누르면 새로운 구매가 됩니다.