Core Admin
/asc admin commands
Permission: ascension.admin — grants all subcommands below plus shadow staff on /shadows.
Profile loading and recovery
Core loads an uncached player's existing SQLite profile before using it, including for offline balance operations. New-player defaults are created only after a successful query confirms that no profile exists. Joining reuses an already-loaded profile so pending offline changes are not discarded.
If a profile cannot be loaded, Core disconnects the joining player with a reconnect message instead of creating a replacement profile. Check the server log for the profile UUID and database error, restore database access, and have the player reconnect. Do not use /asc admin wipe to resolve a loading error.
If saving a departing player fails, Core logs the failure and keeps the in-memory profile for a later save or reconnect. This is not a durable recovery queue: unsaved changes can still be lost if the server process stops before a successful save. Payment settlement and refund recovery are separate from profile loading.
Overview
| Command | Description |
|---|---|
/asc admin guide | Staff handbook (written book) |
/asc admin inspect <player> | Profile snapshot (rank, XP, mana, slots) |
/asc admin wipe <player> confirm | Reset hunter to new-player defaults (rank, XP, mana, shadows, boosts, skills, quests) |
/asc admin debug | Toggle debug messages for you |
/asc admin plugins | Which Ascension modules are enabled |
/asc admin reload / /asc reload | Reload Core and all modules (gates, shadows, economy, skills, guilds) |
Rank management
| Command | Description |
|---|---|
/asc admin rank set <player> <rank> | Set exact rank |
/asc admin setrank <player> <rank> | Alias for rank set |
/asc admin rank up <player> [steps] | Promote (promote alias) |
/asc admin rank down <player> [steps] | Demote (demote alias) |
Ranks: E, D, C, B, A, S, SS, NATIONAL, MONARCH
XP & mana
| Command | Description |
|---|---|
/asc admin xp add <player> <amount> | Add hunter XP |
/asc admin mana set <player> <amount> | Set current mana |
Rank-up exams (rank-up.exam.enabled: true)
| Command | Description |
|---|---|
/asc admin exam pass <player> | Force-pass a pending exam (promotes) |
/asc admin exam fail <player> | Force-fail a pending exam (applies cooldown) |
/asc admin exam reset <player> | Clear exam eligibility + cooldown |
/asc admin rank … bypasses exams entirely. Players start an exam themselves with /asc exam.
Shadows (requires AscensionShadows)
| Command | Description |
|---|---|
/asc admin shadow list <player> | Stored shadows |
/asc admin shadow types | Valid archetype IDs |
/asc admin shadow give <player> <archetype> <rank> [name] | Grant shadow (target must be online; fails when the army is full) |
/asc admin shadow bond set <player> <level> [archetype] | Set an exact bond level — works offline |
/asc admin shadow bond xp <player> <amount> [archetype] | Grant bond XP and apply level-ups — works offline |
/asc admin wild list | Wild mob archetype IDs |
/asc admin wild spawn <archetype> [tier] [count] | Spawn wild mob at you |
Omit the archetype on the bond commands to hit the player's entire army. See
bond levels for what a level is worth.
Also on /shadows: reload, spawnwild, modeldebug — see Shadow admin.
Boosts
| Command | Description |
|---|---|
/asc admin boost give <player> <type> <amount> <duration> | Grant a boost — 30d, 48h, 90m or perm. Works offline. |
/asc admin boost clear <player> [type] | Remove one type, or every boost (refunds) |
/asc admin boost list <player> | What a player currently holds |
Types: xp, gold, loot, extraction, guild-deposit, shadow-capacity, party-size.
Full reference: Boosts & store delivery.
Items (requires AscensionGates)
| Command | Description |
|---|---|
/asc admin item list | All custom dungeon item IDs |
/asc admin item give <player> <id> [amount] | Give a registered item (target must be online) |
Tab completion covers give/list, online players, item IDs, and common amounts. Console/crate form: asc admin item give %player% <id> 1.
Item browser
A creative-style menu of every Ascension item. It stands in for a custom creative-inventory tab — real creative tabs are built client-side from the client's item registry, so only client mods can add them.
| Command | Description |
|---|---|
/ascitems (aliases itembrowser, ascitem) or /asc admin items | Open the browser on the All Items tab |
/ascitems <tab> | Open one tab: weapons, tools, armor, materials, blocks, utility, relics, runes |
/ascitems search <text> | Filter every tab by name or id (click the spyglass button to clear) |
- Tabs run along the top row, each showing a real item from its category; the open tab glows.
- Hover shows a short tooltip instead of the item's own lore: rarity and tab, one description line, where to get it, and the base
/sellprice (before rank multipliers). Attribute lines are hidden to keep it small. - Where to get it is read live from the configs: mob and boss drop tables (with gate tiers), Dungeon Caches, rare armour-set drops, crystal/gemstone mining, shop price (and rank for gate keys), gate-clear relic rolls, and how runes are equipped. Items nobody can obtain show staff only.
- Taking: click takes 1, shift-click takes a full stack, straight into your inventory — nothing is dropped if it's full. Every take is written to the admin log as
item-browser-take.
Listed: dungeon items from gates.yml and pedestal.yml (weapons, tools, armour sets, crystals, gems, monster materials, skill tomes, the Display Pedestal), the placeable dungeon blocks, Ascension shop items and gate keys for every tier (SS / National / Monarch shown as staff-only), every relic at every rarity (stats roll fresh per copy), one skill rune per active skill, and the player and staff handbooks. A new gates.yml item appears after /asc reload with no extra setup.
| Permission | Default | Allows |
|---|---|---|
ascension.itembrowser.use | op | Open and browse (hover info) |
ascension.itembrowser.take | op | Take items out |
ascension.admin grants both. Staff with only use see Browse only on every item.
Target must be online for commands that take a player name.