> For the complete documentation index, see [llms.txt](/ko/llms.txt)


# 샘플과 참고 자료

만들고 싶은 기능이나 궁금한 내용에 맞는 데모, 샘플, 상세 자료를 찾습니다.



여기까지가 모험 게임 튜토리얼입니다. 아래에는 기능 구현이나 API 인수를 알아볼 때 쓸 수 있는 자료를 모았습니다. 개발 중 필요할 때 이 목록에서 찾아보세요.

## 예제 설정과 개념 다시 살펴보기

- [설정값 목록](): 각 장에서 사용한 이름과 수치입니다. 7장부터 숲 탐험의 보상은 15코인입니다.
- [게임 데이터와 처리 흐름](): 마스터 데이터와 사용자 데이터, Unity와 GS2의 역할을 살펴봅니다.

## 예제 코드와 템플릿

1장의 <a href="/samples/adventure/ko/AdventureLogin.cs" download>로그인 C# 코드</a>와 <a href="/samples/adventure/ko/01-account.yaml" download>Account 템플릿</a>, 이후 각 장의 코드와 템플릿을 아래에서 다운로드할 수 있습니다. 이름이 같은 C# 파일은 각 장의 안내에 따라 교체합니다. 4장은 3장의 코드로 동작을 확인합니다.

| 장 | Studio 화면 코드 | SDK C# 코드 | SDK 서버 설정 |
| --- | --- | --- | --- |
| 2장 | <a href="/samples/adventure/ko/02/AdventureStudioView.cs" download>AdventureStudioView.cs</a> | <a href="/samples/adventure/ko/02/AdventurePlay.cs" download>AdventurePlay.cs</a> | <a href="/samples/adventure/ko/02/adventure-game.yaml" download>adventure-game.yaml</a> |
| 3장 | <a href="/samples/adventure/ko/03/AdventureStudioView.cs" download>AdventureStudioView.cs</a> | <a href="/samples/adventure/ko/03/AdventurePlay.cs" download>AdventurePlay.cs</a><br><a href="/samples/adventure/ko/03/AdventurePlayer.cs" download>AdventurePlayer.cs</a> | <a href="/samples/adventure/ko/03/adventure-game.yaml" download>adventure-game.yaml</a> |
| 5장 | <a href="/samples/adventure/ko/05/AdventureStudioView.cs" download>AdventureStudioView.cs</a> | <a href="/samples/adventure/ko/05/AdventurePlay.cs" download>AdventurePlay.cs</a><br><a href="/samples/adventure/ko/05/AdventurePlayer.cs" download>AdventurePlayer.cs</a> | <a href="/samples/adventure/ko/05/adventure-game.yaml" download>adventure-game.yaml</a> |
| 6장 | <a href="/samples/adventure/ko/06/AdventureStudioView.cs" download>AdventureStudioView.cs</a> | <a href="/samples/adventure/ko/06/AdventurePlay.cs" download>AdventurePlay.cs</a><br><a href="/samples/adventure/ko/06/AdventurePlayer.cs" download>AdventurePlayer.cs</a> | <a href="/samples/adventure/ko/06/adventure-game.yaml" download>adventure-game.yaml</a> |
| 7장 | 6장 코드 사용 | 6장 코드 사용 | <a href="/samples/adventure/ko/07/adventure-game.yaml" download>adventure-game.yaml</a> |
| 8장 | <a href="/samples/adventure/ko/08/AdventureStudioView.cs" download>AdventureStudioView.cs</a> | <a href="/samples/adventure/ko/08/AdventurePlay.cs" download>AdventurePlay.cs</a> | 7장 설정 사용 |


## 만들고 싶은 기능 찾기

| 기능 | 튜토리얼 | 상세 자료 |
| ------------------------------ | ------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- |
| 계정 생성과 로그인       | [1장]()   | <a href='' target="_blank" rel="noopener">Account API(새 탭)</a>                     |
| 모험과 클리어 보상               | [3장]() | <a href='' target="_blank" rel="noopener">Quest API(새 탭)</a>                      |
| 코인 잔액 조회               | [3장]()  | <a href='' target="_blank" rel="noopener">Money2 API(새 탭)</a>                    |
| 스태미나 소비                 | [5장]() | <a href='' target="_blank" rel="noopener">Stamina API(새 탭)</a>                  |
| 코인으로 스태미나 회복 | [6장]()    | <a href='' target="_blank" rel="noopener">트랜잭션 설정(새 탭)</a>                 |
| 보상 변경과 모험 추가         | [7장]()  | <a href='' target="_blank" rel="noopener">마스터 데이터 관리(새 탭)</a>                        |
| 캐릭터 동기화             | [실시간 편]()    | <a href='' target="_blank" rel="noopener">동기화 튜토리얼(새 탭)</a> |

## 시작 시 통신 줄이기

화면에서 사용하는 데이터가 많아지면 로그인 후 `LoadUserDataAsync`로 플레이어 데이터를 한꺼번에 가져올 수 있습니다. 가져온 데이터는 SDK 캐시에 들어가 이후 데이터 조회에 사용됩니다.

```csharp
await Gs2.LoadUserDataAsync(login);
```

이 호출은 로그인 후 각 화면이 데이터 조회를 시작하기 전에 실행합니다. SDK 예제에서는 `AdventureLogin.cs`의 `Gs2.LoginAsync(...)`가 반환된 뒤 `Session = login;` 직전입니다. 이후 변경은 Handler나 `SubscribeWithInitialCallAsync` 구독을 통해 화면에 반영됩니다.

일괄 조회는 개별 조회에 필요한 통신을 줄이기 위한 기능입니다. 같은 플레이어로 이어서 플레이하기 위해 추가로 필요한 설정은 아닙니다. 자세한 내용은 <a href="https://gs2.hatenablog.com/entry/2026/11/11/113825" target="_blank" rel="noopener">GS2 공식 블로그 소개 글(일본어, 새 탭)</a>을 참고하세요.

## 데모와 샘플 찾기

- <a href='' target="_blank" rel="noopener">쇼룸(새 탭)</a>: 브라우저에서 GS2 기능을 체험합니다.
- <a href='' target="_blank" rel="noopener">샘플 코드(새 탭)</a>: 게임 전체 구현 예제와 기능별 샘플을 찾습니다.
- <a href='' target="_blank" rel="noopener">UIKit 튜토리얼(새 탭)</a>: UIKit으로 Unity 화면을 만드는 방법을 배웁니다.
- <a href="https://gs2.io/studio.html" target="_blank" rel="noopener">GS2 Studio(새 탭)</a>: Studio 소개와 시작 방법을 확인합니다.

## 예상대로 동작하지 않을 때

[문제 해결]()에 흔한 증상과 확인할 곳을 정리했습니다. 내 상황과 비슷한 항목부터 살펴보세요. API 인수와 오류는 위 표의 서비스별 레퍼런스에서 자세히 확인할 수 있습니다.




- [게임 데이터와 처리 흐름](/ko/get_start/adventure/resources/data-flow/)
  
- [게임 설정값 목록](/ko/get_start/adventure/resources/game-settings/)
  
- [증상별 문제 해결](/ko/get_start/adventure/resources/troubleshooting/)
  
