7.2 KiB
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.
| Main Screen | Versions Menu | Workshop |
|---|---|---|
Table of Contents
- Overview
- Features
- Installation
- Game Versions & Partnerships
- Building from Source
- Troubleshooting
- Acknowledgments
- License
Overview
Emerald Legacy Launcher is a high-performance, open-source launcher for Minecraft Legacy Console Edition (LCE). Built to centralize the 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 Tauri architecture, using only ~15MB of RAM, leaving your PC's resources dedicated to the game itself.
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 |
| 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 |
Game Versions & Partnerships
Emerald 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 |
|---|---|---|---|
| neoLegacy | @pieeebot | GitHub | Backports newer title updates to LCE TU19 base. And Minigames. |
| 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. |
Installation
Windows
Download the latest release from GitHub Releases:
| 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:
- Click "More info"
- Click "Run anyway"
macOS
| Format | Architecture |
|---|---|
.dmg (x64) |
Intel Macs |
.dmg (aarch64) |
Apple Silicon (M-series and A-series) |
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"
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) |
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
Refer to BUILDING.md.
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
- 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
License
This project is licensed under the GNU GPL v3 License.