Cirrus
Menu Framework. Cirrus enables you to develop platform-independent versatile graphical menus for Spigot, BungeeCord, and Velocity! The goal of Cirrus is to aim for maximum compatibility. Cirrus had been tested on several well-known BungeeCord-Forks as well on all Spigot versions beginning from 1.16.5 till the latest release. The first-ever way of creating menus for Velocity.
Cirrus v3.
Currently Cirrus v3 is under active development. Message Leonhard#5800 on Discord to get in touch & help with the development process.
WIP
Cirrus is currently WIP. The documentation is invalid in parts. We will publish a stable version soon. Spigot & BungeeCord implementations will work, Velocity implementations are currently very experimental. We aim to publish documentation & production ready versions in the coming month.
Version
Current version is:
- Stable: 2.0.0
- Development: 2.1.0-SNAPHOT
PR
If you have any improvements regarding Cirrus feel free to create a PR. We are happy to review & merge it. Keep in mind that to use our codestyle as defined in .editorconfig.
Platforms
On Spigot Cirrus is fully independent of third party plugins. Protocolize is needed only only if Cirrus is used on proxies like BungeeCord or Velocity.
- Spigot
- BungeeCord
- Velocity (WIP)
Supported Bukkit Versions
Due to the changes in the API we only officially support 1.16.5-LATEST (which is 1.19 by the time this is written) Since Cirrus is designed to be mostly version independent, older versions will likely function as well but they are deprecated (so we won't attempt to resolve issues with these versions).
Tooling
Cirrus offers an IntelliJ plugin to enhance the usability of Cirrus. It provides a realtime preview while editing menu configuration files.
Requirements
Protocolize
Cirrus is powered by Protocolize. A protocol manipulation library by one of the Simplix Softworks founders, Exceptionflug. Protocolize enables you to do so much more on BungeeCord/Velocity!
Installation
Just shade and relocate the platform module into your own plugin. Don't forget to call the CirrusSpigot
, CirrusBungeeCord
or CirrusVelocity
init method.
More developer documentation
Check out the wiki for further information on how to use Cirrus in your application.