Configuration
Ascendra is configured through plugins/Ascendra/config.yml. After editing, apply changes with /ascendra reload — no restart required.
Default config.yml
storage-mode: EXACT
xp-mode: FULL
xp-percentage: 100
worlds:
use-whitelist: false
enabled-worlds: []
disabled-worlds:
- world_disabled_example
limits:
max-graves: -1
remove-oldest-on-limit: true
expiration:
enabled: true
lifetime: 3600
on-expire: DROP
protection:
duration: 300
killer-access: false
placement:
search-radius: 10
blacklist:
- LAVA
- FIRE
- SOUL_FIRE
- CAMPFIRE
- SOUL_CAMPFIRE
- MAGMA_BLOCK
- CACTUS
- SWEET_BERRY_BUSH
- WITHER_ROSE
- POWDER_SNOW
- DRAGON_EGG
- BEACON
- SCULK_SENSOR
- SCULK_SHRIEKER
grave-platform:
on-liquids: true
y-offset: 30
removal-delay: 30
remove-only-if-unchanged: true
material: GLASS
cosmetic:
give-head: true
lightning:
enabled: true
sound: true
particles:
enabled: true
sounds:
creation: ENTITY_LIGHTNING_BOLT_THUNDER
opening: BLOCK_CHEST_OPEN
looting: ENTITY_ITEM_PICKUP
breaking: BLOCK_STONE_BREAK
holograms:
enabled: true
height: 1.5
line-spacing: 0.25
lines:
- "&f{player}'s Grave"
- "&7{time}"
- "&e{status}"
recovery-compass:
enabled: true
proximity-radius: 5
griefdefender:
block-graves-in-claims: true
messages:
prefix: "&8[&aAscendra&8] "
grave-created: "&aYour grave has been created at &e{x}, {y}, {z} &ain &b{world}&a."
grave-opened: "&aOpened grave."
grave-no-permission: "&cYou don't have permission to access this grave."
grave-protected: "&cThis grave is protected for &e{time}&c more seconds."
grave-not-found: "&cGrave not found."
grave-deleted: "&aGrave deleted."
grave-emptied: "&aYour grave has been collected."
no-graves: "&7You have no active graves."
reload-success: "&aConfiguration reloaded."
xp-restored: "&aRestored &e{xp} &aXP from your grave."
platform-removal: "&eThe grave platform beneath you will disappear in &a{seconds} &eseconds. Move away!"
Storage
| Key | Default | Description |
|---|---|---|
storage-mode | EXACT | How recovered items are returned. EXACT restores items to their original inventory slots; COMPACT places recovered items into any available slots. |
XP
| Key | Default | Description |
|---|---|---|
xp-mode | FULL | XP handling. FULL stores all XP, PERCENTAGE stores xp-percentage percent, NONE stores no XP. |
xp-percentage | 100 | Percent of XP to store. Only used when xp-mode is PERCENTAGE. Valid range: 0–100. |
Worlds
| Key | Default | Description |
|---|---|---|
worlds.use-whitelist | false | If true, graves only work in enabled-worlds. If false, graves work everywhere except disabled-worlds. |
worlds.enabled-worlds | [] | Whitelist of worlds where graves work (used when use-whitelist: true). |
worlds.disabled-worlds | [world_disabled_example] | Blacklist of worlds where graves never spawn (used when use-whitelist: false). |
Limits
| Key | Default | Description |
|---|---|---|
limits.max-graves | -1 | Maximum active graves per player. -1 means unlimited. |
limits.remove-oldest-on-limit | true | If true, removes the player's oldest grave when they exceed the limit. |
Expiration
| Key | Default | Description |
|---|---|---|
expiration.enabled | true | Enables timed grave expiry. |
expiration.lifetime | 3600 | Grave lifetime in seconds. -1 means permanent. |
expiration.on-expire | DROP | What happens at expiry. DROP drops contents into the world; DELETE removes them. |
Protection
| Key | Default | Description |
|---|---|---|
protection.duration | 300 | Seconds during which only the owner can access the grave. |
protection.killer-access | false | If true, the killer may access the grave during the protection period. |
See Grave Behaviour → Protection for details.
Placement
| Key | Default | Description |
|---|---|---|
placement.search-radius | 10 | Radius (in blocks) used to find a safe nearby grave location. |
placement.blacklist | (see default) | Materials a grave should not be placed in or on (lava, fire, cactus, powder snow, etc.). |
Grave Platform
Used to keep items safe when a player dies over the void or large bodies of liquid.
| Key | Default | Description |
|---|---|---|
grave-platform.on-liquids | true | If true, creates a platform when the player dies over large bodies of water or lava. |
grave-platform.y-offset | 30 | Offset above the world's minimum height for void-safe platforms. |
grave-platform.removal-delay | 30 | Delay (seconds) before removing the platform after the grave is emptied. |
grave-platform.remove-only-if-unchanged | true | Prevents removing platform blocks that players have since changed. |
grave-platform.material | GLASS | Block material used for the temporary platform. |
Cosmetic
| Key | Default | Description |
|---|---|---|
cosmetic.give-head | true | Places the deceased player's head inside the grave. |
cosmetic.lightning.enabled | true | Cosmetic lightning effect on grave creation. |
cosmetic.lightning.sound | true | Plays a sound with the lightning effect. |
cosmetic.particles.enabled | true | Controls particle effects. |
cosmetic.sounds.creation | ENTITY_LIGHTNING_BOLT_THUNDER | Sound played when a grave is created. |
cosmetic.sounds.opening | BLOCK_CHEST_OPEN | Sound played when a grave is opened. |
cosmetic.sounds.looting | ENTITY_ITEM_PICKUP | Sound played when items are taken. |
cosmetic.sounds.breaking | BLOCK_STONE_BREAK | Sound played when a grave block is broken. |
Holograms
| Key | Default | Description |
|---|---|---|
holograms.enabled | true | Enables holograms if DecentHolograms is installed. |
holograms.height | 1.5 | Height above the grave block. |
holograms.line-spacing | 0.25 | Vertical spacing between hologram lines. |
holograms.lines | (see default) | Text displayed above the grave. Supports colour codes and placeholders. |
See Holograms for placeholder details.
Recovery Compass
| Key | Default | Description |
|---|---|---|
recovery-compass.enabled | true | Gives players a compass pointing to their grave. |
recovery-compass.proximity-radius | 5 | Distance from the grave at which the compass is automatically removed. |
See Recovery Compass.
GriefDefender
| Key | Default | Description |
|---|---|---|
griefdefender.block-graves-in-claims | true | If true, graves do not spawn inside GriefDefender claims and items drop normally instead. |
See Integrations.
Messages
All player-facing messages live under messages and support standard & colour codes. The prefix is prepended where applicable.
| Key | Default |
|---|---|
prefix | &8[&aAscendra&8] |
grave-created | &aYour grave has been created at &e{x}, {y}, {z} &ain &b{world}&a. |
grave-opened | &aOpened grave. |
grave-no-permission | &cYou don't have permission to access this grave. |
grave-protected | &cThis grave is protected for &e{time}&c more seconds. |
grave-not-found | &cGrave not found. |
grave-deleted | &aGrave deleted. |
grave-emptied | &aYour grave has been collected. |
no-graves | &7You have no active graves. |
reload-success | &aConfiguration reloaded. |
xp-restored | &aRestored &e{xp} &aXP from your grave. |
platform-removal | &eThe grave platform beneath you will disappear in &a{seconds} &eseconds. Move away! |
Message placeholders
| Placeholder | Used in | Meaning |
|---|---|---|
{x}, {y}, {z} | grave-created | Grave block coordinates. |
{world} | grave-created | World name. |
{time} | grave-protected | Seconds of protection remaining. |
{xp} | xp-restored | Amount of XP returned. |
{seconds} | platform-removal | Seconds until the platform disappears. |
Example Configurations
Hardcore-friendly: short protection, no XP kept
xp-mode: NONE
protection:
duration: 60
killer-access: true
expiration:
enabled: true
lifetime: 1800
on-expire: DROP
Casual / forgiving: permanent graves, generous limits
xp-mode: FULL
limits:
max-graves: -1
expiration:
enabled: false
lifetime: -1
on-expire: DROP
protection:
duration: 600
Compact recovery with capped graves
storage-mode: COMPACT
limits:
max-graves: 3
remove-oldest-on-limit: true