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

# Character Dex

Keeps a dex of every character species the player has ever obtained.




**이 데모에 대하여**

데모는 익명 계정으로 자동 로그인합니다. 이 계정은 쇼룸의 모든 데모에서 공유되므로 한 데모에서 얻은 아이템이나 재화가 다른 데모에도 반영됩니다. 로딩에 약간 시간이 걸립니다. 화면이 작다면 새 탭에서 열어 사용해 보세요.

## 개요

A dex of four characters (`knight`, `mage`, `archer`, `healer`). Pressing **Recruit** acquires the character and files it in the dex in a single transaction, and the dex keeps the moment it first arrived. Once a character is in the dex it stays there, and its **Recruit** button is no longer shown.

## 체험 방법

1. **Character dex** lists the four characters. A character you have not obtained shows **Not yet** under **Acquired**.
1. Press **Recruit** on a character you do not have yet; you get one of that character and it is filed in the dex at the same time.
1. On that row, **Not yet** and **Recruit** disappear and **Acquired at** shows when the character first arrived.
1. Recruit all four to complete the dex.

Recruited characters go into the same inventory the **Characters** demo uses, so they also show up in the other character demos opened in the same browser.

## 사용하는 GS2 서비스

- [GS2-Dictionary](/ko/microservices/dictionary/): GS2-Dictionary's `CharacterDictionary` namespace defines an entry model per character, and records which characters the player has ever obtained and when each first arrived.
- [GS2-Exchange](/ko/microservices/exchange/): A GS2-Exchange rate model defines **Recruit**: it acquires the character (`Gs2Inventory:AcquireItemSetByUserId`) and adds the dex entry (`Gs2Dictionary:AddEntriesByUserId`) together as one free transaction run server-side.
- [GS2-Inventory](/ko/microservices/inventory/): GS2-Inventory's `Character` inventory holds the characters obtained by recruiting.

## GS2 Studio에서 사용하기

GS2 Studio의 Simple 모드에서 **Add features** 를 열고 **Character Dex** 의 **Add** 를 누르면 이 기능을 자신의 프로젝트에 가져올 수 있습니다. 패키지를 직접 지정하려면 **Add from GitHub** 를 선택하고 아래 패키지를 입력합니다.

```text
https://github.com/gs2io/gs2-studio-package/tree/main/foundation-economy-character-dictionary/packages/foundation-economy-character-dictionary
```

- Owner: `gs2io`
- Repository: `gs2-studio-package`
- Subdirectory: `foundation-economy-character-dictionary/packages/foundation-economy-character-dictionary`

## 소스 코드

- 데모 프로젝트: <https://github.com/gs2io/gs2-studio-package/tree/main/foundation-economy-character-dictionary/live-demo>
- 기능 패키지: <https://github.com/gs2io/gs2-studio-package/tree/main/foundation-economy-character-dictionary>