Boosts & Store Delivery
Timed and permanent player entitlements — how store packages actually land in game
Boosts are the delivery target for everything the store sells that isn't a rank or a cosmetic: XP and loot multipliers, extra army slots, gate party slots, extraction chance, guild deposit bonuses. They are also usable as event or reward sinks.
A boost is a row: player + type + amount + expiry. Rows stack — two +50% XP boosts give +100%.
They persist in SQLite (ap_player_boosts), so a grant lands on an offline player and is waiting
when they join.
Types
| Type id | Amount means | Applies to |
|---|---|---|
xp | percent | All Ascension XP (gates, dungeons, quests). Adds to donor-rank and relic bonuses. |
gold | percent | Gold from quest rewards. Never applies to /pay, selling or auction payouts. |
loot | percent | Extra boss loot rolls. +100% = one guaranteed extra roll; +50% = a coin-flip for one. The highest boost in the party applies once, so party members don't stack. |
extraction | percentage points | Shadow extraction chance — a +10 boost turns a 40% offer into 50%. Shown in the offer GUI at the number it will actually roll at. |
guild-deposit | percent | The guild bank receives more than the member paid in. |
shadow-capacity | flat slots | Extra shadow army slots on top of rank + skills. |
party-size | flat slots | Extra gate party members on top of rank + donor bonuses. |
Flat boosts are added at read time, never written into the player profile. A 30-day +2 army slots grant therefore lapses cleanly instead of leaving the stored capacity permanently inflated.
Commands
| Command | Player online? | Purpose |
|---|---|---|
/asc admin boost give <player> <type> <amount> <duration> | No | Grant. Duration: 30d, 48h, 90m, or perm. |
/asc admin boost clear <player> [type] | No | Remove one type, or every boost when type is omitted (refunds). |
/asc admin boost list <player> | No | Audit what a player holds. |
/asc boosts | — | Player view: active boosts and time left. |
/asc admin boost give Steve loot 100 48h → +100% loot for two days
/asc admin boost give Steve shadow-capacity 2 perm
/asc admin boost clear Steve → wipe all boosts (refund)Players are told when a boost is applied and again when it expires. /asc stats shows the boosted
army capacity with the bonus called out.
Shadow delivery
Store shadow packages use these, all of which work while the buyer is offline except
shadow give:
| Command | Player online? | Purpose |
|---|---|---|
/asc admin shadow give <player> <archetype> <rank> [name] | Yes | Puts a shadow in the army. Fails if the army is full — grant the capacity boost first. |
/asc admin shadow bond set <player> <level> [archetype] | No | Exact bond level — the "arrives at bond 25" head start. |
/asc admin shadow bond xp <player> <amount> [archetype] | No | Grants bond XP and applies the level-ups. |
Omit the archetype filter to hit the player's whole army (that's how the 50,000 bond XP spread across every shadow package works).
See bond levels for what a level is actually worth.
Store packages
The full Tebex package list — prices, descriptions and the exact command list per package — lives in
deploy/server-setup/TEBEX-STORE-PACKAGES.md. Ranks and cosmetics are delivered as LuckPerms
permission nodes; see donor ranks.