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

# GS2-Money Buff 레퍼런스

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




**ℹ️ Note**

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

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

지정한 사용자의 지갑에 지정한 양의 통화를 추가합니다.<br>
가격이 0인 경우는 무료 통화로, 그 외의 경우는 유료 통화로 취급됩니다.


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

##### count


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



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


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



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

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

##### Gs2Money:Wallet


지갑


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


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



---

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

요청 사용자의 지갑에서 지정한 양의 통화를 소비합니다.<br>
paidOnly가 false인 경우, 무료 통화가 먼저 소비되고 그다음 유료 통화가 소비됩니다. paidOnly가 true인 경우, 유료 통화만 소비됩니다.<br>
응답에는 소비한 통화의 가격이 포함됩니다.


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

##### count


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



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


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



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

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

##### Gs2Money:Wallet


지갑


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


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



---

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

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


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

##### count


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



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


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



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

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

##### Gs2Money:Wallet


지갑


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


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



---