GS2-Experience API 레퍼런스

캐릭터나 스킬의 레벨, 호감도 등 경험치를 쌓아 랭크업하는 시스템을 구현하는 데 사용합니다.
랭크 캡 기능도 갖추고 있어 캐릭터나 스킬 등 개별 요소별로 상한을 관리할 수 있습니다.

GS2-Experience 는 경험치 값으로부터 자동으로 랭크 값을 계산합니다.
이를 위해서는 마스터 데이터를 이용해 랭크업 임계값이 되는 경험치 테이블을 정의해야 합니다.
ExperienceModel 에서 랭크업 임계값을 관리하며, 그 아래에 임의의 값을 가지는 프로퍼티ID 를 종속시킬 수 있습니다.
프로퍼티ID 별로 경험치 값이 관리되고, 경험치 값에 따라 랭크가 결정됩니다.

예를 들어 “캐릭터 종류별로 필요 경험치 테이블을 다르게 하고 싶다”, “캐릭터별로 랭크 캡을 다르게 하고 싶다” 와 같은 경우, ExperienceModel 을 캐릭터 종류별로 준비하고 프로퍼티ID 에 캐릭터의 개별 ID를 할당함으로써 구현할 수 있습니다.

랭크에는 상한을 설정할 수 있습니다.
랭크의 상한에 도달한 상태에서 경험치를 입수한 경우, 경험치는 파기됩니다.

랭크의 상한은 ExperienceModel 에서 초기값을 설정하지만, 프로퍼티ID 별로 개별적으로 인상할 수 있습니다.
이를 통해 한계돌파 강화를 실시하면 랭크 캡을 인상하는 것과 같은 사양을 구현할 수 있습니다.

nextRankUpExperienceValue 를 클라이언트에서 참조함으로써, 랭크업까지 필요한 경험치 표시나 진행 바 그리기를 간단하게 수행할 수 있습니다.