Getting Started
Installation
Deploy Ascension Protocol on a Paper server
Requirements
- Java 21
- Paper 1.21.x
- Ascension Protocol plugins (drop all JARs into your server
plugins/folder):- AscensionLib
- AscensionCore
- AscensionGates
- AscensionShadows
- AscensionSkills
- AscensionGuilds
- AscensionEconomy
- ModelEngine — required for shadow models, dungeon/wild mobs, and boss visuals. Without it, entities load as vanilla mobs (no custom models or animations).
Enable resource-pack.merge-modelengine-pack: true in AscensionCore config.yml (default) so clients receive ModelEngine textures with the Ascension pack on join.
First-time setup
- Place all Ascension plugin JARs in your server
plugins/folder. - Start the server once.
- Confirm plugins load in this order:
AscensionLib→AscensionCore→ others. - Configure generated files under
plugins/AscensionCore/,plugins/AscensionGates/, etc. - Restart or
/asc reload+/gates admin reloadas needed.
Optional integrations
| Plugin | Used for |
|---|---|
| Vault | Economy, shop, guild bank |
| LuckPerms | Rank sync, permissions |
| PlaceholderAPI | %ascension_*% placeholders |
| MythicMobs | Extended mob hooks (if used on your server) |
| WorldGuard / Towny | Gate spawn restrictions |
| EssentialsX Chat | Nicknames with Ascension chat renderer |
| SimpleScore | Ascension sidebar — copy-paste template |
Data storage
AscensionCore uses SQLite by default (plugins/AscensionCore/ascension.db). Backups run before schema migrations when database.backup-before-migrate is enabled.
Developers
If you build from source, see the repository README for Gradle build instructions.