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

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

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



## トリガー
### apply
バフの適用
**関連するメソッド:**
applyBuff - バフを適用
applyBuffByUserId - ユーザーIDを指定してバフを適用


#### 同期実行スクリプト
バフの適用処理の前に、スクリプトが同期実行されます。

  

##### Request


| | 型 | 説明 |
| --- | --- | --- |
| namespace | [Namespace](../sdk/#namespace) | ネームスペース |
| buffEntryModel | [BuffEntryModel](../sdk/#buffentrymodel) | バフエントリーモデル |
| userId | string | ユーザーID |
##### Result

|  | 型 | 必須 | デフォルト | 値の制限 | 説明 |
| --- | --- | --- | --- | --- | --- |
| permit | bool | ✓ |  |  | バフの適用を許可するか |
| overrideBuffRate | float | ✓ |  | 0 ~ 100 | バフに適用する上書きレート (倍率) |

##### 実装例



**Lua**
```lua

-- Request
local namespace = args.namespace
local buffEntryModel = args.buffEntryModel
local userId = args.userId

-- Business logic:
local permit = true
local overrideBuffRate = 0

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

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

バフの適用処理の後に、スクリプトが非同期実行されます。
  

##### Request


| | 型 | 説明 |
| --- | --- | --- |
| namespace | [Namespace](../sdk/#namespace) | ネームスペース |
| buffEntryModel | [BuffEntryModel](../sdk/#buffentrymodel) | バフエントリーモデル |
| userId | string | ユーザーID |

##### 実装例



**Lua**
```lua

-- Request
local namespace = args.namespace
local buffEntryModel = args.buffEntryModel
local userId = args.userId

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

result = {
}
```


---