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

# GS2-Guild 스크립트 트리거 레퍼런스

확장 스크립트를 호출하는 이벤트 트리거의 레퍼런스



## 트리거

### createGuild



**관련 메서드:**
createGuild - 길드 신규 생성


#### 동기 실행 스크립트

 처리 전에, 스크립트가 동기 실행됩니다.

##### Request

| | 타입 | 설명 |
| --- | --- | --- |
| namespace | [Namespace](../sdk/#namespace) | 네임스페이스 |
| guildModel | [GuildModel](../sdk/#guildmodel) | 길드 모델 |
| guild | [Guild](../sdk/#guild) | 길드 |

##### Result

|  | 타입 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- |
| permit | bool | ✓ |  |  | 길드 작성을 허용할지 여부 |

##### 구현 예제


**Lua**
```lua

-- Request
local namespace = args.namespace
local guildModel = args.guildModel
local guild = args.guild

-- Business logic:
local permit = true

-- Result
result = {
  permit=permit
}
```


#### 비동기 실행 스크립트

 처리 후에, 스크립트가 비동기 실행됩니다.

##### Request

| | 타입 | 설명 |
| --- | --- | --- |
| namespace | [Namespace](../sdk/#namespace) | 네임스페이스 |
| guildModel | [GuildModel](../sdk/#guildmodel) | 길드 모델 |
| guild | [Guild](../sdk/#guild) | 길드 |


##### 구현 예제


**Lua**
```lua

-- Request
local namespace = args.namespace
local guildModel = args.guildModel
local guild = args.guild

-- 비동기 스크립트는 일반적으로 API 응답에 영향을 주지 않습니다.
-- 로그 출력이나 분석, 외부 알림 등에 사용됩니다.

result = {
}
```


---
  
### updateGuild



**관련 메서드:**
updateGuild - 길드 업데이트


#### 동기 실행 스크립트

 처리 전에, 스크립트가 동기 실행됩니다.

##### Request

| | 타입 | 설명 |
| --- | --- | --- |
| namespace | [Namespace](../sdk/#namespace) | 네임스페이스 |
| guildModel | [GuildModel](../sdk/#guildmodel) | 길드 모델 |
| oldGuild | [Guild](../sdk/#guild) | 갱신 전 길드 |
| newGuild | [Guild](../sdk/#guild) | 갱신 후 길드 |

##### Result

|  | 타입 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- |
| permit | bool | ✓ |  |  | 길드 갱신을 허용할지 여부 |

##### 구현 예제


**Lua**
```lua

-- Request
local namespace = args.namespace
local guildModel = args.guildModel
local oldGuild = args.oldGuild
local newGuild = args.newGuild

-- Business logic:
local permit = true

-- Result
result = {
  permit=permit
}
```


#### 비동기 실행 스크립트

 처리 후에, 스크립트가 비동기 실행됩니다.

##### Request

| | 타입 | 설명 |
| --- | --- | --- |
| namespace | [Namespace](../sdk/#namespace) | 네임스페이스 |
| guildModel | [GuildModel](../sdk/#guildmodel) | 길드 모델 |
| oldGuild | [Guild](../sdk/#guild) | 갱신 전 길드 |
| newGuild | [Guild](../sdk/#guild) | 갱신 후 길드 |


##### 구현 예제


**Lua**
```lua

-- Request
local namespace = args.namespace
local guildModel = args.guildModel
local oldGuild = args.oldGuild
local newGuild = args.newGuild

-- 비동기 스크립트는 일반적으로 API 응답에 영향을 주지 않습니다.
-- 로그 출력이나 분석, 외부 알림 등에 사용됩니다.

result = {
}
```


---
  
### joinGuild



**관련 메서드:**
acceptRequest - 참가 요청 수락
acceptRequestByGuildName - 길드 이름을 지정하여 참가 요청 수락
sendRequest - 참가 요청 전송
sendRequestByUserId - 사용자 ID를 지정하여 참가 요청 전송


#### 동기 실행 스크립트

 처리 전에, 스크립트가 동기 실행됩니다.

##### Request

| | 타입 | 설명 |
| --- | --- | --- |
| namespace | [Namespace](../sdk/#namespace) | 네임스페이스 |
| guildModel | [GuildModel](../sdk/#guildmodel) | 길드 모델 |
| guild | [Guild](../sdk/#guild) | 길드 |
| userId | string | 사용자 ID |

##### Result

|  | 타입 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- |
| permit | bool | ✓ |  |  | 길드 참가를 허용할지 여부 |

##### 구현 예제


**Lua**
```lua

-- Request
local namespace = args.namespace
local guildModel = args.guildModel
local guild = args.guild
local userId = args.userId

-- Business logic:
local permit = true

-- Result
result = {
  permit=permit
}
```


#### 비동기 실행 스크립트

 처리 후에, 스크립트가 비동기 실행됩니다.

##### Request

| | 타입 | 설명 |
| --- | --- | --- |
| namespace | [Namespace](../sdk/#namespace) | 네임스페이스 |
| guildModel | [GuildModel](../sdk/#guildmodel) | 길드 모델 |
| guild | [Guild](../sdk/#guild) | 길드 |
| userId | string | 사용자 ID |


##### 구현 예제


**Lua**
```lua

-- Request
local namespace = args.namespace
local guildModel = args.guildModel
local guild = args.guild
local userId = args.userId

-- 비동기 스크립트는 일반적으로 API 응답에 영향을 주지 않습니다.
-- 로그 출력이나 분석, 외부 알림 등에 사용됩니다.

result = {
}
```


---
  
### leaveGuild



**관련 메서드:**
deleteMember - 멤버 제명
deleteMemberByGuildName - 길드 이름을 지정하여 멤버 제명


#### 동기 실행 스크립트

 처리 전에, 스크립트가 동기 실행됩니다.

##### Request

| | 타입 | 설명 |
| --- | --- | --- |
| namespace | [Namespace](../sdk/#namespace) | 네임스페이스 |
| guildModel | [GuildModel](../sdk/#guildmodel) | 길드 모델 |
| guild | [Guild](../sdk/#guild) | 길드 |
| userId | string | 사용자 ID |
| self | bool | 스스로 탈퇴했는지 / 길드 마스터에 의해 탈퇴당했는지, 길드가 해산되었을 때 false가 됩니다 |

##### Result

|  | 타입 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- |
| permit | bool | ✓ |  |  | 길드 탈퇴를 허용할지 여부 |

##### 구현 예제


**Lua**
```lua

-- Request
local namespace = args.namespace
local guildModel = args.guildModel
local guild = args.guild
local userId = args.userId
local self = args.self

-- Business logic:
local permit = true

-- Result
result = {
  permit=permit
}
```


#### 비동기 실행 스크립트

 처리 후에, 스크립트가 비동기 실행됩니다.

##### Request

| | 타입 | 설명 |
| --- | --- | --- |
| namespace | [Namespace](../sdk/#namespace) | 네임스페이스 |
| guildModel | [GuildModel](../sdk/#guildmodel) | 길드 모델 |
| guild | [Guild](../sdk/#guild) | 길드 |
| userId | string | 사용자 ID |
| self | bool | 스스로 탈퇴했는지 / 길드 마스터에 의해 탈퇴당했는지, 길드가 해산되었을 때 false가 됩니다 |


##### 구현 예제


**Lua**
```lua

-- Request
local namespace = args.namespace
local guildModel = args.guildModel
local guild = args.guild
local userId = args.userId
local self = args.self

-- 비동기 스크립트는 일반적으로 API 응답에 영향을 주지 않습니다.
-- 로그 출력이나 분석, 외부 알림 등에 사용됩니다.

result = {
}
```


---
  
### changeRole



**관련 메서드:**
updateMemberRole - 멤버 역할 업데이트
updateMemberRoleByGuildName - 길드 이름을 지정하여 멤버 역할 업데이트


#### 동기 실행 스크립트

 처리 전에, 스크립트가 동기 실행됩니다.

##### Request

| | 타입 | 설명 |
| --- | --- | --- |
| namespace | [Namespace](../sdk/#namespace) | 네임스페이스 |
| guildModel | [GuildModel](../sdk/#guildmodel) | 길드 모델 |
| guild | [Guild](../sdk/#guild) | 길드 |
| oldMembers | [Member[]](../sdk/#member) | 갱신 전 멤버 정보 |
| newMembers | [Member[]](../sdk/#member) | 갱신 후 멤버 정보 |

##### Result

|  | 타입 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- |
| permit | bool | ✓ |  |  | 역할 변경을 허용할지 여부 |

##### 구현 예제


**Lua**
```lua

-- Request
local namespace = args.namespace
local guildModel = args.guildModel
local guild = args.guild
local oldMembers = args.oldMembers
local newMembers = args.newMembers

-- Business logic:
local permit = true

-- Result
result = {
  permit=permit
}
```


#### 비동기 실행 스크립트

 처리 후에, 스크립트가 비동기 실행됩니다.

##### Request

| | 타입 | 설명 |
| --- | --- | --- |
| namespace | [Namespace](../sdk/#namespace) | 네임스페이스 |
| guildModel | [GuildModel](../sdk/#guildmodel) | 길드 모델 |
| guild | [Guild](../sdk/#guild) | 길드 |
| oldMembers | [Member[]](../sdk/#member) | 갱신 전 멤버 정보 |
| newMembers | [Member[]](../sdk/#member) | 갱신 후 멤버 정보 |


##### 구현 예제


**Lua**
```lua

-- Request
local namespace = args.namespace
local guildModel = args.guildModel
local guild = args.guild
local oldMembers = args.oldMembers
local newMembers = args.newMembers

-- 비동기 스크립트는 일반적으로 API 응답에 영향을 주지 않습니다.
-- 로그 출력이나 분석, 외부 알림 등에 사용됩니다.

result = {
}
```


---
  
### deleteGuild



**관련 메서드:**
deleteGuild - 길드 삭제


#### 동기 실행 스크립트

 처리 전에, 스크립트가 동기 실행됩니다.

##### Request

| | 타입 | 설명 |
| --- | --- | --- |
| namespace | [Namespace](../sdk/#namespace) | 네임스페이스 |
| guildModel | [GuildModel](../sdk/#guildmodel) | 길드 모델 |
| guild | [Guild](../sdk/#guild) | 길드 |

##### Result

|  | 타입 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- |
| permit | bool | ✓ |  |  | 길드 삭제를 허용할지 여부 |

##### 구현 예제


**Lua**
```lua

-- Request
local namespace = args.namespace
local guildModel = args.guildModel
local guild = args.guild

-- Business logic:
local permit = true

-- Result
result = {
  permit=permit
}
```


#### 비동기 실행 스크립트

 처리 후에, 스크립트가 비동기 실행됩니다.

##### Request

| | 타입 | 설명 |
| --- | --- | --- |
| namespace | [Namespace](../sdk/#namespace) | 네임스페이스 |
| guildModel | [GuildModel](../sdk/#guildmodel) | 길드 모델 |
| guild | [Guild](../sdk/#guild) | 길드 |


##### 구현 예제


**Lua**
```lua

-- Request
local namespace = args.namespace
local guildModel = args.guildModel
local guild = args.guild

-- 비동기 스크립트는 일반적으로 API 응답에 영향을 주지 않습니다.
-- 로그 출력이나 분석, 외부 알림 등에 사용됩니다.

result = {
}
```


---
  
### receiveJoinRequest



**관련 메서드:**
sendRequest - 참가 요청 전송
sendRequestByUserId - 사용자 ID를 지정하여 참가 요청 전송


#### 동기 실행 스크립트

 처리 전에, 스크립트가 동기 실행됩니다.

##### Request

| | 타입 | 설명 |
| --- | --- | --- |
| namespace | [Namespace](../sdk/#namespace) | 네임스페이스 |
| guildModel | [GuildModel](../sdk/#guildmodel) | 길드 모델 |
| guild | [Guild](../sdk/#guild) | 길드 |
| receiveMemberRequest | [ReceiveMemberRequest](../sdk/#receivememberrequest) | 참가 요청 |

##### Result

|  | 타입 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- |
| permit | bool | ✓ |  |  | 길드 참가 요청 수신을 허용할지 여부 |

##### 구현 예제


**Lua**
```lua

-- Request
local namespace = args.namespace
local guildModel = args.guildModel
local guild = args.guild
local receiveMemberRequest = args.receiveMemberRequest

-- Business logic:
local permit = true

-- Result
result = {
  permit=permit
}
```


#### 비동기 실행 스크립트

 처리 후에, 스크립트가 비동기 실행됩니다.

##### Request

| | 타입 | 설명 |
| --- | --- | --- |
| namespace | [Namespace](../sdk/#namespace) | 네임스페이스 |
| guildModel | [GuildModel](../sdk/#guildmodel) | 길드 모델 |
| guild | [Guild](../sdk/#guild) | 길드 |
| receiveMemberRequest | [ReceiveMemberRequest](../sdk/#receivememberrequest) | 참가 요청 |


##### 구현 예제


**Lua**
```lua

-- Request
local namespace = args.namespace
local guildModel = args.guildModel
local guild = args.guild
local receiveMemberRequest = args.receiveMemberRequest

-- 비동기 스크립트는 일반적으로 API 응답에 영향을 주지 않습니다.
-- 로그 출력이나 분석, 외부 알림 등에 사용됩니다.

result = {
}
```


---