Player Abilities is a framework for adding abilities to players. It supports active abilities the player uses on demand, always-on passives, and triggered abilities that fire on their own when a condition is met. Abilities have levels, cooldowns, and optional requirements, and everything can be tuned from datapacks. There are also many configuration options.
Please check out the website for detailed instructions on how to use this mod. You can also look at the Player Abilities: Reverie mod to see some implementations.
This mod adds no abilities, it just adds the API and framework to create and add abilities to the game. It's intended for you to make your own abilities for your own use.
If you want to try out some abilities you can download my companion mod to this one that implements abilities for my modpack Realms of Reverie: Player Abilities: Reverie.
Or you can try the player abilities developed specifically to be used in the Mortal Boons mod:
Player Abilities: Mortal Boons
While these abiltiy packs were built specifically for use with these mods, abilities are abilities and can be used by anyone for any reason, so feel free to download and use them just for their abilities if you'd like.
Active abilities are selected and used by the player. An ability can fire instantly, charge up (hold to wind up, then release), or channel (the effect runs while you maintain it). Using an ability can require standing still and can be interrupted by damage, with a progress bar and countdown on screen.
The current selected ability will show up on the HUD.
To select a new ability you can open up the ability wheel (default 'z'). It will show each ability you have access to. If you have more than 10 abilities (or the config to separate abilities by type) you can scroll between ability wheels with the wheel open by using the mouse scroll.
Passive abilities are on while you have them. They can grant attribute bonuses like health, speed, reach, or jump strength, or run custom always-on behavior. Passives can be turned off and on from the Ability Book.
Triggered abilities fire automatically when their condition happens. Examples: survive a hit that would have killed you, gain speed after taking damage. Triggers exist for kills, deaths, crits, shield blocks, falls, jumps, eating, sleeping, gaining XP, respawning, dropping below a health threshold, and more. Each triggered ability has its own cooldown and shows a notification when it fires and when it is ready again.
*These are all test abilities and are not included in the mod.
Every registered ability, including abilities added by other mods, automatically gets an Ability Tome item. Using the tome teaches the player that ability. Tomes are color coded by ability kind and collected in their own creative tab. They work well in loot tables and as quest rewards.
Four keybinds, all rebindable in the controls menu. The defaults do not conflict with any vanilla key:
Every gameplay value can be overridden per ability from a datapack: cooldowns, wind-up times, requirements, max levels, effect durations, attribute and effect grants, categories, and the mod compat wiring below. No config file is required for any ability. Datapack values override the defaults.
The mod works standalone. Compat activates automatically when the other mods are installed.
Player Abilities is built as an API. Abilities are registered through a registry. Attribute and effect grants are declared in a single method. Triggered abilities subscribe to built-in trigger points, and mods can define and fire their own. The framework handles grants, levels, cooldowns, requirements, persistence, syncing, and UI. Cancelable events let other mods gate or observe ability use.
Requires NeoForge for Minecraft 1.21.1.
