LCE Emerald Launcher

FOSS cross-platform launcher for Minecraft Legacy Console Edition

• Overview
• Features
• Screenshots
• Installation
  • Windows
  • macOS
  • Linux
• Game Versions & Partnerships
• Building from Source
• Troubleshooting
• Roadmap
• Acknowledgments
• License

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.

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.

Download the latest release from GitHub Releases:

⚠️ 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"

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"

Multiple distribution formats available:

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

• 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)

# Clone the repository
git clone https://github.com/LCE-Hub/LCE-Emerald-Launcher.git
cd Emerald-Legacy-Launcher

# Install dependencies
pnpm install

# Development mode
pnpm tauri dev

# Production build
pnpm tauri build

Flatpak Build:

pnpm flatpak

# Remove quarantine attributes
xattr -cr /path/to/Emerald\ Legacy\ Launcher.app

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

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

• Connect controller before launching the launcher
• PlayStation controllers are not supported in-game but work in launcher. Use Steam Input.

Track our progress and upcoming features on the Development Roadmap.

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

This project is licensed under the GNU GPL v3 License.