中文 (简体, 繁體, 文言) | English (Standard, uʍoᗡ ǝpᴉsd∩) | 日本語 | español | русский | українська
XYML (xOyz Minecraft Launcher) is an open-source, cross-platform Minecraft launcher independently maintained by the MinecraftSTL community. Its current desktop interface is built with Swing and provides complete workflows for installing and launching the game, maintaining instances, and managing modpacks.
Its main features include:
- Installing and managing Minecraft together with loaders such as Forge, NeoForge, Cleanroom, Fabric, Legacy Fabric, Quilt, LiteLoader, and OptiFine;
- Managing accounts, game instances, Java runtimes, and game settings;
- Managing mods, resource packs, worlds, and modpacks, including modpack installation, updates, creation, and export;
- Customizing launcher themes, backgrounds, and appearance.
XYML supports multiple operating systems and CPU architectures. See the platform support table for exact support levels and limitations. The launcher requires Java 17 or later, and Java 21 is recommended.
XYML originates from the code and Git history of HMCL (Hello Minecraft! Launcher), which is this project's upstream repository. HMCL's maintainers and community contributors established the foundations that XYML inherits, including game launching and downloads, instance and account management, modpacks, localization, and cross-platform support. This repository preserves those historical commits, authorship, and copyright notices with gratitude.
XYML is a downstream project independently maintained by MinecraftSTL and is not an official HMCL release. XYML
manages its own versions, release channels, artifacts, and issue tracking; the release status of HMCL and XYML does not
represent the other project. This repository retains HMCL-dev/HMCL as its upstream source so that suitable upstream
changes can be tracked and evaluated for XYML.
Download official XYML builds from GitHub Releases. XYML uses four release channels: stable, beta, alpha, and dev. Their version formats, test audiences, feedback policies, and promotion order are documented in the release model.
You can participate in XYML through the following channels:
- Report problems or propose features through GitHub Issues;
- Fork this repository and submit a pull request;
- Follow the contributing guide to build, run, and debug XYML from source.
Thank you to everyone who contributes code, translations, testing, issue reports, and documentation to XYML.
We also thank HMCL's authors and contributors throughout its history. The long-running development inherited by XYML belongs to that upstream history and should not be represented as work produced solely by the XYML project.
XYML is distributed under the GNU General Public License, version 3 or later, with the GPLv3 Section 7 additional requirements inherited from HMCL:
- When distributing a modified version of this program, you must reasonably change its name or version number so that
it can be distinguished from the original version (under
GPLv3 Section 7(c)). The program name and version are defined in
Metadata.java. - You must not remove copyright notices displayed by the program (under GPLv3 Section 7(b)).
The complete licensing terms are provided in LICENSE and in the copyright and license notices of individual source files.