LCE Emerald Launcher
FOSS cross-platform launcher for Minecraft Legacy Console Edition
Important
macOS support for LCE Emerald Launcher is currently in Beta. Expect minor bugs, frequent updates, and features that are still being polished as we work toward a stable release.
Table of Contents
- Overview
- Features
- Screenshots
- Installation
- Game Versions & Partnerships
- Building from Source
- Troubleshooting
- Roadmap
- Acknowledgments
- License
Overview
Emerald Legacy Launcher is a high-performance, open-source launcher for Minecraft Legacy Console Edition (LCE). Built to centralize the fragmented LCE scene, it provides a lightweight, unified hub for playing your favorite console versions of Minecraft on PC.
Why Emerald? Traditional launchers often rely on bloated frameworks, consuming excessive resources. Emerald utilizes a modern Rust/Tauri architecture, using only ~15MB of RAM — leaving your PC's resources dedicated to the game itself.
The project started as a solo effort and has grown into a collaborative community project, bringing together expertise from various LCE preservation initiatives.
Features
Core Features
| Feature | Description |
|---|---|
| Automated Setup | One-click installation for TU19, Legacy Evolved, Revelations, and 360Revived versions |
| Cross-Platform | Native support for Windows, macOS (Intel & Apple Silicon), and Linux |
| Lightweight | Very light RAM usage thanks to Rust backend and Tauri framework |
| Easy Configuration | Built-in settings for username, game parameters, and profiles |
Advanced Features
| Feature | Description |
|---|---|
| 3D 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 fallback included) |
| Discord Rich Presence | Show your current activity and game status on Discord |
| Workshop and modloader | (Coming Soon) Community content and mod browser |
Game Versions & Partnerships
Emerald Legacy Launcher integrates multiple community-driven builds of Minecraft Legacy Console Edition. Each build brings unique features and improvements to the classic LCE experience.
Available Builds
| Build | Developer | Platform | Description |
|---|---|---|---|
| Revelations | @itsRevela | GitHub | Enhanced LCE with uncapped FPS, graphics fixes, hardcore hearts, and dedicated server security. Features LAN multiplayer, split-screen, and keyboard & mouse support. |
| 360 Revived | @BluTac10 | GitHub | PC port of Xbox 360 Edition TU19 with desktop optimizations. Features keyboard & mouse, fullscreen, LAN multiplayer, dedicated server, and split-screen support. |
| neoLegacy | @pieeebot | GitHub | Backports newer title updates to LCE TU19 base. And Minigames. |
Screenshots
Installation
Windows
Download the latest release from GitHub Releases:
| Format | Best For |
|---|---|
.exe (NSIS) |
Standard installation with uninstaller |
.msi |
Enterprise/IT deployment |
⚠️ Windows SmartScreen Warning:
Since the launcher is unsigned, Windows may show a "Windows protected your PC" warning. To proceed:
- Click "More info"
- Click "Run anyway"
macOS
| Format | Architecture |
|---|---|
.dmg (x64) |
Intel Macs |
.dmg (aarch64) |
Apple Silicon (M1/M2/M3) |
Installation Steps:
- Download the appropriate DMG for your Mac
- Open the DMG and drag the app to Applications
- If you see "app is damaged" error:
- Right-click the app → Open → confirm Open
- Or run:
xattr -cr "/Applications/Emerald Legacy Launcher.app"
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 |
Flatpak Installation:
flatpak install emerald.flatpak
Dependencies (if building from source):
# 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
Requirements
- Node.js (LTS recommended)
- Rust (latest stable)
- PNPM (recommended) or NPM
- Platform-specific dependencies:
- Linux:
WebKit2GTK-4.1 - macOS: WebKit (pre-installed)
- Windows: Edge WebView2 Runtime (usually pre-installed)
- Linux:
Build Steps
# Clone the repository
git clone https://github.com/Emerald-Legacy-Launcher/Emerald-Legacy-Launcher.git
cd Emerald-Legacy-Launcher
# Install dependencies
pnpm install
# Development mode
pnpm tauri dev
# Production build
pnpm tauri build
Flatpak Build:
pnpm flatpak
Troubleshooting
macOS "App is Damaged" Error
# Remove quarantine attributes
xattr -cr /path/to/Emerald\ Legacy\ Launcher.app
Linux WebView Issues
Ensure WebKit2GTK-4.1 is installed:
# Check installation
pkg-config --modversion webkit2gtk-4.1
# Reinstall if needed
sudo apt install --reinstall libwebkit2gtk-4.1-0
Game Not Launching
- Verify game files are properly installed via the launcher
- Check that Wine/Proton is installed (Linux only)
- Check that Wine/GPTK3 are installed (macOS only)
- Ensure your GPU drivers are up to date
Controller Not Detected
- Connect controller before launching the launcher
- Xbox and PlayStation controllers are best supported
Roadmap
Track our progress and upcoming features on the Development Roadmap.
Acknowledgments
Proudly developed by a passionate team from the LCE community.
- 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
- Tauri & Rust Communities — Core technologies and ecosystem
License
This project is licensed under the GNU GPL v3 License.
You are free to:
- Use — Use the launcher for any purpose
- Study — Access and study the source code
- Share — Redistribute copies
- Improve — Submit improvements and modifications
See LICENSE file for full terms.