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

# Equipment Loadout

Gives each character its own equipment slots, with per-slot restrictions on what fits.




**이 데모에 대하여**

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

## 개요

Recruit characters, take equipment, and put it into each character's own `weapon` and `armor` slots. Each slot only accepts certain equipment: `weapon` takes `iron-sword` and `oak-staff`, and `armor` takes only `steel-shield`. Put the wrong piece in a slot and GS2 itself refuses it, not the page. A piece of equipment can be worn by only one character at a time.

## 체험 방법

1. Press **Recruit** under **Recruit a character** to recruit a character. A tab for it appears at the top of **Loadout**.
1. Press **Take** under **Take equipment** to take a piece of equipment. It shows up among the equipment cards in **Loadout**.
1. In **Loadout**, pick a character's tab, tap a slot card (`weapon` or `armor`) to choose where equipment goes, then tap an equipment card to put it in that slot.
1. With the `weapon` slot chosen, tap `steel-shield`; GS2 refuses it and a message starting with `GS2 refused` appears.
1. A piece already worn by another character is refused too. Remove it from that character with the **Take off** button first.

Each equipment card shows who is wearing it and in which slot after **Worn by**. If the bag fills up, press **Expand** under **Equipment bag** to add room.

## 사용하는 GS2 서비스

- [GS2-Formation](/ko/microservices/formation/): A GS2-Formation property form model defines the `weapon` and `armor` slots each character has. Each slot's `propertyRegex` limits which equipment item sets it accepts, and GS2-Formation refuses anything that does not match.
- [GS2-Inventory](/ko/microservices/inventory/): GS2-Inventory holds the characters and the equipment in separate inventories. Putting a piece on fetches the equipment's item set with a signature and passes that signature to the slot.
- [GS2-Script](/ko/microservices/script/): A GS2-Script script runs whenever a form is updated and marks the equipment's item set with the character wearing it. It refuses a piece another character is wearing, so each piece is worn by one character at a time.
- [GS2-Exchange](/ko/microservices/exchange/): GS2-Exchange rate models define **Recruit** and **Take** as free transactions that grant a character or a piece of equipment.

## GS2 Studio에서 사용하기

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

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

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

## 소스 코드

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



