Supported Versions
Supported versions
If you were sent to this page, you are:
- Having trouble getting Citizens to run
- Asking for help while being on an unsupported Minecraft version
- Asking for help related to a possible bug, but are on an unsupported or minimum supported Minecraft version
This page explains what you can and should do, while also providing other helpful tools, to help you maintain your server.
Running a server requires maintenance
We know that running a Minecraft server can be rewarding and fun, but unfortunately it also requires work to maintain, even if you purchase a setup. It's crucial to keep your server updated, because new versions come with security patches, bugfixes, and features for players.
For instance, the Log4Shell exploit demonstrates how outdated versions can leave servers vulnerable to severe security threats.
Regular backups are essential to ensure the safety of your Minecraft server's data. A simple way to make them is to .zip or .tar your Minecraft server and download it with a FTP client from your servers host. If you’re looking for more advanced tools, you might consider using BorgBackup. It allows you to make backups automatically for free.
Support Table
| 1.8 | 1.12.2 | 1.19.0 | 1.19.1 | 1.19.2 | 1.19.3 | 1.19.4 | 1.20.0 | 1.20.1 | 1.20.2 | 1.20.3 | 1.20.4 | 1.20.5 | 1.20.6 | 1.21.0 | 1.21.1 | 1.21.2 | 1.21.3 | 1.21.4 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ⚠️ | ❌ | ✅ | ❌ | ❌ | ⚠️ | ⚠️ | ✅ |
The support chart above outlines the versions we currently support and those we do not. Versions that are not listed here are also entirely unsupported. If you are on 1.8 see Minecraft 1.8.
✅ - Versions that are fully supported. These versions will get all new features, bug fixes, and security patches.
❌ - We can not provide any type of support for it. We won’t answer any questions until you move to a supported version. Latest Citizens version will not run on this version.
⚠️ - We answer basic questions, but can not help with possible bugs or feature requests. The latest Citizens version will not run on this version.
Citizens supports multiple versions of Minecraft. Due to Spigot file size limits, limited development time, and security risks and bugs that come with older Minecraft versions, the actively supported versions change over time. Citizens does not and will never support every single version of Minecraft.
You can find the latest Citizens dev build here. If you are looking for older builds you can find links to them in the #news channel on our Discord. Be aware that you might be end up entirely on your own and lose the chance of getting support.
As a rule of thumb, for each Minecraft version, only the latest Minecraft patch version is fully supported. For example in Minecraft 1.18, the latest patch version is 1.18.2 and so the latest version of Citizens will only work with Minecraft Version 1.18.2, not 1.18 or 1.18.1.
What to do?
Having trouble getting Citizens to run
If you have trouble getting Citizens to run, you probably noticed a line like
Error occurred while enabling Citizens v2.0.37-SNAPSHOT (build 3648) (Is it up to date?)
in your latest.log file. This line usually means that either your Minecraft version or Citizens is not up to date. In this case you need to update your Minecraft server. We know that this can be difficult, especially if you just set your server up or purchased a setup. However, server maintenance is critical as explained above.
If you host your server on a free host and have trouble updating your server, please see this.
Asking for help on an unsupported Minecraft version
As described in the support chart, Citizens supports only fully supports the latest patch versions of Minecraft. If you are on an older version, we unfortunately cannot provide support for it.
Please update your Minecraft server to a patch version that we support(one with a ✅). Once you’ve updated your server, feel free to reach out to us for help!
Reporting a potential bug, but on an unsupported Minecraft version
If you're encountering a bug on an unsupported or minimum supported version, especially on the latest Minecraft major release, the issue may have already been fixed in the latest Citizens version. So please update your Minecraft server to a patch version that we support(one with a ✅).
If you cannot update because a Plugin prevents you from it because it does not support this version yet or you are using Paper and the latest version is not stable yet, it's not a problem!
Please help us by attempting to replicate the behavior on a local test server on the latest patch version. If you can successfully replicate the issue, provide your latest.log from the updated server and tell us the steps to reproduce this issue, so we can troubleshoot further.
How to update a Minecraft server
Updating a Minecraft server is a simple straightforward process, but it’s crucial to approach it carefully to avoid running into issues. The following explanation covers the basic process.
Have a backup on hand
Before making any changes, make sure you have a working backup of your server. Just in case something unpredictable happens and you need to restore it.
Test the update locally on your computer
Perform a dry run by downloading and running your server locally on your computer and updating it. To do that, you need to:
- Replace the server's .jar file and any plugin .jar file with the updated version you have downloaded from the related plugins page.
- Start your server and check the logs for errors and warnings.
- Log in to your local server and test important things that must work.
If you don’t see issues coming up, you are likely good to update.
If you encounter issues:
- Check the related plugin's official page or support channels for news.
- Look for help on the plugin's Discord server, if any exists.
Proceed to update your production server
Once you're confident with your local tests, proceed with updating your production server.