GS2-Experience API Reference

It is used to realize a system of rank advancement by accumulating experience, such as character and skill levels and affinity. It also has a rank cap function, which allows for management of upper limits for individual elements such as characters and skills.

GS2-Experience automatically calculates rank from the experience value. To do so, you must use master data to define a table of experience values that serve as rank-up thresholds. ExperienceModel manages rank-up thresholds, and property IDs with arbitrary values can be hung beneath it. The experience value is managed per property ID, and the rank is determined based on the experience value.

For example, cases such as “I want to change the required experience table per character type” or “I want to set different rank caps per individual character” can be addressed by preparing an ExperienceModel per character type and assigning each character’s individual ID as the property ID.

A rank can have an upper limit. If experience is gained while at the rank cap, that experience is discarded.

The initial rank cap is set in ExperienceModel, but can be raised individually per property ID. This makes it possible to implement specifications such as raising the rank cap when performing a limit break.

By referring to nextRankUpExperienceValue on the client, you can easily display the experience required until the next rank-up and render a progress bar.