Skip to main content

Installing Ascend

Ascend is a game plugin that runs on top of Tea. Before you start here, make sure you already have TeaCore installed and network mode / DB / Redis configured.

Runtime dependencies​

Ascend declares two hard dependencies in plugin.yml:

  • LibsDisguises - used for the mob morphs. Install LibsDisguises.jar into plugins/ on every server that runs Ascend.
  • ProtocolLib - hard dependency of LibsDisguises. Install ProtocolLib.jar alongside it.

Which servers need Ascend​

Install Ascend on every server that should be able to host Ascend matches. In a multi-server deployment, that's usually the arena servers but not the lobby hub - the lobby discovers Ascend through Tea's coordination backend and routes players over to a hosting arena automatically.

In a single-server (network.mode: standalone) deployment, install Ascend on that one server alongside TeaCore (with lobby.enabled: true in plugins/TeaCore/config.yml so the same JVM hosts both the lobby UI and the arenas).

Upgrading​

Replace Ascend.jar and restart. Ascend merges newly-added translation keys and config defaults from the jar into your on-disk files, so your customizations survive the upgrade.

Next steps​

  1. Author an Ascend map (the evolution-viewer + evolution-mob extra spawns are required on top of the core map fields).
  2. Tune ascend/config.yml - stages, abilities, sidebar.
  3. Play - player commands, gameplay flow, kits.