AscensionCore

Features

• Hunter ranks E → Monarch with XP progression
• Rank-up exams — optionally earn promotions by clearing a solo exam gate instead of auto-ranking (/asc exam; off by default)
• Leaderboards / Hunter Ranking Board (/rankings) — Top Hunters, Most Clears, Fastest Clears, Shadow Army, Top Guilds, with a cached async refresh
• Mana regeneration and max mana per rank
• System window (/system) — Solo-Leveling-style blue status window with live stats, menu buttons, and floating milestone pop-ups
• Action bar and optional sidebar HUD
• Achievements GUI
• Hunter abilities: /asc invis (A+), /asc fly (S+)
• Chat channels via /ch (global, guild, party, staff)
• Resource pack hosting and /resourcepack
• Guide books: /asc guide, /asc admin guide
• Admin inspection — /asc admin inspect <player> shows rank/XP/mana, exam state, ranking positions, held relic, quest streak/points, and active auction listings
• SQLite player database
• PlaceholderAPI integration (%ascension_*%, including leaderboard placeholders)

Rank-up exams

When rank-up.exam.enabled is on, crossing an XP threshold for a rank in rank-up.exam.ranks marks the player exam-eligible instead of promoting them. They run /asc exam to enter a private solo gate at the target tier; defeating the boss promotes them (E→D stays automatic). Death, leaving, or the time limit fails the attempt and starts a retry cooldown. With AscensionGates absent or exams disabled, promotion falls back to the classic auto rank-up. See Rank-up exam admin and Core configuration.

Leaderboards

The Hunter Ranking Board (/rankings) shows one page per board — top 10 plus your own position — rebuilt off the main thread every leaderboards.refresh-seconds. Positions and values are also exposed as placeholders (%ascension_top_<board>_<pos>_name% / _value%, %ascension_position_<board>%) for scoreboards. See Placeholders and Core configuration.

System window

/system (aliases /status, /sys) opens a blue, Solo-Leveling-style System status window showing the player's live rank, EXP, HP, mana, shadow capacity, and gold as segmented bars, with quick-access buttons to Quests (/quest ranks), Skills, Shadow Army, Cosmetics, and Rankings. Button clicks open those menus on the next server tick so Paper does not discard the new inventory during click cleanup. Milestone moments — ranking up or extracting a shadow — spawn a floating translucent blue System pop-up (TextDisplay) in front of the player that grows in and fades out. Everything is configurable under system-window in config.yml, and players can mute their own pop-ups with /system notifications off.

Cosmetics

/cosmetics opens a GUI to buy and equip purely cosmetic particle effects with Core gold: auras (particles that orbit you) and trails (particles left as you move). Rank auras unlock free from C → MONARCH (one themed aura per rank via unlock-rank). One aura and one trail can be equipped at once; both render through the shared VFX engine, so vfx.enabled / vfx.density apply and there is no gameplay effect. Add or reprice cosmetics under cosmetics.catalog in config.yml — each points at a particle spec under cosmetics.vfx. Owned/equipped state is stored per player in SQLite.

Key files

Related docs

• Core commands
• Core permissions
• Core configuration
• Core admin — rank-up exam overrides, inspection
• Placeholders — leaderboard placeholders