LegacyLauncher

A custom launcher for Minecraft Legacy Console Edition.

The interface of Legacy Launcher v3.0.1

Features

🔄 Automatic Updates Fetches and installs the latest releases directly from GitHub repositories.	💻 Multi-Platform Support Compatible with Windows 10 64-bit+, Linux, and macOS Big Sur+.
👤 Profile Management Persistent storage for usernames and automated playtime tracking.	⚙️ Advanced Launch Control over connection parameters, IPs, ports, and headless server mode.

---

Getting Started

🚀 Standard Download Visit the Latest Releases page and download the appropriate package for your system: Windows 10 64-bit+: LegacyLauncher.Setup.(version).exe Linux: LegacyLauncher-(version).AppImage macOS Big Sur+: LegacyLauncher-(version)-arm64.dmg

🛠️ Development & Contribution To build from source or contribute to the project, ensure you have Node.js installed and follow these steps: Clone the repository Run npm install Run npm start to test

Compiling Executables

If you wish to package the launcher yourself, use the following commands based on your target platform:

Platform	Command	Output Format
Windows 10 64-bit+	npm run dist:win	.exe Setup
Linux	npm run dist	.AppImage Binary
macOS Big Sur+	npm run dist:mac	.dmg Disk Image

---

Launcher Options

Customize your experience via the Options menu within the launcher.

Setting	Description
Installation Directory	The local path where game files are stored
GitHub Repository Source	The repository used to fetch game updates
Client Executable Name	The specific filename the launcher attempts to execute
Launcher Music Volume	Adjust the background audio level of the launcher
Connect/Bind IP	Specify a custom IP address for network connections
Port	Define the network port for multiplayer sessions
Launch as Headless Server (-server)	Launch the client without a GUI for server hosting
Use Classic Minecraft Launcher UI	Replaces the modern GUI with a layout inspired by the 2013 launcher

---

System Requirements

Windows Windows 10 64-bit or Windows 11

Linux Wine is required to run Windows binaries

macOS macOS Big Sur or newer (Apple Silicon)

Linux Setup

The .AppImage is designed to work across all distributions. To run Windows binaries, you must install the Wine compatibility layer using your package manager:

Distribution	Command
Ubuntu / Debian / Mint	sudo apt install wine
Fedora	sudo dnf install wine
Arch / Manjaro	sudo pacman -S wine
openSUSE	sudo zypper install wine

---

Technical Stack

Built With: Electron • Node.js • Tailwind CSS • Discord RPC

Development Components: HTML5 • CSS3 • JavaScript • Electron Builder

---

Troubleshooting

Common Solutions: Repository Error: Verify the name in Options Executable Error: Check if filename matches download Launch Failure: Verify Wine is installed on your system Discord Error: Ensure Discord is open with RPC enabled

Linux Specifics: Wine Check: Run wine --version to verify install AppImage Permissions: chmod +x LegacyLauncher-*.AppImage

Contributing

Feel free to submit Issues and Pull Requests to help improve the launcher!

Star History