iamgio / chorus

:pencil: The first editor for Spigot configurations.
https://chorus.iamgio.eu
GNU General Public License v3.0
139 stars 9 forks source link
bukkit editor javafx kotlin minecraft spigot yaml yaml-editor

Banner

Downloads Release GitHub license

This is going to be Chorus' last major release. I'm extremely thankful for the support this software has received and I'm glad you enjoyed it! However, 5 years (as of 2023) have passed since its initial release, and I feel the need to move on to some new, exciting projects that would teach me new things along the way. After all, this is what coding is: 5-years-ago me made some design choices that I would not have picked now, but I guess that's how you grow up: you fail and learn, and I'm proud of what Chorus has taught me.

What is Chorus?

Chorus is an easy-to-use and lightweight YAML editor, created for anyone who works on Spigot-based Minecraft servers.
Thanks to its features, Chorus is perfect to edit configurations quickly and easily.

Why Chorus?

Chorus has a lot of features that will help you edit your configuration with extreme ease:

SFTP

Chat preview

GUI preview

Animated text preview

Autocompletion

Quick preview

Inline editor

Insert item

Tick conversion

Fetch information

Add variables

Writing your own add-on

Since 1.3, Chorus supports custom JavaScript add-ons.
Check out the official wiki for API documentation.
Although an official marketplace is not ready yet, you can publish your add-ons by submitting your files to the add-ons repository following the instructions given in its README.
In order to load an add-on, place the .js file inside the chorus/addons folder.

Creating your own theme

Chorus supports custom themes. If you want to create your own, create a folder into chorus/themes named as your theme's name.
In this folder, you have to create the following files:

Note: {name} must be the same as your folder's name.

To see the structure of a style file, take a look at this theme:

If you want to make it public, you can add it to the official themes repository following these guidelines.

Downloading

Chorus is downloadable on chorus.iamgio.eu.
Older versions can be found here.
Make sure you have Java 8 or above installed.

Windows

Download chorus-X.X.X.exe, move it to the desired installation folder and run it.

macOS

ARM: Download chorus-X.X.X-arm.app.zip
Intel: Download chorus-X.X.X-x86.app.zip
Extract the .app file, move it to the Applications folder and open it.

Linux

Download chorus-X.X.X.jar, move it to the desired installation folder and run it.

Donating

I worked so hard on this project.
If you like this software, or just want to support me, I'd really enjoy donations.
By donating, you'll be added to the 'Donors List' accessible from the program.

License

Chorus and its source code are under GPL-3 license. For further information, check LICENSE.
Unauthorized distribution and/or sale are prohibited.