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

# GS2-Inventory Buff 레퍼런스

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




**ℹ️ Note**

버프 엔트리 모델에 대한 자세한 내용은 [BuffEntryModel](api_reference/buff/master_data/#buffentrymodel)을 참조해 주세요.

## Models
버프 적용 가능한 모델의 종류

### Gs2Inventory:Inventory
인벤토리


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

##### currentInventoryMaxCapacity


|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| currentInventoryMaxCapacity | int |  | ✓|  | 1 ~ 2147483646 | 최대 용량<br>이 사용자가 사용할 수 있는 인벤토리 슬롯의 현재 최대 수입니다. 인벤토리 모델의 initialCapacity로 초기화되며, 입수 액션 또는 직접적인 API 호출을 통해 모델의 maxCapacity까지 확장할 수 있습니다. |


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

`rate`에는 대상 필드에 대한 보정 배율을 지정합니다.


**JSON**
```json
"targetModel": {
    "targetModelName": "Gs2Inventory:Inventory",
    "targetFieldName": "currentInventoryMaxCapacity",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```



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

##### Gs2Inventory:InventoryModel


인벤토리 모델


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Inventory:InventoryModel",
        "targetGrn": "grn:gs2:any:any:inventory:{namespaceName}:model:{inventoryName}"
    }
]
```


---
## Action
버프 적용 가능한 액션의 종류

### Gs2Inventory:AcquireItemSetByUserId
사용자 ID를 지정하여 아이템 세트 입수<br>

사용자의 인벤토리에 아이템을 추가합니다. 기존 아이템 세트에 여유(스택 제한 미만)가 있는 경우 그곳에 추가되며, 그렇지 않은 경우 복수 스택이 허용되어 있으면 새로운 아이템 세트가 생성됩니다.<br>
선택적으로 expiresAt을 지정하여 새로 생성되는 아이템 세트의 유효기간을 설정할 수 있습니다. 유효기간이 이미 지난 아이템은 빈 것으로 취급됩니다.<br>
createNewItemSet이 true인 경우, 기존 세트에 여유가 있어도 항상 새로운 아이템 세트가 생성됩니다.<br>
합계 수량이 인벤토리 용량을 초과하는 경우 오버플로우 수량이 반환되며, 네임스페이스 설정에 따라 오버플로우분이 GS2-Inbox로 전송될 수 있습니다.


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

##### acquireCount


[ItemSet - 아이템 세트](../sdk#itemset)



|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| acquireCount | long |  | ✓|  | 1 ~ 9223372036854775805 | 입수하는 양 |


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



**JSON**
```json
"targetAction": {
    "targetActionName": "Gs2Inventory:AcquireItemSetByUserId",
    "targetFieldName": "acquireCount",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```

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

##### Gs2Inventory:InventoryModel


인벤토리 모델


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Inventory:InventoryModel",
        "targetGrn": "grn:gs2:{region}:{ownerId}:inventory:{namespaceName}:model:{inventoryName}"
    }
]
```


##### Gs2Inventory:ItemModel


아이템 모델


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Inventory:ItemModel",
        "targetGrn": "grn:gs2:{region}:{ownerId}:inventory:{namespaceName}:model:{inventoryName}:item:{itemName}"
    }
]
```



---

### Gs2Inventory:ConsumeItemSet
아이템 세트를 소비<br>

요청 사용자의 인벤토리 내 지정된 아이템의 수량을 감소시킵니다.<br>
itemSetName을 지정하면 해당 특정 스택만 소비 대상이 됩니다. 지정하지 않으면 해당 아이템 타입의 모든 스택에서 소비됩니다.<br>
아이템 세트의 수량이 0이 되면 자동으로 삭제됩니다.<br>
요청된 양을 소비하기에 충분한 아이템이 없는 경우 Insufficient 에러가 반환됩니다.


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

##### consumeCount


[ItemSet - 아이템 세트](../sdk#itemset)



|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| consumeCount | long |  | ✓|  | 1 ~ 9223372036854775805 | 소비 수량 |


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



**JSON**
```json
"targetAction": {
    "targetActionName": "Gs2Inventory:ConsumeItemSet",
    "targetFieldName": "consumeCount",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```

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

##### Gs2Inventory:InventoryModel


인벤토리 모델


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Inventory:InventoryModel",
        "targetGrn": "grn:gs2:{region}:{ownerId}:inventory:{namespaceName}:model:{inventoryName}"
    }
]
```


##### Gs2Inventory:ItemModel


아이템 모델


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Inventory:ItemModel",
        "targetGrn": "grn:gs2:{region}:{ownerId}:inventory:{namespaceName}:model:{inventoryName}:item:{itemName}"
    }
]
```



---

### Gs2Inventory:ConsumeItemSetByUserId
사용자 ID를 지정하여 아이템 세트를 소비<br>

지정된 사용자의 인벤토리 내 특정 아이템의 수량을 감소시킵니다.<br>
itemSetName을 지정하면 해당 특정 스택만 소비 대상이 됩니다. 지정하지 않으면 해당 아이템 타입의 모든 스택에서 소비됩니다.<br>
아이템 세트의 수량이 0이 되면 자동으로 삭제됩니다.<br>
충분한 아이템이 없는 경우 Insufficient 에러가 반환됩니다.


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

##### consumeCount


[ItemSet - 아이템 세트](../sdk#itemset)



|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| consumeCount | long |  | ✓|  | 1 ~ 9223372036854775805 | 소비 수량 |


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



**JSON**
```json
"targetAction": {
    "targetActionName": "Gs2Inventory:ConsumeItemSetByUserId",
    "targetFieldName": "consumeCount",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```

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

##### Gs2Inventory:InventoryModel


인벤토리 모델


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Inventory:InventoryModel",
        "targetGrn": "grn:gs2:{region}:{ownerId}:inventory:{namespaceName}:model:{inventoryName}"
    }
]
```


##### Gs2Inventory:ItemModel


아이템 모델


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Inventory:ItemModel",
        "targetGrn": "grn:gs2:{region}:{ownerId}:inventory:{namespaceName}:model:{inventoryName}:item:{itemName}"
    }
]
```



---

### Gs2Inventory:AcquireSimpleItemsByUserId
사용자 ID를 지정하여 심플 아이템 입수<br>

입수 수량의 배치를 사용하여 사용자의 심플 인벤토리에 아이템을 추가합니다.<br>
단일 원자적 작업으로 여러 아이템을 입수할 수 있습니다. acquireCounts 배열로 각 아이템의 이름과 수량을 지정합니다.<br>
일반적인 아이템 세트와 달리, 심플 아이템에는 용량 제한, 스택 제한, 유효기간이 없습니다.


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

##### acquireCounts


[SimpleItem - 심플 아이템](../sdk#simpleitem)



|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| acquireCounts | [List&lt;AcquireCount&gt;](#acquirecount) |  | ✓|  | 1 ~ 100 items | 심플 아이템의 입수 수량 리스트 |


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



**JSON**
```json
"targetAction": {
    "targetActionName": "Gs2Inventory:AcquireSimpleItemsByUserId",
    "targetFieldName": "acquireCounts",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```

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

##### Gs2Inventory:SimpleInventoryModel


심플 인벤토리 모델


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Inventory:SimpleInventoryModel",
        "targetGrn": "grn:gs2:{region}:{ownerId}:inventory:{namespaceName}:simple:model:{inventoryName}"
    }
]
```


##### Gs2Inventory:SimpleItemModel


심플 아이템 모델


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Inventory:SimpleItemModel",
        "targetGrn": "grn:gs2:{region}:{ownerId}:inventory:{namespaceName}:simple:model:{inventoryName}:item:{itemName}"
    }
]
```



---

### Gs2Inventory:ConsumeSimpleItems
심플 아이템 소비<br>

소비 수량의 배치를 사용하여 요청 사용자의 심플 인벤토리 내 아이템 수량을 감소시킵니다.<br>
단일 원자적 작업으로 여러 아이템을 소비할 수 있습니다. 어느 하나의 아이템 수량이라도 부족한 경우, 작업 전체가 실패합니다.<br>
지정된 아이템 중 하나라도 충분하지 않은 경우, Insufficient 오류가 반환됩니다.


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

##### consumeCounts


[SimpleItem - 심플 아이템](../sdk#simpleitem)



|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| consumeCounts | [List&lt;ConsumeCount&gt;](#consumecount) |  | ✓|  | 1 ~ 100 items | 심플 아이템의 소비 수량 리스트 |


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



**JSON**
```json
"targetAction": {
    "targetActionName": "Gs2Inventory:ConsumeSimpleItems",
    "targetFieldName": "consumeCounts",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```

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

##### Gs2Inventory:SimpleInventoryModel


심플 인벤토리 모델


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Inventory:SimpleInventoryModel",
        "targetGrn": "grn:gs2:{region}:{ownerId}:inventory:{namespaceName}:simple:model:{inventoryName}"
    }
]
```


##### Gs2Inventory:SimpleItemModel


심플 아이템 모델


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Inventory:SimpleItemModel",
        "targetGrn": "grn:gs2:{region}:{ownerId}:inventory:{namespaceName}:simple:model:{inventoryName}:item:{itemName}"
    }
]
```



---

### Gs2Inventory:ConsumeSimpleItemsByUserId
사용자 ID를 지정하여 심플 아이템 소비<br>

소비 수량의 배치를 사용하여 지정된 사용자의 심플 인벤토리 내 아이템 수량을 감소시킵니다.<br>
단일 원자적 작업으로 여러 아이템을 소비할 수 있습니다. 어느 하나의 아이템 수량이라도 부족한 경우, 작업 전체가 실패합니다.


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

##### consumeCounts


[SimpleItem - 심플 아이템](../sdk#simpleitem)



|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| consumeCounts | [List&lt;ConsumeCount&gt;](#consumecount) |  | ✓|  | 1 ~ 100 items | 심플 아이템의 소비 수량 리스트 |


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



**JSON**
```json
"targetAction": {
    "targetActionName": "Gs2Inventory:ConsumeSimpleItemsByUserId",
    "targetFieldName": "consumeCounts",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```

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

##### Gs2Inventory:SimpleInventoryModel


심플 인벤토리 모델


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Inventory:SimpleInventoryModel",
        "targetGrn": "grn:gs2:{region}:{ownerId}:inventory:{namespaceName}:simple:model:{inventoryName}"
    }
]
```


##### Gs2Inventory:SimpleItemModel


심플 아이템 모델


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Inventory:SimpleItemModel",
        "targetGrn": "grn:gs2:{region}:{ownerId}:inventory:{namespaceName}:simple:model:{inventoryName}:item:{itemName}"
    }
]
```



---

### Gs2Inventory:AcquireBigItemByUserId
사용자 ID를 지정하여 거대 아이템 입수<br>

임의 정밀도 연산을 사용하여 사용자의 거대 아이템 수량에 지정된 수량을 가산합니다.<br>
acquireCount는 최대 1024자리의 유효한 정수 문자열이어야 하며, 형식이 올바르지 않으면 오류가 발생합니다.<br>
아이템이 아직 존재하지 않는 경우 자동으로 생성됩니다.<br>
네임스페이스 설정을 통해 거대 아이템 입수 시 커스텀 로직을 실행하는 GS2-Script를 설정할 수 있습니다.


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

##### acquireCount


[BigItem - 거대 아이템](../sdk#bigitem)



|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| acquireCount | string |  | ✓|  |  ~ 1024자 | 거대 아이템의 입수 수량<br>최대 1024자리까지의 정수값 문자열 |


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



**JSON**
```json
"targetAction": {
    "targetActionName": "Gs2Inventory:AcquireBigItemByUserId",
    "targetFieldName": "acquireCount",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```

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

##### Gs2Inventory:BigInventoryModel


거대 인벤토리 모델


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Inventory:BigInventoryModel",
        "targetGrn": "grn:gs2:{region}:{ownerId}:inventory:{namespaceName}:big:model:{inventoryName}"
    }
]
```


##### Gs2Inventory:BigItemModel


거대 아이템 모델


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Inventory:BigItemModel",
        "targetGrn": "grn:gs2:{region}:{ownerId}:inventory:{namespaceName}:big:model:{inventoryName}:item:{itemName}"
    }
]
```



---

### Gs2Inventory:ConsumeBigItem
거대 아이템 소비<br>

임의 정밀도 연산을 사용하여 요청 사용자의 거대 아이템 수량에서 지정된 수량을 감산합니다.<br>
consumeCount는 최대 1024자리의 유효한 정수 문자열이어야 합니다.<br>
현재 수량이 부족한 경우 Insufficient 오류가 반환되며, 감산은 이루어지지 않습니다.<br>
네임스페이스 설정을 통해 거대 아이템 소비 시 커스텀 로직을 실행하는 GS2-Script를 설정할 수 있습니다.


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

##### consumeCount


[BigItem - 거대 아이템](../sdk#bigitem)



|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| consumeCount | string |  | ✓|  |  ~ 1024자 | 거대 아이템의 소비 수량<br>최대 1024자리까지의 정수값 문자열 |


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



**JSON**
```json
"targetAction": {
    "targetActionName": "Gs2Inventory:ConsumeBigItem",
    "targetFieldName": "consumeCount",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```

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

##### Gs2Inventory:BigInventoryModel


거대 인벤토리 모델


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Inventory:BigInventoryModel",
        "targetGrn": "grn:gs2:{region}:{ownerId}:inventory:{namespaceName}:big:model:{inventoryName}"
    }
]
```


##### Gs2Inventory:BigItemModel


거대 아이템 모델


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Inventory:BigItemModel",
        "targetGrn": "grn:gs2:{region}:{ownerId}:inventory:{namespaceName}:big:model:{inventoryName}:item:{itemName}"
    }
]
```



---

### Gs2Inventory:ConsumeBigItemByUserId
사용자 ID를 지정하여 거대 아이템 소비<br>

임의 정밀도 연산을 사용하여 지정 사용자의 거대 아이템 수량에서 지정된 수량을 감산합니다.<br>
consumeCount는 최대 1024자리의 유효한 정수 문자열이어야 합니다.<br>
현재 수량이 부족한 경우 Insufficient 오류가 반환되며, 감산은 이루어지지 않습니다.<br>
네임스페이스 설정을 통해 거대 아이템 소비 시 커스텀 로직을 실행하는 GS2-Script를 설정할 수 있습니다.


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

##### consumeCount


[BigItem - 거대 아이템](../sdk#bigitem)



|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| consumeCount | string |  | ✓|  |  ~ 1024자 | 거대 아이템의 소비 수량<br>최대 1024자리까지의 정수값 문자열 |


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



**JSON**
```json
"targetAction": {
    "targetActionName": "Gs2Inventory:ConsumeBigItemByUserId",
    "targetFieldName": "consumeCount",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```

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

##### Gs2Inventory:BigInventoryModel


거대 인벤토리 모델


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Inventory:BigInventoryModel",
        "targetGrn": "grn:gs2:{region}:{ownerId}:inventory:{namespaceName}:big:model:{inventoryName}"
    }
]
```


##### Gs2Inventory:BigItemModel


거대 아이템 모델


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Inventory:BigItemModel",
        "targetGrn": "grn:gs2:{region}:{ownerId}:inventory:{namespaceName}:big:model:{inventoryName}:item:{itemName}"
    }
]
```



---