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

# Guilds

Handles player guilds: capacity, permission roles, and which guild a player belongs to.




**이 데모에 대하여**

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

## 개요

Found a guild that every showroom visitor shares, or find one another visitor founded and join it. A guild either lets anybody join or has the master approve each request, and the master can answer join requests, hand the guild over, or disband it. A guild starts with room for 5 and can grow to 10, and each player belongs to one guild at a time.

## 체험 방법

1. Type a guild name into **Name your guild** under **Guild lobby**. To require approval, press **Join policy: anybody joins (press to change)** so it reads **the master approves**.
1. Press **Create a guild with this name**. The lobby shows the guild's name, head count and members (you as **master**), and **Your guild** shows **You are a member. The lobby above shows which guild.** and **Room for 5, up to 10**.
1. Open this demo in another browser (or a private window); the guild appears under **Guilds you can join**. Press **Join ...** for an open guild, or **Ask to join ...** for one that needs approval.
1. For an approval guild, the master sees the request under **Requests to join** and presses **Accept ...** or **Decline ...**.
1. A member leaves with **Leave the guild**. A master with other members presses **Hand over to ... and leave**; a master alone presses **Disband the guild**.

Guilds are shared by every showroom visitor, so guilds other visitors founded may also appear under **Guilds you can join**. Joins, leaves and requests reach the other player's page right away through notifications.

## 사용하는 GS2 서비스

- [GS2-Guild](/ko/microservices/guild/): GS2-Guild defines the guild kind `adventurers` (room for 5, up to 10, one guild per player) with two roles, master and member, and holds the guilds, their members and join requests. The master acts as the guild and can only answer requests, hand over and disband, as the master role's policy allows.

## GS2 Studio에서 사용하기

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

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

- Owner: `gs2io`
- Repository: `gs2-studio-package`
- Subdirectory: `foundation-social-guild/packages/foundation-social-guild`

## 소스 코드

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



