# 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