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

# GS2-Money2 Buff 레퍼런스

GS2-Buff로 버프를 적용할 때 지정하는, 파라미터 보정이 가능한 모델/액션 내 필드와 그 적용 범위 설정에 대해




**ℹ️ Note**

버프 엔트리 모델에 대한 자세한 내용은 [BuffEntryModel](api_reference/buff/master_data/#buffentrymodel)을 참조해 주세요.
## Action
버프 적용 가능한 액션의 종류

### Gs2Money2:DepositByUserId
사용자 ID를 지정하여 지갑 잔액에 가산<br>

지정된 사용자의 지갑에 지정된 입금 트랜잭션을 추가합니다.<br>
각 입금 트랜잭션에 대해 이벤트 로그가 기록됩니다.


#### 버프 적용 대상 필드

##### count


[DepositTransaction - 입금 트랜잭션](../sdk#deposittransaction)



|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| count | int |  | ✓|  | 0 ~ 2147483646 | 과금 통화 수량<br>이 입금에서의 가상 통화 단위 수입니다. 지갑에서 출금되면 감소합니다. |


##### 마스터 데이터 작성 예



**JSON**
```json
"targetAction": {
    "targetActionName": "Gs2Money2:DepositByUserId",
    "targetFieldName": "count",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```

#### 버프 적용 조건 모델

##### Gs2Money2:Wallet


지갑


##### 마스터 데이터 작성 예


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Money2:Wallet",
        "targetGrn": "grn:gs2:{region}:{ownerId}:money2:{namespaceName}:user:{userId}:wallet:{slot}"
    }
]
```



---

### Gs2Money2:Withdraw
지갑에서 잔액 소비<br>

요청 사용자의 지갑에서 지정된 양의 통화를 소비합니다.<br>
paidOnly가 false인 경우 무상 통화가 먼저 소비되고, 그다음 유상 통화가 소비됩니다. paidOnly가 true인 경우 유상 통화만 소비됩니다.


#### 버프 적용 대상 필드

##### withdrawCount


[Wallet - 지갑](../sdk#wallet)



|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| withdrawCount | int |  | ✓|  | 1 ~ 2147483646 | 소비할 유료 통화 수량 |


##### 마스터 데이터 작성 예



**JSON**
```json
"targetAction": {
    "targetActionName": "Gs2Money2:Withdraw",
    "targetFieldName": "withdrawCount",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```

#### 버프 적용 조건 모델

##### Gs2Money2:Wallet


지갑


##### 마스터 데이터 작성 예


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Money2:Wallet",
        "targetGrn": "grn:gs2:{region}:{ownerId}:money2:{namespaceName}:user:{userId}:wallet:{slot}"
    }
]
```



---

### Gs2Money2:WithdrawByUserId
사용자 ID를 지정하여 지갑에서 잔액 소비<br>

지정된 사용자의 지갑에서 지정된 양의 통화를 소비합니다.<br>
paidOnly가 false인 경우 무상 통화가 먼저 소비되고, 그다음 유상 통화가 소비됩니다.


#### 버프 적용 대상 필드

##### withdrawCount


[Wallet - 지갑](../sdk#wallet)



|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| withdrawCount | int |  | ✓|  | 1 ~ 2147483646 | 소비할 유료 통화 수량 |


##### 마스터 데이터 작성 예



**JSON**
```json
"targetAction": {
    "targetActionName": "Gs2Money2:WithdrawByUserId",
    "targetFieldName": "withdrawCount",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```

#### 버프 적용 조건 모델

##### Gs2Money2:Wallet


지갑


##### 마스터 데이터 작성 예


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Money2:Wallet",
        "targetGrn": "grn:gs2:{region}:{ownerId}:money2:{namespaceName}:user:{userId}:wallet:{slot}"
    }
]
```



---



