Documentation index for AI agents

GS2-Showcase Buff 레퍼런스

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

Models

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

Gs2Showcase:DisplayItem

진열 상품

버프 적용 대상 필드

acquireActions
타입활성화 조건필수기본값값 제한설명
acquireActionsList<AcquireAction>[]1 ~ 100 items획득 액션 리스트
구매 보상으로 리소스를 부여하는 액션입니다. 모든 소비 액션이 정상적으로 완료된 후에 실행됩니다.
마스터 데이터 작성 예

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

"targetModel": {
    "targetModelName": "Gs2Showcase:DisplayItem",
    "targetFieldName": "acquireActions",
    "conditionGrns": [
    ],
    "rate": 1.0
}

버프 적용 조건 모델

Gs2Showcase:Showcase

진열대

마스터 데이터 작성 예
"conditionGrns": [
    {
        "targetModelName": "Gs2Showcase:Showcase",
        "targetGrn": "grn:gs2:any:any:showcase:{namespaceName}:showcase:{showcaseName}"
    }
]
Gs2Showcase:DisplayItem

진열 상품

마스터 데이터 작성 예
"conditionGrns": [
    {
        "targetModelName": "Gs2Showcase:DisplayItem",
        "targetGrn": "grn:gs2:any:any:showcase:{namespaceName}:showcase:{showcaseName}:displayItem:{displayItemId}"
    }
]
verifyActions
타입활성화 조건필수기본값값 제한설명
verifyActionsList<VerifyAction>[]0 ~ 10 items검증 액션 리스트
구매 전에 실행되는 전제 조건 체크입니다. 모든 검증 액션이 성공한 후에 소비·획득 액션이 처리됩니다. 구매 자격 조건 체크에 사용할 수 있습니다.
마스터 데이터 작성 예

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

"targetModel": {
    "targetModelName": "Gs2Showcase:DisplayItem",
    "targetFieldName": "verifyActions",
    "conditionGrns": [
    ],
    "rate": 1.0
}

버프 적용 조건 모델

Gs2Showcase:Showcase

진열대

마스터 데이터 작성 예
"conditionGrns": [
    {
        "targetModelName": "Gs2Showcase:Showcase",
        "targetGrn": "grn:gs2:any:any:showcase:{namespaceName}:showcase:{showcaseName}"
    }
]
Gs2Showcase:DisplayItem

진열 상품

마스터 데이터 작성 예
"conditionGrns": [
    {
        "targetModelName": "Gs2Showcase:DisplayItem",
        "targetGrn": "grn:gs2:any:any:showcase:{namespaceName}:showcase:{showcaseName}:displayItem:{displayItemId}"
    }
]
consumeActions
타입활성화 조건필수기본값값 제한설명
consumeActionsList<ConsumeAction>[]0 ~ 10 items소비 액션 리스트
구매 대가로 리소스를 소비하는 액션입니다. 상품 그룹의 구매 횟수 제어를 위해 GS2-Limit의 CountUp 액션을 포함할 수 있습니다.
마스터 데이터 작성 예

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

"targetModel": {
    "targetModelName": "Gs2Showcase:DisplayItem",
    "targetFieldName": "consumeActions",
    "conditionGrns": [
    ],
    "rate": 1.0
}

버프 적용 조건 모델

Gs2Showcase:Showcase

진열대

마스터 데이터 작성 예
"conditionGrns": [
    {
        "targetModelName": "Gs2Showcase:Showcase",
        "targetGrn": "grn:gs2:any:any:showcase:{namespaceName}:showcase:{showcaseName}"
    }
]
Gs2Showcase:DisplayItem

진열 상품

마스터 데이터 작성 예
"conditionGrns": [
    {
        "targetModelName": "Gs2Showcase:DisplayItem",
        "targetGrn": "grn:gs2:any:any:showcase:{namespaceName}:showcase:{showcaseName}:displayItem:{displayItemId}"
    }
]

Gs2Showcase:RandomDisplayItemModel

랜덤 진열대에 진열 가능한 상품

버프 적용 대상 필드

acquireActions
타입활성화 조건필수기본값값 제한설명
acquireActionsList<AcquireAction>[]1 ~ 100 items획득 액션 목록
이 랜덤 진열 상품의 구매 보상으로 리소스를 지급하는 액션입니다. 트랜잭션의 획득 액션으로 실행됩니다.
마스터 데이터 작성 예

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

"targetModel": {
    "targetModelName": "Gs2Showcase:RandomDisplayItemModel",
    "targetFieldName": "acquireActions",
    "conditionGrns": [
    ],
    "rate": 1.0
}

버프 적용 조건 모델

Gs2Showcase:RandomShowcase

랜덤 진열대

마스터 데이터 작성 예
"conditionGrns": [
    {
        "targetModelName": "Gs2Showcase:RandomShowcase",
        "targetGrn": "grn:gs2:any:any:showcase:{namespaceName}:random:showcase:{showcaseName}"
    }
]
Gs2Showcase:RandomDisplayItemModel

랜덤 진열대에 진열 가능한 상품

마스터 데이터 작성 예
"conditionGrns": [
    {
        "targetModelName": "Gs2Showcase:RandomDisplayItemModel",
        "targetGrn": "grn:gs2:any:any:showcase:{namespaceName}:randomDisplayItem:{displayItemId}"
    }
]
verifyActions
타입활성화 조건필수기본값값 제한설명
verifyActionsList<VerifyAction>[]0 ~ 10 items검증 액션 목록
이 랜덤 진열 상품을 구매하기 전에 실행되는 전제 조건 확인입니다. 모든 검증 액션이 성공한 후에 소비·획득 액션이 처리됩니다.
마스터 데이터 작성 예

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

"targetModel": {
    "targetModelName": "Gs2Showcase:RandomDisplayItemModel",
    "targetFieldName": "verifyActions",
    "conditionGrns": [
    ],
    "rate": 1.0
}

버프 적용 조건 모델

Gs2Showcase:RandomShowcase

랜덤 진열대

마스터 데이터 작성 예
"conditionGrns": [
    {
        "targetModelName": "Gs2Showcase:RandomShowcase",
        "targetGrn": "grn:gs2:any:any:showcase:{namespaceName}:random:showcase:{showcaseName}"
    }
]
Gs2Showcase:RandomDisplayItemModel

랜덤 진열대에 진열 가능한 상품

마스터 데이터 작성 예
"conditionGrns": [
    {
        "targetModelName": "Gs2Showcase:RandomDisplayItemModel",
        "targetGrn": "grn:gs2:any:any:showcase:{namespaceName}:randomDisplayItem:{displayItemId}"
    }
]
consumeActions
타입활성화 조건필수기본값값 제한설명
consumeActionsList<ConsumeAction>[]0 ~ 10 items소비 액션 목록
이 랜덤 진열 상품의 구매 대가로 리소스를 소비하는 액션입니다. 트랜잭션의 소비 액션으로 실행됩니다.
마스터 데이터 작성 예

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

"targetModel": {
    "targetModelName": "Gs2Showcase:RandomDisplayItemModel",
    "targetFieldName": "consumeActions",
    "conditionGrns": [
    ],
    "rate": 1.0
}

버프 적용 조건 모델

Gs2Showcase:RandomShowcase

랜덤 진열대

마스터 데이터 작성 예
"conditionGrns": [
    {
        "targetModelName": "Gs2Showcase:RandomShowcase",
        "targetGrn": "grn:gs2:any:any:showcase:{namespaceName}:random:showcase:{showcaseName}"
    }
]
Gs2Showcase:RandomDisplayItemModel

랜덤 진열대에 진열 가능한 상품

마스터 데이터 작성 예
"conditionGrns": [
    {
        "targetModelName": "Gs2Showcase:RandomDisplayItemModel",
        "targetGrn": "grn:gs2:any:any:showcase:{namespaceName}:randomDisplayItem:{displayItemId}"
    }
]
stock
타입활성화 조건필수기본값값 제한설명
stockint
✓
1 ~ 2147483646재고 수
모든 로테이션을 통틀어 이 상품이 추첨될 수 있는 최대 횟수입니다. 재고가 0이 되면 이후 추첨에서 제외됩니다. 로테이션 추첨 시 상품이 선택되면 재고가 소비됩니다.
마스터 데이터 작성 예

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

"targetModel": {
    "targetModelName": "Gs2Showcase:RandomDisplayItemModel",
    "targetFieldName": "stock",
    "conditionGrns": [
    ],
    "rate": 1.0
}

버프 적용 조건 모델

Gs2Showcase:RandomShowcase

랜덤 진열대

마스터 데이터 작성 예
"conditionGrns": [
    {
        "targetModelName": "Gs2Showcase:RandomShowcase",
        "targetGrn": "grn:gs2:any:any:showcase:{namespaceName}:random:showcase:{showcaseName}"
    }
]
Gs2Showcase:RandomDisplayItemModel

랜덤 진열대에 진열 가능한 상품

마스터 데이터 작성 예
"conditionGrns": [
    {
        "targetModelName": "Gs2Showcase:RandomDisplayItemModel",
        "targetGrn": "grn:gs2:any:any:showcase:{namespaceName}:randomDisplayItem:{displayItemId}"
    }
]