LCE Emerald Launcher Logo

LCE Emerald Launcher

FOSS cross-platform launcher for Minecraft Legacy Console Edition

Version License Platforms

Donate to the Project Join the Community

--- | Main Screen | Versions Menu | Workshop | |-------------|---------------|----------| | image | image | image | --- ## Table of Contents - [Overview](#overview) - [Features](#features) - [Installation](#installation) - [Windows](#windows) - [macOS](#macos) - [GNU/Linux](#gnulinux) - [Building from Source](#building-from-source) - [Troubleshooting](#troubleshooting) - [Acknowledgments](#acknowledgments) - [License](#license) --- ## Overview LCE Emerald Launcher is the easiest way to play Minecraft Legacy Console Edition on PC. Install community builds, manage versions, customize skins, and launch instantly from one lightweight hub. **Why Emerald?** Traditional launchers often rely on bloated frameworks, consuming excessive resources. Emerald utilizes a modern **Tauri** architecture, using only a low amount of RAM, leaving your PC's resources dedicated to the game itself. --- ## Features | Feature | Description | |---------|-------------| | **Automated Setup** | One-click installation for neoLegacy, Revelations, 360 Revived, and Hellish Ends | | **Cross-Platform** | Native support for Windows, macOS (Intel & Apple Silicon), and Linux (Steam Deck is also supported!) | | **Lightweight** | Very light RAM usage thanks to Rust backend and Tauri framework | | **Easy Configuration** | Built-in settings for username, game parameters, and profiles | | **Skin Viewer** | Interactive skin preview using Three.js with layer support | | **Custom Skins** | Import and manage your own skins with local storage | | **Controller Support** | Full gamepad navigation support (keyboard support included) | | **Discord Rich Presence** | Show your current activity and game status on Discord | | **Workshop** | Community content like DLCs, Textures, Skins and more | | **Free Multiplayer** | Powered by LCELive, Emerald provides a free multiplayer service so you can play with anyone without port forwaring! | --- ## Installation ### Windows | Format | Best For | |--------|----------| | `.exe` (NSIS) | Standard installation with uninstaller | | `.msi` | A fallback option in case the `.exe` does not work | **⚠️ Windows SmartScreen Warning:** > Since the launcher is unsigned, Windows may show a "Windows protected your PC" warning. To proceed: > 1. Click **"More info"** > 2. Click **"Run anyway"** ### macOS | Format | Architecture | |--------|-------------| | `.dmg` (x64) | Intel Macs | | `.dmg` (aarch64) | Apple Silicon (M-series and A-series) | **Installation Steps:** 1. Download the appropriate DMG for your Mac 2. Open the DMG and drag the app to Applications 3. If you see "app is damaged" error: - Right-click the app → **Open** → confirm **Open** - Or run: `xattr -cr "/Applications/Emerald Legacy Launcher.app"` ### GNU/Linux Multiple distribution formats available: | Format | Distribution | |--------|------------| | `.deb` | Debian, Ubuntu, Linux Mint | | `.rpm` | RHEL, Fedora, openSUSE | | `.AppImage` | Universal (no installation required) | | `.flatpak` | Universal with sandboxing (recommended over AppImage) | **AUR:** Special thanks to [AntiApple4life](https://aur.archlinux.org/packages?O=0&SeB=m&K=AntiApple4life) for the AUR packages! ```bash # git version paru -S emerald-legacy-launcher-git # or yay # stable version paru -S emerald-legacy-launcher # or yay # binary stable version paru -S emerald-legacy-launcher-bin # or yay ``` **Flatpak Installation:** ```bash flatpak install emerald.flatpak ``` **Dependencies (if building from source):** ```bash # Ubuntu/Debian sudo apt install libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf libudev-dev # Fedora sudo dnf install webkit2gtk4.1-devel libappindicator-gtk3-devel librsvg2-devel patchelf systemd-devel ``` --- ## Building from Source Refer to [BUILDING.md](BUILDING.md). --- ## Troubleshooting ### macOS "App is Damaged" Error ```bash # Remove quarantine attributes xattr -cr /path/to/Emerald\ Legacy\ Launcher.app ``` ### Linux WebView Issues Ensure WebKit2GTK-4.1 is installed: ```bash # Check installation pkg-config --modversion webkit2gtk-4.1 # Reinstall if needed sudo apt install --reinstall libwebkit2gtk-4.1-0 ``` ### Game Not Launching 1. Verify game files are properly installed via the launcher 2. Check that Wine/Proton is installed (Linux only) 3. Check that Wine/GPTK3 are installed (macOS only) 4. Ensure your GPU drivers are up to date ### Controller Not Detected - Connect controller before launching the launcher - PlayStation controllers are not supported in-game but work in launcher. Use Steam Input. --- ## Acknowledgments - **The Emerald Team** - Technical development and maintenance - **4J Studios & Mojang** - Original creators of Legacy Console Edition - **The LCE Community** - Research and foundations for LCE on PC - **Veroxsity (Racoon)** - Original creator of LCELive --- ## License This project is licensed under the **[GNU GPL v3 License](LICENSE)**.