Legacy Console Launcher

A lightweight launcher for the Minecraft Legacy Console PC Port.

It provides a simple way to launch the game, manage accounts and track playtime without needing to use the command line.

Download

Download the latest version from the Releases page:

https://github.com/OxyZin/LegacyConsoleLauncher/releases

Why this launcher?

Many launchers for the Legacy Console PC Port are built with heavy frameworks.
This project focuses on simplicity, speed and compatibility.

Lightweight

Built with WinForms and C#, the launcher starts instantly and uses very little memory compared to Electron-based launchers.

Compatible

Runs on Windows 7 and newer, making it usable on older systems and lightweight setups.

Simple and practical

No unnecessary features or complicated setup.
Just open the launcher, select your account and play.

Built for the community

Designed specifically for the Minecraft Legacy Console PC Port, with features that are useful for players and developers:

Account management
Playtime tracking
Automatic game detection
Simple configuration

Features

Multiple account support
Playtime tracking per account
Launch the game with a custom username
Fullscreen toggle
Automatically remembers saved accounts
Auto-detects the game executable
Manual game folder selection
Drag & drop support for:
- Minecraft.Client.exe
- the folder containing it
Opens the game folder directly from the launcher
Saves launcher settings automatically
Lightweight WinForms application

How to Use

Run LegacyConsoleLauncher.exe
Select or enter a username
(Optional) enable Fullscreen
Click Set Game Folder and select the folder containing:

Minecraft.Client.exe

Click Launch Game

You can also drag and drop either the game folder or Minecraft.Client.exe directly onto the launcher.

Data Storage

The launcher automatically creates the following files:

accounts.txt gamepath.txt

accounts.txt

Stores usernames and their playtime:

username|playtime_in_seconds

Example:

Steve|7200 Alex|3500

gamepath.txt

Stores the location of Minecraft.Client.exe.

Requirements

Windows 7 or newer
Minecraft Legacy Console PC Port

License

Updates

This file summarizes the update-related changes added to the project (see Form1.Updates.cs).

What was added

Automatic nightly-check helpers
- GetNightlyCommitAsync() downloads the release page and extracts the commit hash.
- GetInstalledCommit() / SaveInstalledCommit() read/write the installed commit from the release info file.
Download helpers with custom User-Agent and progress
- DownloadStringWithUserAgentAsync(string url) uses WebClient and sets a User-Agent header.
- DownloadFileWithProgressAsync(string url, string outputPath, string statusText) shows a progress UI while downloading and reports percentage updates.
Install and update flows
- InstallGameAsync() downloads the nightly ZIP, extracts it to a temporary folder, moves it into the install folder, detects the game executable and saves the installed commit.
- UpdateGameExeAsync() downloads the updated game executable, replaces the existing exe and saves the installed commit.
UI integration
- ShowProgressForm() / CloseProgressForm() manage a Form2 progress dialog (progressForm).
- CheckForUpdatesOnStartupAsync() checks for the latest nightly commit on startup and prompts the user to install/update (also toggles checkforLink visibility).
- checkforLink_LinkClicked is a manual trigger bound to a LinkLabel that installs/updates when clicked.

Error handling and cleanup

Both install and update flows perform cleanup of temporary files/directories and close the progress UI on exceptions. Exceptions are re-thrown to let calling UI show user-facing messages.

Notes for maintainers

The update code expects several fields to be present elsewhere in Form1 (declared in other partial files):
- nightlyReleaseUrl, nightlyZipUrl, nightlyExeUrl
- releaseInfoFile, gameInstallDir, exePath
- progressForm (type Form2) and checkforLink (type LinkLabel)
The project targets .NET Framework 4.7.2 and uses C# 7.3 language features.

How to test

Build the project in Visual Studio (target .NET Framework 4.7.2).
Run the launcher and confirm the startup update check logic runs (or trigger the checkforLink link).
Observe the progress dialog while downloads happen and verify that the game installs/updates and releaseInfoFile is written.

Star History

LegacyConsoleLauncher

Install / Use

README