아이템과 상점 만들기
숲 탐험을 클리어하면 코인과 함께 회복약을 하나 받도록 만듭니다. 회복약 하나를 사용하면 스태미나가 5 회복되며 상점에서는 20코인으로 하나를 살 수 있습니다.
1. 회복약 등록하기
아이템은 종류별 보유 수량을 관리하는 Simple Inventory에 저장합니다. 회복약의 ID는 potion입니다.
- Add features 에서 Items 를 추가합니다.
- Tables → Item 에 행을 추가하고 ID를
potion으로 설정합니다. 보유 수량은 플레이어 데이터이므로 이 표에는 입력하지 않습니다. - Publish → Calculate server differences 에서 배포한 뒤 Update the Unity project 를 실행합니다.
- 회복약 사용·구매 템플릿을 다운로드합니다.
회복약 저장·사용·구매 템플릿을 다운로드합니다. 다음 설정이 들어 있습니다.
| 설정 | 값 |
|---|---|
| Inventory 네임스페이스 | adventure-inventory |
| Simple Inventory | Inventory |
| 아이템 | potion |
| 사용·구매용 Exchange 네임스페이스 | adventure-item-actions |
다운로드한 템플릿을 관리 콘솔에서 배포합니다.
- Tokyo 리전에서 Deploy → Stack list → Create stack 을 엽니다.
- 스택 이름을
adventure-items로 지정하고 Template data 에서 다운로드한 JSON 파일을 선택합니다. - Create 를 누르고 Create complete 가 될 때까지 기다립니다.
이제 adventure-item-actions에 다음 두 교환 설정이 만들어집니다.
| 교환 이름 | 소비 | 획득 |
|---|---|---|
use_potion | 회복약 1개 | 스태미나 5 |
buy_potion | 무상 코인 20개 | 회복약 1개 |
2. 숲 탐험 보상에 회복약 추가하기
Tables → Quests → Quest 에서 forest를 엽니다. Completion rewards → Add item → Not set 에서 다음 액션을 추가합니다. 코인 입금과 앞 페이지에서 추가한 미션 카운터 증가 액션은 그대로 둡니다.
| 항목 | 입력할 값 |
|---|---|
| 액션 | AcquireSimpleItemsByUserId(inventory) |
| 대상 리소스 | None |
| namespaceName | Inventory |
| inventoryName | Inventory |
| userId | #{userId} |
acquireCounts 에 항목을 하나 추가하고 itemName은 potion, count는 1로 설정합니다. 저장하고 서버에 배포한 뒤 Unity 프로젝트도 업데이트합니다.
adventure-game에 사용한 템플릿을 엽니다. forest의 contents → completeAcquireActions 끝에 다음 항목을 추가합니다. 코인 입금과 미션 카운터 증가 항목은 그대로 둡니다.
- action: Gs2Inventory:AcquireSimpleItemsByUserId
request: |-
{"namespaceName":"adventure-inventory","inventoryName":"Inventory","userId":"#{userId}","acquireCounts":[{"itemName":"potion","count":1}]}Deploy → adventure-game → Update stack 에서 Template data 에 수정한 파일을 선택해 업데이트합니다. Update complete 가 될 때까지 기다립니다.
3. Unity에 수량과 사용·구매 버튼 추가하기
Unity의 재생을 멈춥니다. 다음 파일을 추가하면 오른쪽 화면이 회복약 수량과 조작 버튼으로 바뀝니다. 왼쪽 모험 화면은 그대로 사용합니다.
빈 GameObject를 만들고 Extensions라고 이름 붙입니다. 모험 화면의 로그인 보너스와 미션 보상 버튼은 그대로 둡니다.
AdventureItems.cs를 Assets/AdventureExtensions에 넣고 Extensions에 Adventure Items 를 추가합니다. 로그인된 Gs2ClientHolder와 Gs2GameSessionHolder를 사용합니다.
Extensions의 Adventure Daily 체크를 해제합니다.
AdventureItems.cs를 Assets/AdventureExtensions에 넣고 Extensions에 Adventure Items 를 추가합니다. Login 에 씬의 AdventureLogin을 할당합니다.
Game 뷰를 넓혀 왼쪽 모험 화면과 오른쪽 회복약 화면이 모두 보이게 합니다. 재생하고 로그인한 뒤 회복약 수량이 표시되는지 확인합니다.
SimpleInventory("Inventory").SimpleItem("potion")을 구독해 수량을 표시합니다. 초기값과 이후 변경을 같은 콜백으로 전달받습니다.
var item = Client.Inventory.Namespace(InventoryNamespace).Me(Session)
.SimpleInventory("Inventory").SimpleItem("potion");
var id = await item.SubscribeWithInitialCallAsync(value => potion = value);왼쪽에서 숲 탐험을 시작하고 클리어합니다. 오른쪽 회복약이 하나 늘고 왼쪽 코인도 늘면 보상이 추가된 것입니다. 배포 후 보상 변경이 적용되기까지 최대 5분이 걸릴 수 있습니다. 코인만 늘면 잠시 기다린 뒤 숲 탐험을 새로 시작해 클리어합니다. 코인과 스태미나는 계속 왼쪽 모험 화면에서 확인합니다.
4. 회복약 사용하기
스태미나가 15 이하일 때 회복약 1개로 스태미나 5 회복 을 누릅니다. 회복약이 하나 줄고 스태미나가 5 늘어납니다. 도중에 자연 회복이 일어나면 그만큼도 더해집니다.
사용 버튼은 RunWrite(id => Exchange("use_potion", id))로 다음 교환 처리를 호출합니다. requestId는 통신 오류 후 같은 작업을 재시도하기 위한 키입니다.
private async UniTask Exchange(string rate, string requestId)
{
var transaction = await Client.Exchange.Namespace("adventure-item-actions").Me(Session).Exchange()
.ExchangeAsync(rate, 1, speculativeExecute: false, duplicationAvoider: requestId);
if (transaction != null) await transaction.WaitAsync(all: true);
}템플릿은 소비에 Gs2Inventory:ConsumeSimpleItemsByUserId, 획득에 Gs2Stamina:RecoverStaminaByUserId를 지정합니다. 회복약이 0개일 때도 사용 버튼을 눌러 봅니다. 수량 부족이 표시되고 스태미나는 늘지 않습니다.
5. 코인으로 회복약 구매하기
코인을 20개 이상 준비하고 20코인으로 회복약 1개 구매 를 누릅니다. 코인이 20개 줄고 회복약이 하나 늘어납니다.
구매 버튼도 같은 교환 API를 사용하며 교환 이름만 buy_potion으로 바꿉니다.
RunWrite(id => Exchange("buy_potion", id)).Forget();구매 시 Gs2Money2:WithdrawByUserId의 slot = 0, withdrawCount = 20, paidOnly = false로 코인을 소비하고, Gs2Inventory:AcquireSimpleItemsByUserId로 potion 하나를 지급합니다.
재생을 멈췄다가 다시 시작하고 같은 플레이어로 로그인합니다. 구매한 회복약이 남아 있는지 확인한 뒤 다음 단계에서 캐릭터를 추가합니다.