GS2-SkillTree 마스터 데이터 레퍼런스
마스터 데이터 포맷과 임포트할 각종 모델의 레퍼런스
마스터 데이터 포맷
{
"version": "2023-09-06",
"nodeModels": [
{
"name": "[string]노드 모델명",
"metadata": "[string?]메타데이터",
"releaseVerifyActions": [
{
"action": "[string]검증 액션에서 실행할 액션의 종류",
"request": "[string]액션 실행 시 사용되는 요청의 JSON 문자열"
}
],
"releaseConsumeActions": [
{
"action": "[string]소비 액션에서 실행할 액션의 종류",
"request": "[string]액션 실행 시 사용되는 요청의 JSON 문자열"
}
],
"returnAcquireActions": [
{
"action": "[string]입수 액션에서 실행할 액션의 종류",
"request": "[string]액션 실행 시 사용되는 요청의 JSON 문자열"
}
],
"restrainReturnRate": "[float]반환율",
"premiseNodeNames": [
"[string]노드 모델명"
]
}
]
}| 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 | |
|---|---|---|---|---|---|---|
| version | string | ✓ | 2023-09-06 | 마스터 데이터 포맷 버전 | ||
| nodeModels | List<NodeModel> | ~ 1000 items | 노드 모델 스킬 트리 내의 노드를 정의하는 모델로, 해방 비용·전제 조건·반환 동작을 포함합니다. 각 노드에는 검증 액션(해방 전 조건 확인), 소비 액션(지불할 비용), 먼저 해방되어야 하는 전제 노드를 설정할 수 있습니다. 노드를 구속(미해방 상태로 되돌림)하면, 소비한 리소스가 반환율에 따라 부분적으로 반환됩니다. 반환 입수 액션은 소비 액션에 반환율을 곱하여 자동으로 계산됩니다. |
모델
NodeModel
노드 모델
스킬 트리 내의 노드를 정의하는 모델로, 해방 비용·전제 조건·반환 동작을 포함합니다.
각 노드에는 검증 액션(해방 전 조건 확인), 소비 액션(지불할 비용), 먼저 해방되어야 하는 전제 노드를 설정할 수 있습니다.
노드를 구속(미해방 상태로 되돌림)하면, 소비한 리소스가 반환율에 따라 부분적으로 반환됩니다.
반환 입수 액션은 소비 액션에 반환율을 곱하여 자동으로 계산됩니다.
| 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 | |
|---|---|---|---|---|---|---|
| nodeModelId | string | ※ | ~ 1024자 | 노드 모델 GRN
※ 서버가 자동으로 설정 | ||
| name | string | ✓ | ~ 128자 | 노드 모델명 노드 모델 고유의 이름. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다. | ||
| metadata | string | ~ 2048자 | 메타데이터 메타데이터에는 임의의 값을 설정할 수 있습니다. 이 값들은 GS2의 동작에는 영향을 주지 않으므로, 게임 내에서 사용하는 정보를 저장하는 용도로 사용할 수 있습니다. | |||
| releaseVerifyActions | List<VerifyAction> | [] | 0 ~ 10 items | 해방 검증 액션 목록 이 노드를 해방하기 전에 실행되어 조건이 충족되었는지 확인하는 검증 액션의 목록입니다. 예를 들어 플레이어가 특정 레벨에 도달했는지, 특정 아이템을 소지하고 있는지를 검증할 수 있습니다. 검증 액션 중 하나라도 실패하면 노드 해방이 거부됩니다. 최대 10개 액션. | ||
| releaseConsumeActions | List<ConsumeAction> | [] | 1 ~ 10 items | 해방 소비 액션 목록 이 노드를 해방할 때 실행되는 소비 액션의 목록으로, 해방 비용을 나타냅니다. 이 액션들은 반환 입수 액션 계산에도 사용됩니다. 노드를 구속할 때 각 소비 액션이 반환율에 따라 역산됩니다. 최소 1개의 소비 액션이 필요합니다. 최대 10개 액션. | ||
| returnAcquireActions | List<AcquireAction> | 0 ~ 10 items | 반환 입수 액션 목록 이 노드를 구속(취소)할 때 실행되는 입수 액션의 목록으로, 플레이어에게 반환되는 리소스를 나타냅니다. 이 필드는 해방 소비 액션에 반환율을 곱하여 자동 생성됩니다. 예를 들어 해방 비용이 골드 100이고 반환율이 0.8인 경우, 구속 시 골드 80이 반환됩니다. 최대 10개 액션. | |||
| restrainReturnRate | float | 1.0 | 0.0 ~ 1.0 | 반환율 이 노드를 구속(미해방 상태로 되돌림)했을 때 소비된 리소스가 반환되는 비율입니다. 1.0은 전액 반환, 0.5는 절반 반환, 0.0은 반환 없음을 의미합니다. 기본값은 1.0(전액 반환)입니다. 유효 범위: 0.0~1.0. | ||
| premiseNodeNames | List<string> | [] | 0 ~ 10 items | 전제 노드명 목록 이 노드를 해방하기 전에 먼저 해방되어 있어야 하는 다른 노드 모델의 이름입니다. 스킬 트리의 의존 관계 그래프를 정의합니다. 전제 노드가 모두 해방되어 있지 않으면 이 노드는 해방할 수 없습니다. 최대 10개의 전제 노드. |
ConsumeAction
소비 액션
VerifyAction
검증 액션
AcquireAction
입수 액션