|
1 | | -# LeviLauncher |
| 1 | +<p align="center"> |
| 2 | + <img src="build/appicon.png" alt="LeviLauncher" width="96"> |
| 3 | +</p> |
| 4 | +<h1 align="center">LeviLauncher</h1> |
| 5 | +<p align="center">Minecraft Bedrock Edition GDK Launcher for Windows</p> |
2 | 6 |
|
3 | | -A launcher specifically developed for Minecraft Bedrock Edition GDK version. |
| 7 | +<p align="center"> |
| 8 | + <a href="https://github.com/LiteLDev/LeviLauncher/releases"><img alt="GitHub Release" src="https://img.shields.io/github/v/release/LiteLDev/LeviLauncher?style=flat-square&color=blue"></a> |
| 9 | + <a href="https://github.com/LiteLDev/LeviLauncher"><img alt="License" src="https://img.shields.io/github/license/LiteLDev/LeviLauncher"></a> |
| 10 | + <a href="https://github.com/LiteLDev/LeviLauncher/issues"><img alt="Issues" src="https://img.shields.io/github/issues/LiteLDev/LeviLauncher?style=flat-square&color=red"></a> |
| 11 | + <a href="https://github.com/LiteLDev/LeviLauncher"><img alt="Stars" src="https://img.shields.io/github/stars/LiteLDev/LeviLauncher?style=flat-square&color=yellow"></a> |
| 12 | + <a href="https://www.microsoft.com/windows"><img alt="Windows 10/11" src="https://img.shields.io/badge/Windows-10%2F11-green?style=flat-square&logo=windows"></a> |
| 13 | +</p> |
4 | 14 |
|
5 | | -## Project Status |
| 15 | +<p align="center"> |
| 16 | + <a href="https://discord.gg/v5R5P4vRZk"><img alt="Discord" src="https://img.shields.io/discord/849252980430864384?style=for-the-badge&logo=discord"></a> |
| 17 | + <a href="https://qm.qq.com/q/1z791rJgJG"><img alt="QQ Group 458083875" src="https://img.shields.io/badge/458083875-red?style=for-the-badge&logo=qq"></a> |
| 18 | +</p> |
6 | 19 |
|
7 | | -🚧 **Under Development** - This project is currently in active development. Features are not yet complete and instability may occur. |
| 20 | +<p align="center"> |
| 21 | + <sup>🌐 Language: <b>English</b> • <a href="./README.zh-CN.md">中文</a></sup> |
| 22 | +</p> |
8 | 23 |
|
9 | | -## Issue Reporting |
| 24 | +A desktop launcher for Minecraft Bedrock Edition (GDK) on Windows. |
10 | 25 |
|
11 | | -If you encounter any problems or have suggestions for improvement, please report them by: |
| 26 | +Supports installing, managing, and launching Release/Preview builds. Provides version isolation, content management (worlds/resource packs/behavior packs/skin packs), mod management, and world backup tools. Frontend uses React + Vite + Tailwind; backend uses Go with Wails v3. |
12 | 27 |
|
13 | | -1. Visiting the project's [Issues page](https://github.com/LiteLDev/LeviLauncher/issues) |
14 | | -2. Clicking the "New Issue" button |
15 | | -3. Providing a detailed description of the problem or suggestion |
| 28 | +**Project Status** |
| 29 | +- 🚧 Actively under development; features may be incomplete and unstable. |
16 | 30 |
|
17 | | -### When submitting an issue, please provide: |
18 | | -- Operating system version |
19 | | -- Launcher version number |
20 | | -- Detailed description of the problem |
21 | | -- Steps to reproduce (if applicable) |
22 | | -- Error logs or screenshots (if available) |
| 31 | +**Scope** |
| 32 | +- Targets Minecraft GDK (Windows). Does not provide cracking or bypassing official checks. |
| 33 | + |
| 34 | +**Repository** |
| 35 | +- https://github.com/LiteLDev/LeviLauncher |
| 36 | + |
| 37 | +**Downloads** |
| 38 | +- GitHub Releases: https://github.com/LiteLDev/LeviLauncher/releases |
| 39 | +- Lanzou Cloud: https://levimc.lanzoue.com/b016ke39hc (Password: `levi`) |
| 40 | + |
| 41 | +**Issue Reporting** |
| 42 | +- Open issues at https://github.com/LiteLDev/LeviLauncher/issues |
| 43 | +- Include OS version, launcher version, repro steps, and logs/screenshots. |
| 44 | + |
| 45 | +**Features** |
| 46 | +- Version management: install, delete, rename, quick launch; supports Release and Preview. |
| 47 | +- Version isolation: redirect game data to `versions/<name>/Minecraft Bedrock (Preview)`, separate from AppData. |
| 48 | +- Content management: count and manage worlds/resource/behavior/skin packs; quick open and drag-and-drop import. |
| 49 | +- Mods: import `.zip`/`.dll`, enable/disable/delete; auto prepare dependencies and preloader. |
| 50 | +- World tools: backup to `.mcworld`, edit `level.dat` fields and world name. |
| 51 | +- Downloads & mirrors: built-in mirror latency test and selection; local installer import; progress view. |
| 52 | +- Shortcuts: create desktop shortcut for a version; custom icon support. |
| 53 | +- Updates: check, download, install updates; elevate when necessary. |
| 54 | +- Languages: English and Simplified Chinese. |
| 55 | + |
| 56 | +**Requirements** |
| 57 | +- OS: Windows 10/11. |
| 58 | +- Required components: Microsoft Gaming Services, Microsoft GameInput (guided on first run). |
| 59 | +- WebView2 Runtime: provided by installer or system. |
| 60 | + |
| 61 | +**Quick Start (Dev)** |
| 62 | +- Dependencies: |
| 63 | + - Go `1.24+` (see `go.mod`). |
| 64 | + - Node.js `18+` (for frontend). |
| 65 | + - Wails v3 CLI: `go install github.com/wailsapp/wails/v3/cmd/wails3@latest` |
| 66 | +- Dev mode: |
| 67 | + - From project root: `wails3 dev -config ./build/config.yml -port 1145` |
| 68 | + - Or run frontend separately: `cd frontend && npm install && npm run dev` |
| 69 | +- Build: |
| 70 | + - `wails3 task build` |
| 71 | + - Windows specific: `wails3 task windows:build` |
| 72 | +- Run: |
| 73 | + - `wails3 task run` |
| 74 | + |
| 75 | +**Packaging (Windows)** |
| 76 | +- NSIS installer: `wails3 task windows:package` (default `FORMAT=nsis`) |
| 77 | +- MSIX: |
| 78 | + - Tools: `wails3 task windows:install:msix:tools` |
| 79 | + - Build: `wails3 task windows:package FORMAT=msix` |
| 80 | + |
| 81 | +**Structure** |
| 82 | +- `frontend/`: React + Vite app (`package.json`, `src/`, `assets/locales/`). |
| 83 | +- `internal/`: backend logic (versions, content, update, registry, etc.). |
| 84 | +- `build/`: cross-platform packaging and Taskfiles. |
| 85 | +- `main.go`: entry point; embeds frontend assets and creates the window. |
| 86 | + |
| 87 | +**CLI Args** |
| 88 | +- `--launch=<version_name>`: launch the specified version and exit. |
| 89 | +- `--self-update=<current_version>`: start elevated self-update when the install dir is not writable. |
| 90 | + |
| 91 | +**Community** |
| 92 | +- Discord: `https://discord.gg/v5R5P4vRZk` |
| 93 | +- QQ Group: `458083875` (`https://qm.qq.com/q/1z791rJgJG`) |
| 94 | + |
| 95 | +**FAQ** |
| 96 | +- Missing GameInput: install `GameInputRedist.msi` when prompted. |
| 97 | +- Missing Gaming Services: install via Microsoft Store. |
| 98 | +- Isolation & inherit: enable isolation during install; copy data from same-type isolated version or GDK directory. |
| 99 | +- Non-writable directory: change base content path in Settings or install/update with elevation. |
| 100 | +- Language switch: Settings supports English/zh-CN. |
| 101 | + |
| 102 | +**Contributing** |
| 103 | +- PRs and issues are welcome. |
| 104 | + |
| 105 | +**Acknowledgements** |
| 106 | +- Thanks to the community for support and contributions. |
0 commit comments