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

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

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



## 트리거

### createAccount



**관련 메서드:**
createAccount - 게임 플레이어 계정을 신규 생성


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

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

##### Request

| | 타입 | 설명 |
| --- | --- | --- |
| namespace | [Namespace](../sdk/#namespace) | 네임스페이스 |
| account | [Account](../sdk/#account) | 게임 플레이어 계정 |

##### Result

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

##### 구현 예제


**Lua**
```lua

-- Request
local namespace = args.namespace
local account = args.account

-- Business logic:
local permit = true

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


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

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

##### Request

| | 타입 | 설명 |
| --- | --- | --- |
| namespace | [Namespace](../sdk/#namespace) | 네임스페이스 |
| account | [Account](../sdk/#account) | 게임 플레이어 계정 |


##### 구현 예제


**Lua**
```lua

-- Request
local namespace = args.namespace
local account = args.account

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

result = {
}
```


---
  
### authentication



**관련 메서드:**
authentication - 게임 플레이어 계정을 인증


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

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

##### Request

| | 타입 | 설명 |
| --- | --- | --- |
| namespace | [Namespace](../sdk/#namespace) | 네임스페이스 |
| account | [Account](../sdk/#account) | 게임 플레이어 계정 |
| elapsedHours | int | 마지막 로그인으로부터 경과 시간 |

##### Result

|  | 타입 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- |
| permit | bool | ✓ |  |  | 계정 인증을 허용할지 여부 |
| force | bool |  | false |  | 비밀번호 인증에 실패해도 인증을 통과시킬지 여부 |

##### 구현 예제


**Lua**
```lua

-- Request
local namespace = args.namespace
local account = args.account
local elapsedHours = args.elapsedHours

-- Business logic:
local permit = true
local force = false

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


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

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

##### Request

| | 타입 | 설명 |
| --- | --- | --- |
| namespace | [Namespace](../sdk/#namespace) | 네임스페이스 |
| account | [Account](../sdk/#account) | 게임 플레이어 계정 |
| elapsedHours | int | 마지막 로그인으로부터 경과 시간 |


##### 구현 예제


**Lua**
```lua

-- Request
local namespace = args.namespace
local account = args.account
local elapsedHours = args.elapsedHours

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

result = {
}
```


---
  
### ban



**관련 메서드:**
addBan - 게임 플레이어 계정에 계정 BAN 상태를 추가


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

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

##### Request

| | 타입 | 설명 |
| --- | --- | --- |
| namespace | [Namespace](../sdk/#namespace) | 네임스페이스 |
| account | [Account](../sdk/#account) | 게임 플레이어 계정 |
| addBanStatus | [BanStatus](../sdk/#banstatus) | 추가할 계정 BAN 상태 |

##### Result

|  | 타입 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- |
| permit | bool | ✓ |  |  | 계정 BAN 등록을 허용할지 여부 |

##### 구현 예제


**Lua**
```lua

-- Request
local namespace = args.namespace
local account = args.account
local addBanStatus = args.addBanStatus

-- Business logic:
local permit = true

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


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

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

##### Request

| | 타입 | 설명 |
| --- | --- | --- |
| namespace | [Namespace](../sdk/#namespace) | 네임스페이스 |
| account | [Account](../sdk/#account) | 게임 플레이어 계정 |
| addBanStatus | [BanStatus](../sdk/#banstatus) | 추가할 계정 BAN 상태 |


##### 구현 예제


**Lua**
```lua

-- Request
local namespace = args.namespace
local account = args.account
local addBanStatus = args.addBanStatus

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

result = {
}
```


---
  
### unBan



**관련 메서드:**
updateBanned - 게임 플레이어 계정의 계정 BAN 상태를 갱신
removeBan - 게임 플레이어 계정의 계정 BAN 상태를 삭제
authentication - 게임 플레이어 계정을 인증


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

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

##### Request

| | 타입 | 설명 |
| --- | --- | --- |
| namespace | [Namespace](../sdk/#namespace) | 네임스페이스 |
| account | [Account](../sdk/#account) | 게임 플레이어 계정 |

##### Result

|  | 타입 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- |
| permit | bool | ✓ |  |  | 계정 BAN 해제를 허용할지 여부 |

##### 구현 예제


**Lua**
```lua

-- Request
local namespace = args.namespace
local account = args.account

-- Business logic:
local permit = true

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


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

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

##### Request

| | 타입 | 설명 |
| --- | --- | --- |
| namespace | [Namespace](../sdk/#namespace) | 네임스페이스 |
| account | [Account](../sdk/#account) | 게임 플레이어 계정 |


##### 구현 예제


**Lua**
```lua

-- Request
local namespace = args.namespace
local account = args.account

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

result = {
}
```


---
  
### createTakeOver



**관련 메서드:**
createTakeOver - 인계 정보를 신규 작성


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

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

##### Request

| | 타입 | 설명 |
| --- | --- | --- |
| namespace | [Namespace](../sdk/#namespace) | 네임스페이스 |
| takeOver | [TakeOver](../sdk/#takeover) | 인계 정보 |
| account | [Account](../sdk/#account) | 게임 플레이어 계정 |

##### Result

|  | 타입 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- |
| permit | bool | ✓ |  |  | 인계 정보 등록을 허용할지 여부 |

##### 구현 예제


**Lua**
```lua

-- Request
local namespace = args.namespace
local takeOver = args.takeOver
local account = args.account

-- Business logic:
local permit = true

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


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

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

##### Request

| | 타입 | 설명 |
| --- | --- | --- |
| namespace | [Namespace](../sdk/#namespace) | 네임스페이스 |
| takeOver | [TakeOver](../sdk/#takeover) | 인계 정보 |
| account | [Account](../sdk/#account) | 게임 플레이어 계정 |


##### 구현 예제


**Lua**
```lua

-- Request
local namespace = args.namespace
local takeOver = args.takeOver
local account = args.account

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

result = {
}
```


---
  
### doTakeOver



**관련 메서드:**
doTakeOver - 인계를 실행


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

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

##### Request

| | 타입 | 설명 |
| --- | --- | --- |
| namespace | [Namespace](../sdk/#namespace) | 네임스페이스 |
| account | [Account](../sdk/#account) | 게임 플레이어 계정 |
| takeOver | [TakeOver](../sdk/#takeover) | 인계 정보 |

##### Result

|  | 타입 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- |
| permit | bool | ✓ |  |  | 인계 실행을 허용할지 여부 |
| force | bool |  | false |  | 비밀번호 인증에 실패해도 인증을 통과시킬지 여부 |

##### 구현 예제


**Lua**
```lua

-- Request
local namespace = args.namespace
local account = args.account
local takeOver = args.takeOver

-- Business logic:
local permit = true
local force = false

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


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

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

##### Request

| | 타입 | 설명 |
| --- | --- | --- |
| namespace | [Namespace](../sdk/#namespace) | 네임스페이스 |
| account | [Account](../sdk/#account) | 게임 플레이어 계정 |
| takeOver | [TakeOver](../sdk/#takeover) | 인계 정보 |


##### 구현 예제


**Lua**
```lua

-- Request
local namespace = args.namespace
local account = args.account
local takeOver = args.takeOver

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

result = {
}
```


---