Updating

Regular updates ensure your server has the latest features, bug fixes, and security patches.

Before You Update

Important: Always backup your server before updating!

Backup Your Server

Make a copy of your entire server folder, especially:

  • worlds/ - Your world data
  • plugins/ - Your plugins
  • Nukkit.yml and server.properties - Your configurations

Check Compatibility

Visit the Nukkit Articles page and check:

  • New features
  • Breaking changes
  • Plugin compatibility notes

Update Process

Stop the Server

Type stop in the console to safely shut down the server.

Download Latest Version

Download the newest nukkit-1.0-SNAPSHOT.jar from dl.opencollab.dev.

Replace the JAR File

  1. Delete (or rename) the old Nukkit.jar
  2. Place the new JAR file in your server folder
  3. Rename it to Nukkit.jar (or update your startup script)

Start the Server

Run your startup script (START.bat or start.sh).

Verify the Update

Check the console output for the new version number. Type version in the console to confirm.

After Updating

Check for Issues

  • Monitor the console for errors
  • Test basic functionality (joining, building, commands)
  • Check if all plugins still work

Update Plugins

Some plugins may need updates to work with the new server version. Check:

  • Plugin compatibility
  • New plugin versions
  • Plugin changelogs

Rollback (If Needed)

If something goes wrong:

Stop the Server

Type stop in the console.

Restore Backup

Replace the new JAR with your backed-up old version.

Start the Server

Launch with the previous version while you troubleshoot.

Update Schedule

Recommendation: Check for updates weekly. Major updates may include important security fixes.

  • Stable Releases: Recommended for production servers
  • Canary/Beta Builds: Latest features, but may be less stable
CommandsTroubleshooting