A custom launcher for Minecraft Legacy Console Edition.
- Minecraft-style GUI: Authentic pixelated interface with Minecraft font and styling
- Automatic Updates: Fetches latest releases from GitHub repositories
- Cross-platform Support: Works on Windows and Linux
- Profiles: Save your username and track playtime
- Custom Launch Options: Configure IP, port, and server mode
- Clone or download this repository
- Install dependencies:
npm install
- Run the launcher:
npm start
npm run distnpm run dist:winBy default, the launcher fetches releases from smartcmd/MinecraftConsoles. You can change this in the Options menu.
- GitHub Repository: Source repository for game releases
- Client Executable: Name of the executable file (default:
Minecraft.Client.exe) - Compatibility Layer: For Linux users - choose between direct execution, Wine, or Proton
- Connect/Bind IP: Optional IP address for multiplayer
- Port: Optional port number
- Server Mode: Launch as headless server
- Username: Your in-game player name
- Playtime Tracking: Automatically tracks total playtime
- Windows: Direct execution of Windows executables
- Linux: Wine or Proton for running Windows executables
- Internet: Required for downloading game updates
The launcher supports several compatibility options for Linux:
- Direct: Run native Linux executables (if available)
- Wine: Wine compatibility layer
- Proton: Steam's Proton compatibility layer
- Electron: Cross-platform desktop app framework
- discord-rpc: Discord Rich Presence integration
- extract-zip: ZIP archive extraction
- Tailwind CSS: UI styling (via CDN)
The launcher is built with:
- Frontend: HTML, CSS, JavaScript
- Backend: Electron with Node.js
- Styling: Custom CSS with Minecraft theme + Tailwind CSS
- Build: Electron Builder
- Repository not found: Check the repository name in Options
- Executable not found: Verify the executable name matches the downloaded file
- Launch failures: Try different compatibility layers on Linux
- Discord RPC issues: Ensure Discord is running and RPC is enabled
- Install Wine:
sudo apt install wine(Ubuntu/Debian) - For Proton: Requires Steam installation
- AppImage permissions:
chmod +x LegacyLauncher-*.AppImage
Feel free to submit issues and pull requests for improvements.