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

# GS2-Matchmaking スクリプト トリガー リファレンス

拡張スクリプトを呼び出すイベントトリガーのリファレンス



## トリガー

### createGathering

ギャザリング新規作成
**関連するメソッド:**
createGathering - ギャザリングを作成して募集を開始


#### 同期実行スクリプト

ギャザリング新規作成処理の前に、スクリプトが同期実行されます。

##### Request

| | 型 | 説明 |
| --- | --- | --- |
| namespace | [Namespace](../sdk/#namespace) | ネームスペース |
| gathering | [Gathering](../sdk/#gathering) | ギャザリング |


##### 実装例


**Lua**
```lua

-- Request
local namespace = args.namespace
local gathering = args.gathering

-- Business logic:

-- Result
result = {
}
```


---
  
### completeMatchmaking

マッチメイキング完了
**関連するメソッド:**
earlyComplete - マッチメイキングを早期終了する
earlyCompleteByUserId - ユーザーIDを指定してマッチメイキングを早期終了する


#### 同期実行スクリプト

マッチメイキング完了処理の前に、スクリプトが同期実行されます。

##### Request

| | 型 | 説明 |
| --- | --- | --- |
| namespace | [Namespace](../sdk/#namespace) | ネームスペース |
| gathering | [Gathering](../sdk/#gathering) | ギャザリング |


##### 実装例


**Lua**
```lua

-- Request
local namespace = args.namespace
local gathering = args.gathering

-- Business logic:

-- Result
result = {
}
```


---
  
### changeRating

レーティングの値変化
**関連するメソッド:**
putResult - レーティング値の再計算を実行


#### 同期実行スクリプト

レーティングの値変化処理の前に、スクリプトが同期実行されます。

##### Request

| | 型 | 説明 |
| --- | --- | --- |
| namespace | [Namespace](../sdk/#namespace) | ネームスペース |
| oldRating | [Rating](../sdk/#rating) | 更新前のレーティング |
| newRating | [Rating](../sdk/#rating) | 更新後のレーティング |

##### Result

|  | 型 | 必須 | デフォルト | 値の制限 | 説明 |
| --- | --- | --- | --- | --- | --- |
| permit | bool | ✓ |  |  | レーティングの値変化を許可するか |

##### 実装例


**Lua**
```lua

-- Request
local namespace = args.namespace
local oldRating = args.oldRating
local newRating = args.newRating

-- Business logic:
local permit = true

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


#### 非同期実行スクリプト

レーティングの値変化処理の後に、スクリプトが非同期実行されます。

##### Request

| | 型 | 説明 |
| --- | --- | --- |
| namespace | [Namespace](../sdk/#namespace) | ネームスペース |
| oldRating | [Rating](../sdk/#rating) | 更新前のレーティング |
| newRating | [Rating](../sdk/#rating) | 更新前のレーティング |


##### 実装例


**Lua**
```lua

-- Request
local namespace = args.namespace
local oldRating = args.oldRating
local newRating = args.newRating

-- 非同期スクリプトは通常、API のレスポンスには影響を与えません。
-- ログ出力や分析、外部通知などに使用します。

result = {
}
```


---