GS2-Inventory Buff 레퍼런스

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

Models

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

Gs2Inventory:Inventory

인벤토리

버프 적용 대상 필드

currentInventoryMaxCapacity

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

마스터 데이터 작성 예

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

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

버프 적용 조건 모델

Gs2Inventory:InventoryModel

인벤토리 모델

마스터 데이터 작성 예

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

Action

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

Gs2Inventory:AcquireItemSetByUserId

사용자 ID를 지정하여 아이템 세트 입수

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

버프 적용 대상 필드

acquireCount

ItemSet - 아이템 세트

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

마스터 데이터 작성 예

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

버프 적용 조건 모델

Gs2Inventory:InventoryModel

인벤토리 모델

마스터 데이터 작성 예

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

Gs2Inventory:ItemModel

아이템 모델

마스터 데이터 작성 예

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

Gs2Inventory:ConsumeItemSet

아이템 세트를 소비

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

버프 적용 대상 필드

consumeCount

ItemSet - 아이템 세트

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

마스터 데이터 작성 예

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

버프 적용 조건 모델

Gs2Inventory:InventoryModel

인벤토리 모델

마스터 데이터 작성 예

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

Gs2Inventory:ItemModel

아이템 모델

마스터 데이터 작성 예

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

Gs2Inventory:ConsumeItemSetByUserId

사용자 ID를 지정하여 아이템 세트를 소비

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

버프 적용 대상 필드

consumeCount

ItemSet - 아이템 세트

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

마스터 데이터 작성 예

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

버프 적용 조건 모델

Gs2Inventory:InventoryModel

인벤토리 모델

마스터 데이터 작성 예

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

Gs2Inventory:ItemModel

아이템 모델

마스터 데이터 작성 예

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

Gs2Inventory:AcquireSimpleItemsByUserId

사용자 ID를 지정하여 심플 아이템 입수

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

버프 적용 대상 필드

acquireCounts

SimpleItem - 심플 아이템

	타입	활성화 조건	필수	기본값	값 제한	설명
acquireCounts	List<AcquireCount>		✓		1 ~ 100 items	심플 아이템의 입수 수량 리스트

마스터 데이터 작성 예

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

버프 적용 조건 모델

Gs2Inventory:SimpleInventoryModel

심플 인벤토리 모델

마스터 데이터 작성 예

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

Gs2Inventory:SimpleItemModel

심플 아이템 모델

마스터 데이터 작성 예

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

Gs2Inventory:ConsumeSimpleItems

심플 아이템 소비

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

버프 적용 대상 필드

consumeCounts

SimpleItem - 심플 아이템

	타입	활성화 조건	필수	기본값	값 제한	설명
consumeCounts	List<ConsumeCount>		✓		1 ~ 100 items	심플 아이템의 소비 수량 리스트

마스터 데이터 작성 예

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

버프 적용 조건 모델

Gs2Inventory:SimpleInventoryModel

심플 인벤토리 모델

마스터 데이터 작성 예

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

Gs2Inventory:SimpleItemModel

심플 아이템 모델

마스터 데이터 작성 예

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

Gs2Inventory:ConsumeSimpleItemsByUserId

사용자 ID를 지정하여 심플 아이템 소비

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

버프 적용 대상 필드

consumeCounts

SimpleItem - 심플 아이템

	타입	활성화 조건	필수	기본값	값 제한	설명
consumeCounts	List<ConsumeCount>		✓		1 ~ 100 items	심플 아이템의 소비 수량 리스트

마스터 데이터 작성 예

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

버프 적용 조건 모델

Gs2Inventory:SimpleInventoryModel

심플 인벤토리 모델

마스터 데이터 작성 예

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

Gs2Inventory:SimpleItemModel

심플 아이템 모델

마스터 데이터 작성 예

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

Gs2Inventory:AcquireBigItemByUserId

사용자 ID를 지정하여 거대 아이템 입수

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

버프 적용 대상 필드

acquireCount

BigItem - 거대 아이템

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

마스터 데이터 작성 예

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

버프 적용 조건 모델

Gs2Inventory:BigInventoryModel

거대 인벤토리 모델

마스터 데이터 작성 예

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

Gs2Inventory:BigItemModel

거대 아이템 모델

마스터 데이터 작성 예

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

Gs2Inventory:ConsumeBigItem

거대 아이템 소비

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

버프 적용 대상 필드

consumeCount

BigItem - 거대 아이템

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

마스터 데이터 작성 예

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

버프 적용 조건 모델

Gs2Inventory:BigInventoryModel

거대 인벤토리 모델

마스터 데이터 작성 예

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

Gs2Inventory:BigItemModel

거대 아이템 모델

마스터 데이터 작성 예

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

Gs2Inventory:ConsumeBigItemByUserId

사용자 ID를 지정하여 거대 아이템 소비

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

버프 적용 대상 필드

consumeCount

BigItem - 거대 아이템

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

마스터 데이터 작성 예

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

버프 적용 조건 모델

Gs2Inventory:BigInventoryModel

거대 인벤토리 모델

마스터 데이터 작성 예

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

Gs2Inventory:BigItemModel

거대 아이템 모델

마스터 데이터 작성 예

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