Skip to main content

🔄 How to Update Your Server

So a new Homestead update dropped and you want to get your server up to speed? This guide will walk you through the process step by step.

1. Back Up Your World​

Before doing anything else, back up your world folder. This is the most important step.

  1. Navigate to your server directory.
  2. Find the world folder (this contains all your quest progress, player inventories, builds, and everything else).
  3. Copy the entire world folder and paste it somewhere safe that you'll remember — your Desktop, a backup folder, a flash drive, wherever works for you.

That's your backup. If anything goes wrong during the update, you can simply drop this folder back into your server directory and you're right back where you were.

caution

Never delete or modify your world folder during an update. All quest info, player inventory data, builds, and progression are stored there.

2. Download the New Server Pack​

Head over to the Server Pack page and download the latest server pack ZIP file.

Extract the ZIP somewhere temporary so you can access its contents.

3. Delete the Old Folders​

In your existing server directory, delete the following folders:

  • config/
  • mods/
  • kubejs/
  • scripts/

These are the folders that get updated between versions. Deleting them ensures you get a clean slate with no leftover files from the old version that could cause conflicts.

tip

If you're unsure which folders to delete, just look at what's included in the new server pack — those are the ones that need replacing.

4. Copy in the New Folders​

From the extracted server pack, copy the new versions of the folders you just deleted into your server directory:

  • config/
  • mods/
  • kubejs/
  • scripts/

5. Re-add Any Custom Mods​

If you previously added any extra mods for your friend group or personal preferences (e.g., gameplay mods, world gen mods, etc.), make sure to add those back into the mods/ folder after copying in the new files.

Keep a note of any custom mods you use so you don't forget to re-add them after each update.

6. Start Your Server​

Boot up the server as usual. Everything should load with the new update while keeping all your world data, quest progress, and player inventories intact.

Quick Checklist​

  • Backed up the world folder
  • Downloaded the latest server pack
  • Deleted old config/, mods/, kubejs/, scripts/ folders
  • Copied in the new folders from the server pack
  • Re-added any custom mods
  • Started the server and verified everything works

Troubleshooting​

Server won't start after updating?

  • Double-check that you copied all the new folders in correctly.
  • Make sure you didn't accidentally delete your world folder.
  • Check the server logs for any specific error messages and report them in #community-support on CozyCord.

Players lost their items or quest progress?

  • This shouldn't happen if the world folder was left untouched. If it did, restore your backup by replacing the current world folder with the one you saved earlier.

Custom mods causing issues?

  • Try running the server without your custom mods first to confirm the base update works. Then add them back one at a time to find the culprit.

Need help? Join us on CozyCord and we'll get you sorted.​