AscendInstallation
Install AscendSMP on a Spigot or Paper server and get to know the files it generates.
Requirements
| Requirement | Details |
|---|---|
| Server | Spigot or Paper 1.21 and newer |
| Java | 21 or newer |
| Other plugins | None required |
PlaceholderAPI, ItemsAdder, and WorldGuard are optional. The plugin works fully without them. See Placeholders and HUD for what the first two add.
Install steps
- Download the latest AscendSMP jar and drop it into your server's
plugins/folder. - Start the server. On first run the plugin generates its files in
plugins/AscendSMP/(config.yml,abilities.yml,recipes.yml,glyphs.yml, and alang/folder) and downloads its runtime libraries automatically through Spigot's built-in library loader. You do not need to install any libraries yourself. - Watch the console. You should see the purple Ascend startup banner and no red error text.
- Edit the generated files to taste, then apply your changes with a live reload:
/ascend reload
A full server restart works too.
On Paper, the bare `/spark` command belongs to Paper's bundled profiler, not to AscendSMP. Use the `/ability` alias instead (or `/ascendsmp:spark`). On Spigot there is no clash.
Generated files
All files auto-update: new options are merged into your existing files on upgrade without wiping your settings, and invalid values fall back to safe defaults instead of breaking startup.
| File | What it controls | Docs |
|---|---|---|
config.yml | Language, storage backend, HUD mode and refresh, control scheme, disabled worlds, particles, sounds | Configuration |
abilities.yml | Every ability's balance numbers, level scaling, first-join odds, anti-farm rules, event block | Balance |
recipes.yml | Crafting recipes for the Ability Shard and the six primaries | Custom recipes |
glyphs.yml | Icon characters the HUD uses for each ability | HUD |
lang/ | Language files (english, french, german, spanish) | Languages |
Player data is stored in SQLite by default, with no setup needed. MySQL is available as an option; see Storage.