Please note that this plugin requires Spigot or Paper 1.21.4 or later to function properly.

• PlaceholderAPI exposes %ascend_...% placeholders (equipped abilities, levels, cooldowns, kills, deaths) for scoreboards, tab, and chat (link)
• ItemsAdder supplies custom HUD icons when hud.icon-mode: ITEMSADDER (falls back to text without it)
• WorldGuard is supported as a soft-dependency hook

• Secondary (max level 3): Leap, Luck, Hydro, Stealth, Might. New players get a random one on first join, and can reroll it with an Ability Shard.
• Primary (max level 5): Blood, Phase, Flame, Thunder, Health, Rotten. Craft a primary's item and right-click to bind it, your old primary is returned as an item so nothing's lost.
• Event abilities (admin-only, full power): Warden, Ender, Wither. Granted by staff for server events, and they don't level.

• Primary: tap the offhand-swap key (F by default)
• Secondary: hold sneak and tap the same key
• No key? No problem: use /spark primary or /spark secondary instead

• TEXT (default): no resource pack needed, ability names grey out while cooling down
• VANILLA: custom glyph icons from a resource pack
• ITEMSADDER: icons supplied by ItemsAdder (falls back to TEXT if absent)

HUD glyphs, Hydro secondary and Blood primary

HUD glyphs, Leap secondary and Flame primary

HUD glyphs, Luck secondary and Health primary

HUD glyphs, Might secondary and Phase primary

HUD glyphs, Stealth secondary and Rotten primary

HUD glyphs, Stealth secondary and Thunder primary

The ability menu

Spoiler: A closer look at each menu item

The secondary slot

The primary slot

The Ability Shard, reroll your secondary

Unbind your primary (two-click confirm)

My Information, your abilities and record

Toggle your HUD

Open the Ability Codex

The Ability Codex

Browsing the codex entries

Might

• Secondary: handed out at random on a player's first join (odds configurable), rerolled by right-clicking a craftable Ability Shard
• Primary: craft a primary's ability item and right-click to bind it
• Custom recipes: the shard and all six primary recipes are fully reworkable in recipes.yml

• /sparkgui (aliases /abilities, /amenu) open the ability menu
• /spark <primary|secondary> (alias /ability) activate an ability without the key
• /ascend hud toggle show or hide your HUD

• /ascend reroll [player] reroll a secondary
• /ascend setsecondary <player> <id> / setprimary <player> <id> force an ability
• /ascend event give|remove <player> <warden|ender|wither> grant or reclaim an event ability
• /ascend info [player] view equipped abilities, levels, and record
• /ascend level set <player> <secondary|primary> <level> set an ability's level
• /ascend give <shard|ability> [player] give the shard or a primary item
• /ascend reload live-reload all config

The in-game help menu

• ascend.use use abilities, /spark, /sparkgui, and the HUD toggle (default: everyone)
• ascend.admin all /ascend management subcommands (default: ops)

• config.yml language, storage, HUD mode and refresh, control scheme, disabled worlds, particle density, sounds
• abilities.yml every balance number, level scaling, first-join odds, anti-farm rules, and the event block
• recipes.yml the shard and all six primary crafting recipes
• glyphs.yml the HUD icon characters for each ability's ready and cooldown states
• Auto-updating: new keys merge into your files on upgrade without wiping your settings, and invalid values fall back to safe defaults instead of breaking startup
• Full color support: both & codes and &#rrggbb hex everywhere

• %ascend_secondary% / %ascend_primary% equipped ability name
• %ascend_secondary_level% / %ascend_primary_level% ability level
• %ascend_secondary_cooldown% / %ascend_primary_cooldown% time left (0s when ready)
• %ascend_kills% / %ascend_deaths% lifetime record

• Minecraft: 1.21.x
• Server software: Spigot or Paper
• Java: 21 or higher
• Storage: SQLite out of the box (single file, zero setup) or MySQL
• Languages: English, French, German, and Spanish bundled