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!

6 KiB Raw Blame History