# EzSkills – Skill progression for any plugin<\/p>\n
**EzSkills** is a compact RPG progression plugin that layers levelling, XP gain, and timed abilities on top of your server’s gameplay. Use it standalone or integrate with plugins like EzTree, EzMine, or your own custom plugins to turn repetitive actions into a rewarding skill loop.<\/p>\n
\n
\n
\n<\/p>\n
—<\/p>\n
## Features<\/p>\n
### Five built-in skills<\/p>\n
| Skill | Description |
\n|——-|————-|
\n| **Woodcutting** | Award XP for felling trees |
\n| **Mining** | Award XP for breaking ores and stone |
\n| **Fishing** | Award XP for catching fish |
\n| **Fighting** | Award XP for combat with mobs and players |
\n| **Acrobatics** | Award XP for jumping, falling, and sprinting |<\/p>\n
Every source plugin that calls `EzSkillsAPI.addExperience(plugin, …)` is subject to the per-plugin XP multiplier and enabled flag you configure centrally – no changes needed in third-party plugins.<\/p>\n
### Timed abilities<\/p>\n
– **Tree Feller**: the built-in Woodcutting ability. Players prepare, trigger and ride out an auto-expiring mass-fell window.
\n– **Custom abilities** *(new in 2.0)*: any plugin can register its own ability via `EzSkillsAPI.registerAbility(definition)`. Custom abilities appear in the `\/abilities` GUI automatically.
\n– **Ability state GUI** *(new in 2.0)*: the `\/abilities` command opens an overview showing every registered ability with its current state: Ready (green), Preparing (yellow), or Active (gold).<\/p>\n
### Progression controls<\/p>\n
– **Scaling XP curve**: tune `xp-base` and `xp-multiplier` per skill in `skills.yml`.
\n– **Per-plugin overrides** *(new in 2.0)*: in `config.yml`, set an `xp-multiplier` or `enabled: false` for any third-party plugin and any skill without touching their code.<\/p>\n
### Storage<\/p>\n
– **YAML**: zero-setup flat file, ideal for small servers.
\n– **MySQL**: recommended for production; enables full leaderboards via `\/ezskills top`.<\/p>\n
—<\/p>\n
## Core gameplay loop<\/p>\n
1. **Configure** XP curves in `skills.yml` and ability timings in `abilities.yml`.
\n2. **Earn XP** as players perform actions – any event your integration plugin reports.
\n3. **Level up**: `SkillLevelUpEvent` fires immediately for rewards, rank unlocks, or boss-bar announcements.
\n4. **Prepare and activate** an ability within its warm-up window to use a powerful timed effect.
\n5. **View progress** at any time with `\/skills` (levels) and `\/abilities` (ability states).<\/p>\n
—<\/p>\n
## Commands<\/p>\n
### Player commands<\/p>\n
| Command | Description | Permission |
\n|———|————-|————|
\n| `\/skills` | Open the skill progress overview GUI | `ezskills.use` |
\n| `\/abilities` | Open the ability state overview GUI | `ezskills.use` |<\/p>\n
### Admin commands (`\/ezskills`)<\/p>\n
| Command | Description | All `\/ezskills` subcommands require the `ezskills.admin` permission.<\/p>\n —<\/p>\n ## Configuration<\/p>\n | File | Controls | ### Per-plugin XP overrides (new in 2.0)<\/p>\n “`yaml —<\/p>\n ## API reference<\/p>\n ### Skills<\/p>\n | Method | Description | ### Skills<\/p>\n | Method | Description | ### Abilities<\/p>\n | Method | Description | ### Events<\/p>\n – `SkillLevelUpEvent` – fires when a player reaches a new level (carries old and new level). ### Registering a custom ability<\/p>\n “`java \/\/ In onEnable: See the developer documentation for the full integration guide.<\/p>\n —<\/p>\n ## Compatibility<\/p>\n – **Minecraft**: 1.21 and 26.1+ —<\/p>\n ## Need help?<\/p>\n Drop a message on the forum thread or join our Discord server for quick support and integration tips.<\/p>\n","protected":false},"excerpt":{"rendered":" Add skill-based XP, leveling, and timed abilities to any plugin with a clean API<\/p>\n","protected":false},"featured_media":67528,"template":"","meta":{"_minecraft_slug":"ez-skills","_minecraft_project_id":"AwpXN7HO","_minecraft_author":"Shadow48402","_minecraft_license":"MIT","_minecraft_downloads":54,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"ez-skills.zip","_minecraft_size_bytes":26409193,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-15T21:10:31.108728Z","_minecraft_date_created":"2026-04-30T19:07:59.414175Z","_minecraft_date_modified":"2026-05-08T16:59:02.320548Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/ez-skills","_minecraft_icon_attachment_id":67528,"_minecraft_imported_at":"2026-06-03T20:38:53+00:00","_minecraft_import_hash":"15b13a6b4bbb2e9dccc365925703acb7","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,127,128,129],"mod_loader":[130,131,132,133,134],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864,83,167,163],"class_list":["post-67527","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n|———|————-|
\n| `get
\n| `info
\n| `addxp
\n| `setlevel
\n| `reset
\n| `resetall
\n| `top
\n| `ability
\n| `reload` | Reload all config files |<\/p>\n
\n|——|———-|
\n| `config.yml` | GUI titles, boss-bar notifications, `plugin-overrides` |
\n| `skills.yml` | XP base and multiplier per skill |
\n| `abilities.yml` | Preparation window, active duration, and cooldown per ability |
\n| `storage.yml` | Storage backend (YAML or MySQL) and connection details |<\/p>\n
\n# config.yml
\nplugin-overrides:
\n MyPlugin: # must match the exact plugin name
\n woodcutting:
\n enabled: true
\n xp-multiplier: 1.5 # 50% bonus Woodcutting XP from MyPlugin
\n mining:
\n enabled: false # MyPlugin cannot award Mining XP
\n“`<\/p>\n
\n|——–|————-|
\n| `EzSkillsAPI.addExperience(playerId, skill, amount)` | Award XP directly (no multiplier applied) |
\n| `EzSkillsAPI.addExperience(plugin, playerId, skill, amount)` | Award XP with the server-configured multiplier and enabled check |
\n| `EzSkillsAPI.getSkillLevel(playerId, skill)` | Return the player’s current level |
\n| `EzSkillsAPI.getSkillExperience(playerId, skill)` | Return the player’s accumulated XP |
\n| `EzSkillsAPI.setSkillLevel(playerId, skill, level)` | Set a level directly, resetting XP |
\n| `EzSkillsAPI.getSkillProfile(playerId)` | Return the full profile object (null if not cached) |<\/p>\n
\n|——–|————-|
\n| `EzSkillsAPI.registerSkill(definition)` | Register a custom skill at runtime; progress is persisted automatically |
\n| `EzSkillsAPI.getRegisteredSkills()` | List all registered custom skill definitions |<\/p>\n
\n|——–|————-|
\n| `EzSkillsAPI.registerAbility(definition)` | Register a custom ability; appears in `\/abilities` automatically |
\n| `EzSkillsAPI.getRegisteredAbilities()` | List all registered ability definitions |
\n| `EzSkillsAPI.prepareAbility(playerId, ability)` | Enter the preparation (charged) state |
\n| `EzSkillsAPI.activateAbility(playerId, ability)` | Activate the ability immediately |
\n| `EzSkillsAPI.deactivateAbility(playerId, ability)` | Cancel or end the ability early |
\n| `EzSkillsAPI.isAbilityActive(playerId, ability)` | Check whether the ability is currently active.<\/p>\n
\n– `EzSkillsAbilityPrepareEvent` – fires when an ability enters its warm-up window.
\n– `EzSkillsAbilityActivateEvent` – fires when an ability activates.
\n– `EzSkillsAbilityDeactivateEvent` – fires when an ability ends or is cancelled.<\/p>\n
\npublic class NightVisionAbility implements AbilityDefinition {
\n @Override public String getName() { return “NIGHT_VISION”; }
\n @Override public String getDisplayName() { return “Night Vision”; }
\n @Override public Material getIcon() { return Material.ENDER_EYE; } \/\/ optional – defaults to NETHER_STAR
\n @Override public String getDescription() { return “See clearly in the dark.”; }
\n @Override public String getSkillName() { return “FIGHTING”; }
\n \/\/ Optional: override timing defaults (30s prep \/ 15s active \/ 120s cooldown)
\n}<\/p>\n
\nEzSkillsAPI.registerAbility(new NightVisionAbility());
\n“`<\/p>\n
\n– **Server software**: Bukkit, Spigot, or Paper
\n– **Java**: 25+
\n– **Optional**: EzCountdown for boss-bar level-up notifications<\/p>\n