Skip to main content
The Skills plugin exposes a public Java/Kotlin API that other Bukkit or Paper plugins can use to read and manipulate player skill data at runtime. The API is registered through Bukkit’s built-in ServicesManager, so no direct dependency on the Skills plugin classes is required beyond the interface.

What the API provides

CategoryCapabilities
Skill CRUDGet, set, add, and check skill values for any online player
Stat accessRead the derived STR, DEX, and INT stats calculated from skill totals
HP / Mana / StaminaRead current and maximum values; restore mana or stamina programmatically
UtilityList all valid skill names, validate a skill name, retrieve a player’s title

Availability

The API was introduced in Skills v0.4.13. It is registered when the plugin enables and unregistered when it disables. If Skills is loaded as a soft dependency, always null-check the provider before calling any methods.

Getting started

Add Skills as a dependency, obtain the API instance, and run your first queries.

API reference

Full documentation for all 19 methods in the SkillsAPI interface.

Build docs developers (and LLMs) love