Skip to content

XianYuLauncher/XianYuLauncher

Repository files navigation

XianYu Launcher Readme Hero

XianYu Launcher

A modern, feature-rich Minecraft Java Edition launcher with a polished user interface.

Disclaimer: This project is unofficial and has no affiliation with Mojang Studios or Microsoft.

GitHub Stars GitHub Release Docs Online Bilibili QQ

English | 简体中文 | 繁體中文

✨ Features

🎮 Game Management

  • Smart Version Management: One-click installation for Minecraft Vanilla, Forge, Fabric, Legacy Fabric, NeoForge, Quilt, Optifine, Cleanroom, LiteLoader.
  • Version Isolation: Independent directories for each version, keeping Mods separate and interference-free.
  • World Management System: World overview, Data Pack management, one-click world launch.
  • Server Management: Add/manage servers, real-time status detection (MOTD, online players, latency), one-click instance launch and join server.

🔧 Smart Diagnosis & Repair

  • AI Crash Analysis: Compatible with OpenAI API services to intelligently analyze crash reasons (requires self-configuration of API Endpoint and Key).
  • XianYu Fixer: One-click repair for common issues (Java version mismatch, missing Mod dependencies, etc.).
  • Knowledge Base Matching: Built-in error knowledge base for quick problem localization and solutions.
  • Real-time Logs: Monitor game output in real-time with log export support.

📦 Resource Center

  • Dual Platform Support: Search and download resources from Modrinth + CurseForge.
  • Smart Dependency Management: Automatically identify and download dependency Mods to avoid dependency hell.
  • Favorites System: Collect favorite resources, supports import/export and batch installation.
  • Resource Types: Modpacks, Mods, Resource Packs, Shaders, Data Packs, Maps.
  • Modpack Update Support: Update installed modpacks to newer versions.

⚡ Performance Optimization

  • Segmented Download: Multi-threaded segmented downloading for significantly improved speeds.
  • Java Management: Auto-download and match appropriate Java versions (8/17/21...).
  • Caching Mechanism: Smart caching for resource icons and translation results to reduce network requests.

🌐 Online Features

  • Terracotta Integration: P2P Virtual LAN, allowing multiplayer without a public IP.

🎨 User Experience

  • Fluent Design: Native WinUI 3 interface for a modern and premium visual effect.
  • 3D Skin Preview: Built-in skinview3d for real-time character skin preview.
  • Multi-language Support: Simplified Chinese, English.
  • Dual Channel Update: Switch between Stable/Dev channels to experience new features early.

Getting Started

Prerequisites

  • Windows 10 1809 (17763) or later
  • .NET 10.0 SDK

Installation

Get it from Microsoft Store

Or manual installation:

  1. Download: Get the latest release from the Releases page.
  2. Extract: Unzip the downloaded package to your preferred location.
  3. Run: Launch XianYuLauncher.exe directly from the extracted folder.
  4. Legacy packaged builds: The 安装侧载 MSIX 包 guide now applies only to historical MSIX/AppInstaller distributions and is no longer the default SideLoad path.

Technology Stack

  • Framework: .NET 10.0
  • UI: WinUI 3
  • Architecture: MVVM with CommunityToolkit.Mvvm
  • Windows App SDK: 1.8.251106002

Open Source License

This project is released under a MIT License as open source.

For third-party libraries and data sources, please refer to NOTICE/NOTICE.md.

Open Source Statement

  • The project is open-sourced under the MIT License.
  • All open-sourced code is protected by the MIT License.

MIT License

For the full license text, please refer to the LICENSE file.

Contact


XianYu Launcher - Made with ❤️ for the Minecraft Community ☕