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

# GS2-Experience API 레퍼런스

경험치·랭크 기능




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

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

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

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

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

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

[마이크로서비스 소개 / GS2-Experience](../../microservices/experience)



- [GS2-Experience Buff 레퍼런스](/ko/api_reference/experience/buff/)
  
- [GS2-Experience Deploy/CDK 레퍼런스](/ko/api_reference/experience/deploy/)
  
- [GS2-Experience SDK API 레퍼런스](/ko/api_reference/experience/sdk/)
  
- [GS2-Experience SDK for Game Engine API 레퍼런스](/ko/api_reference/experience/game_engine/)
  
- [GS2-Experience 마스터 데이터 레퍼런스](/ko/api_reference/experience/master_data/)
  
- [GS2-Experience 스크립트 트리거 레퍼런스](/ko/api_reference/experience/script/)
  
- [GS2-Experience 트랜잭션 액션](/ko/api_reference/experience/stamp_sheet/)