Installation

Get Ascendra running on your server in a few minutes.

Requirements

Requirement	Detail
Server software	Paper or Spigot
API version	1.20
Java	17 or newer

Optional integrations

• DecentHolograms 2.8.9+ — enables floating hologram labels above graves.
• GriefDefender — enables claim-aware grave placement.

Both are optional soft dependencies. If they are not installed, Ascendra runs normally with those features automatically disabled.

---

Install Steps

1. Download the latest Ascendra-<version>.jar.
2. Stop your server (recommended) or prepare to run a reload.
3. Drop the jar into your server's plugins/ directory.
4. (Optional) Install DecentHolograms and/or GriefDefender if you want those integrations.
5. Start the server. Ascendra generates its data folder, default config.yml, and SQLite database on first run.
6. (Optional) Edit plugins/Ascendra/config.yml to taste, then run /ascendra reload.

After first start you should see:

plugins/
└── Ascendra/
    ├── config.yml
    └── graves.db

---

Quick Start

For most servers, the defaults are sensible. A typical first pass:

1. Open plugins/Ascendra/config.yml.
2. Confirm storage-mode (default EXACT) and xp-mode (default FULL) match your preference.
3. Decide on protection and expiry:
   • protection.duration — how long only the owner can open the grave (default 300 seconds).
   • expiration.lifetime — how long a grave lasts before expiring (default 3600 seconds; -1 for permanent).
4. Set a grave limit if desired with limits.max-graves (-1 = unlimited).
5. Run /ascendra reload to apply changes without restarting.

Test it: die somewhere safe, then run /ascendra to open your grave list GUI and recover your items.

---

Building from Source

Ascendra is a Maven project.

Setting	Value
Group ID	dev.anchorlight
Artifact ID	ascendra
Main class	dev.anchorlight.ascendra.GravesPlugin
Java source/target	17

Build the shaded jar:

mvn package

The build produces a shaded jar named Ascendra-<project.version>.jar (e.g. Ascendra-0.3.0.jar) with the SQLite JDBC driver shaded in. The output jar is what you drop into your plugins/ directory.