LCE Emerald Launcher

FOSS cross-platform launcher for Minecraft Legacy Console Edition

---

Main Screen	Versions Menu	Workshop

---

Table of Contents

• Overview
• Features
• Installation
  • Windows
  • macOS
  • GNU/Linux
• Game Versions & Partnerships
• Building from Source
• Troubleshooting
• Acknowledgments
• 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 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

---

Game Versions & Partnerships

LCE 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
Hellish Ends	DeadVoxelx	GitHub	Modded build that overhauls Nether and End

---

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)

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

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

---

License

This project is licensed under the GNU GPL v3 License.