Minecraft Launcher



The Minecraft launcher is the login and downloader front-end to the stand-alone client. It is responsible for downloading the main Java packages, including minecraft.jar and LWJGL, which holds the code and resources of the game such as textures. It also acts somewhat like a basic and easily bypassable copy-restriction by forcing the user to login to a paid account when running for the first time. It has been part of the stand-alone client since its inception. It is possible to use the launcher to run versions of Minecraft since Indev.

There have been four different development stages for the launcher, the first for the Alpha version, the second since the release of Minecraft 1.0, the third since 1.2, and the fourth and current 1.6 Launcher. The launcher's design last changed on July 18, 2013.

Behavior
Every time the launcher is executed, it checks a specific directory where Minecraft stores its files called .minecraft. It checks a file called "launcher_profiles.json" for login credentials. If the file does not exist, is corrupt, or no user is logged in, the user must login with a valid premium account, otherwise the game will refuse to run.

When logging in, the launcher will first try to verify the login. If a valid "launcher_profiles.json" file exists but there is no internet connection, the launcher will offer a "Play offline" mode if a player was logged in when it was last closed. If the connection is successful, the launcher will then, depending on profile options, compare the latest version in the latest "versions" directory to the latest version reported by the server. If the selected version does not exist or the latest installed version is outdated when "Use latest version" is selected in the profile, the launcher will download all Minecraft components and Java binary files. It will also synchronize everything in the Assets folder (see Resource pack)

Finally, upon a successful update or installation, the launcher will execute "minecraft.jar" (via "javaw.exe", Oracle's Java Virtual Machine executable.) It is possible however for there to be missing ".jar" files, in which case the launcher will attempt to replace the missing files automatically but will stop if there is no connection.

Currently, Minecraft launcher supports only English. Users cannot select their preferred language.

Command-line usage
minecraft.jar (all systems):

minecraft.exe (Windows executable):

minecraft.jar (Windows - no CMD window):

As of the new launcher released with Minecraft 1.2.3, username and password options use a prefix.

""

If using a server:port it must still be the 3rd option. So if not used with username and password, dummy options need to be added in their place.

No update option also added.

""

1.6 Launcher
A new version of the launcher was released on April 18, 2013 (with snapshot 13w16a). It lets users choose the version they want to play, downloads all resources before launching the game and updates additional libraries (function previously unavailable). Later it will have more functionality as it currently is in its early development stage. Demo is available to non-premium users after a successful login. The launcher can automatically update itself; the most recent version is 1.2.7.

Features

 * Manage multiple profiles. Each profile can control:
 * Game version. Includes access to outdated development builds and previous releases. You can also add older/custom versions manually.
 * Mojang account used to play the game
 * Command line arguments for Java (such as heap size)
 * Game Directory (where the game files are saved on disk)
 * And so on.
 * The launcher doesn't store your password locally. Instead of this, it now uses a 'refresh token'.
 * Automatic updates for launcher.
 * Ability to update libraries, such as LWJGL.
 * Offline mode. (The first time launch requires an Internet connection to download required resources)
 * Currently only available in English.
 * Crashes can be reported to Mojang, through Hopper.
 * Crashes are now indexed through a database for information on how to fix the issue.

Time Machine
On August 1, 2013, the Minecraft launcher was updated to include the ability to play old Alpha and Beta versions of the game. Currently, Alpha, Beta, and Minecraft versions 1.0.0-1.6.4 are available to play, and Classic, Indev, and Infdev versions are planned to be added in the near future.

Progress

To enable the old versions either click the "Edit Profile" button or, preferably, create a new one. Under the "Version Selection" section choose to allow use of Alpha and/or Beta versions by ticking the appropriate boxes. Next, select the desired version from the drop-down menu and save the profile.

However, these versions are very out of date and some may be unstable. Any bugs, crashes, missing features, or other glitches will never be fixed in those versions. Mojang strongly recommends that you play them in separate directories to your other saves to avoid corruption.

Command-line usage
MinecraftDev.jar (all systems):

The 1.6 launcher also added some new commands, for the launcher. These are shown if you do

History
