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

# Equipment

Manages the weapons and gear a player owns, grouped by category.




**이 데모에 대하여**

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

## 개요

Take equipment from a catalog of three pieces (`iron-sword`, `oak-staff`, `steel-shield`) and put it in your bag. Every piece you take becomes its own row in your list and uses one slot of the bag. When the bag fills up you can expand it, and you can discard pieces you no longer want.

## 체험 방법

1. Press **Take** next to an equipment name under **Take equipment**; that piece is added to **Your equipment** as a new row.
1. Take the same piece again and it is added as a separate row. The gauge and the `used/max` reading in **Equipment bag** go up by one each time (the bag starts with 4 slots).
1. Once every slot is in use, pressing **Take** no longer gives you anything.
1. Press **Expand** under **Equipment bag** to add 2 slots. The button is disabled once the bag reaches its ceiling of 10.
1. Press **Discard** on a row in **Your equipment** to throw away one piece of that kind and free a slot.

## 사용하는 GS2 서비스

- [GS2-Inventory](/ko/microservices/inventory/): GS2-Inventory's inventory model defines the bag (4 slots to start, 10 at most) and an item model for each of the three pieces, and holds the equipment the player owns. Each piece stacks to one and multiple stacks are allowed, so two of the same sword are two rows.
- [GS2-Exchange](/ko/microservices/exchange/): GS2-Exchange rate models define what each button does: **Take** acquires a piece, **Discard** consumes one, and **Expand** adds capacity (`Gs2Inventory:AddCapacityByUserId`), each run server-side as a free transaction.

## GS2 Studio에서 사용하기

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

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

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

## 소스 코드

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