JenkinsArtifactDownloader

A plugin for Bukkit-based servers (Spigot, Paper, etc.) which downloads the latest artifact from one or many Jenkins jobs

Github

How to use

In JADL, all settings are configured in a settings.toml file found within the plugin's folder.

There are two key parts of JADL: jobs, and servers. A server is a jenkins server which contains jobs that you would like to be updated on. A job is a job on a server that you want to receive new builds for.

You can define each server you would like in the servers section of settings.toml. Each key represents a server, with the value being the server's URL.

[servers]
# server name can be whatever you want
athion = "https://ci.athion.net"
citizens = "https://ci.citizensnpcs.co"

In the jobs section, you define the jenkins jobs that you would like to automatically download. The key should represent the job name, and should contain the property server and optionally artifact_file_name

[jobs]
# artifact_file_name not needed because this job has only 1 artifact
HoloPlots = { server = "athion" }
Citizens2 = { server = "citizens" }
# job name can be in quotes - this can be useful for names with spaces
"FastAsyncWorldEdit" = { server = "athion", artifact_file_name = "FastAsyncWorldEdit-Bukkit-2.6.0-SNAPSHOT-396.jar" }

artifact_file_name is only required if the job has more than one artifact

On server startup, JADL will check for updates to all builds by comparing the newest build to the one in localdb.yml

If there are any issues inside settings.toml, JADL will let you know with very user friendly (colorful!!) error messages inspired by the Rust compiler.

When should I use this?

• For development

If you're developing in a group, and need to test features together quickly, it will become much easier. As everyone makes their changes, they can commit them and restart the server, and see their changes instantly.

• For testing

Even if you're a lone developer, this tool can still make testing easier. When you're testing with playtesters, you can now apply a quick fix much faster, letting the testing continue.

• In production... maybe?

In theory, you could have both a develop and production branch on your git repo, and PR from your development branch to your production branch once your changes have been tested

When shouldn't I use this?

• For someone else's plugin

This plugin will allow you to watch other Jenkins servers and automatically get new builds, but that doesn't mean its recommended, ESPECIALLY IN PRODUCTION. In development, it's probably okay.