Update Guide
Bagean iki durung kasedhiya ing Basa Jawa
Konten ditampilake ing Basa Inggris. Yen sampeyan pengin mbantu nerjemahake, monggo gabung ing repositori xmcl-page ing GitHub.
This guide covers how to update XMCL across Windows, macOS, and Linux, and how to verify that your game instances, saves, and accounts remain completely safe during updates.
Data Safety Guarantee
Updating XMCL never wipes your game instances, saves, modpacks, or login credentials. User data is stored separately from the launcher executable files in dedicated system directories.
Windows
1. In-App Automatic Updates (Standard)
- When a new release is published, XMCL displays an update notification badge on the top title bar.
- Click the update notification to review release notes and begin the background download.
- Once downloaded, click Restart & Apply Update. XMCL will restart with the new version.
2. AppInstaller & APPX Packages
- If you installed XMCL via the
xmcl.appinstallerpackage, Windows automatically checks for and installs updates in the background on app launch using Windows Delivery Optimization. - Only differential, changed binary blocks are downloaded, saving bandwidth.
- If an update fails, download the latest
xmcl.appinstallerfrom the official website and run it to repair the installation.
3. Portable ZIP & DeskGap Builds
- Portable ZIP: Download the latest
xmcl-*-win32-x64.zipfrom our releases page, extract it, and replace the existing launcher executable files. Your instances, settings, and worlds will be immediately detected since data lives in%AppData%\xmcl. - DeskGap (v0.72.0+): Extract the new
xmcl-*-deskgap-win32-x64.zipover your current folder.
macOS
1. In-App Update
- XMCL automatically queries GitHub release channels for macOS builds.
- When notified, download and install the update with a single click.
2. Manual DMG Update
- Download the latest
.dmgmatching your Mac's processor:- Apple Silicon (M1 / M2 / M3 / M4):
arm64.dmg - Intel Core Macs:
x64.dmg
- Apple Silicon (M1 / M2 / M3 / M4):
- Open the
.dmgfile. - Drag XMCL.app into your Applications folder and select Replace.
Clearing macOS Gatekeeper Quarantine
If macOS prevents opening the newly updated app with a warning stating the file is damaged or from an unidentified developer, run this command in Terminal:
sudo xattr -cr /Applications/XMCL.appLinux & Steam Deck
1. AppImage
- Direct Replacement: Download the latest
xmcl-*.AppImage, make it executable, and run:shchmod +x xmcl-*.AppImage ./xmcl-*.AppImage - AppImageUpdate: If you use desktop integration tools like AppImageUpdate or Geary, XMCL supports binary delta-updates directly.
- Steam Deck: In SteamOS Desktop Mode, replace your existing
xmcl.AppImagein yourApplicationsorGamesdirectory.
2. Flatpak (Flathub) — Recommended
Flatpak is the officially maintained, primary distribution format on Linux (including Arch Linux, Fedora, Ubuntu, and SteamOS). Update it via your system Software Center (GNOME Software, KDE Discover) or run:
flatpak update app.xmcl.XMCL3. Native Tarball & Distribution Packages
For .tar.xz, .deb, or .rpm packages, download the latest package from our GitHub Releases page and install over your previous version.
Backup & Storage Locations
If you want to perform a manual safety backup before an update, your data is stored in the following directories:
%AppData%\xmcl~/Library/Application Support/xmcl~/.config/xmclYou can simply copy this folder to an external drive or cloud storage to create a full backup of all instances, accounts, and configurations.