Namespaces

Variants

Share

Share
Views
Actions

Minecraft launcher

From Minecraft Wiki
Jump to: navigation, search
This article may need cleanup to meet quality standards.
Please help improve this if you can. The talk page may contain suggestions.
[edit]Minecraft Launcher
Launcher.png
Current Version

1.4.4

Platforms

Windows, Mac OS X, Linux

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 from any era, however some versions are still not included on the launcher ( Indev, Minecraft 2.0 and any of the Beta 1.9 Pre-releases for example).

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.

Contents

[edit] 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.

[edit] Command-line usage

minecraft.jar (all systems):

java -cp minecraft.jar net.minecraft.LauncherFrame <username> <password> <server:port>


minecraft.exe (Windows executable):

minecraft.exe <username> <password> <server:port>

minecraft.jar (Windows - no CMD window):

javaw -cp minecraft.jar net.minecraft.LauncherFrame <username> <password> <server:port>

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

--username=<username> or -u=<username> --password=<password> or -p=<password>

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.

--noupdate


[edit] 1.6 Launcher

The login screen of the 1.1.1 Minecraft 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.4.4.

[edit] Features

  • Manage multiple profiles (stored in "launcher_profiles.json"). Each profile can control:
    • Game version. Includes access to outdated development builds and previous releases. You can also add older/custom versions manually[1]. See this video for instructions.
    • 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.

[edit] Time Machine

A profile with Alpha and Beta versions enabled

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 all Release versions are available to play. Four Pre-classic versions, four Classic versions, and an Infdev version are already added under the names "old-alpha version".[2] However, Indev is still missing.

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 may be unstable. Any bugs, glitches, missing features, or crashes that result from instability will never be resolved as only later versions are supported. Mojang strongly recommends that you play them in separate directories than your other saves to avoid corruption.[3]

[edit] Command-line usage

MinecraftDev.jar (all systems):

java -cp Minecraft.jar net.minecraft.bootstrap.Bootstrap <username> <server:port>

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

java -jar Minecraft.jar -help

[edit] History

Launcher version Release date Summary of changes
1.4.4 May 19, 2014
  • Fixed: MCL-2494 – Launcher version 1.4.2 possibly broken?
1.4.2 May 2, 2014
  • Made loading bar display file currently being downloaded
  • Fixed: MCL-2350 – Slowly eats large amounts of heap
  • Removed tab 'Local Version Editor (NYI)'
  • Auto cleanup unused libraries
1.3.11 March 12, 2014
  • New scrollbar
  • Profiles are now displayed in alphabetical order
1.3.10 February 13, 2014
  • Libraries use SHA-1 for validation
1.3.9 January 24, 2014
  • Updated bug tracker links
1.3.8 January 8, 2014
  • Added "(Why can I only play demo?)" link for demo accounts, under the "play demo" button. The link redirects you here
1.3.7 December 12, 2013
  • Unknown
1.3.6 December 5, 2013
  • Fixed: MCL-1895 – Cannot play offline in 1.3.5 version - immediately gamecrash when launching
1.3.5 December 4, 2013
  • Rearranged the assets folder for the new Assets Management System.[4]
1.3.4 November 26, 2013
  • Faster downloading of some big files.[5]
1.3.3 November 20, 2013
  • (Possible) Bridging of Mojang and Twitch accounts.[6]
1.3.2 November 18, 2013
  • Added time it took to finish jobs.
  • Faster resource downloading.[7]
1.3.1 October 29, 2013
  • Speed improvements
  • Basic read-only popup on version list tab
  • Misc fixes and cleanups
1.2.8 October 25, 2013[citation needed]
  • Unknown
1.2.7[citation needed] October 18, 2013
  • Added an open game directory button in the profile editor.
1.2.6[citation needed] October 17, 2013
  • Unknown
1.2.5[citation needed] September 23, 2013
  • No longer displays the developer console automatically after clicking "Play".[citation needed]
1.2.4[citation needed] September 19, 2013
  • Unknown
1.2.3[8] September 12, 2013
  • You can now log out from everywhere with the launcher (MCL-1270)
1.2.2[9] September 3, 2013
  • Fixed a bug (MCL-1461) that made the launcher take a long time to load up.
1.2.1 (Files uploaded)[10] August 6, 2013
1.2.1 (Files uploaded)[11][12] August 6, 2013
1.2.1 August 2, 2013
  • Added a warning about using Beta, Alpha, and snapshot versions
1.2 August 1, 2013
  • Added a "Time Machine" feature to use Beta versions.
    • An option for Alpha has been included but the versions are not available yet.
  • Also allows players to play versions 1.2.5-1.4.7
1.1.4 July 31, 2013
  • Some small text updates
1.1.3[13] July 27, 2013
  • Fixed low FPS issues on Intel HDXXXX chipsets.
1.1.2 July 22, 2013
1.1.1 July 19, 2013
  • New-look launcher and login screen
  • Launcher now closes automatically when game window opens
1.0.10 July 12, 2013
  • Further support for Hopper
  • Client crashes can be flagged as Public
    • Nothing is currently done with these
  • Profiles have the option to disable Hopper support
  • Reporting directly to the bug tracker is only allowed if Hopper is turned off or the launcher can't connect to Hopper
    • Hopper will not send crash report to bug tracker if the game is modded
1.0.9 July 10, 2013
  • Added support for the new crash-reporting system, Hopper[14]
    • Any client crash will automatically submit the crash report
1.0.8 OS X (Re-upload)[15] July 9, 2013
  • Fixes to the launcher having trouble playing 1.6.2 on OS X 10.5.8 (Leopard)
1.0.8 OS X (Re-upload)[16] July 8, 2013
  • Fixes to the launcher having trouble playing 1.6.2 on OS X 10.5.8 (Leopard)
1.0.8 July 2, 2013
  • The launcher now has a high-definition icon[citation needed]
  • Mac OS X 10.5.8 users have had Minecraft 1.6.1 disabled pending a LWJGL fix, however 1.5.2 is not affected[17]
1.0.7 July 2, 2013
  • Added ability to disable automatic login[18]
1.0.6 July 1, 2013
Bug fixes:
  • MCL-92 – Starting Window Size does not fit entire GUI
  • MCL-227 – Play button not in frame @ Linux
  • MCL-262 – Text does not fit in window
  • MCL-287 – Launcher gui has limited visuals, can't select version - no access to tabs
  • MCL-596 – Incorrect version in new Mac launcher
  • MCL-696 – I don't see an option to change RAM in "Edit Profile"
1.0.5 July 1, 2013
  • Added a 'snapshot' setting in the profile editor, enabling/disabling snapshots.
  • 'Minecraft.exe'(launcher) has been digitally signed. (MCL-546)
1.0.4 June 28, 2013
  • Added a 'resolution' setting in the profile editor.
1.0.3 June 27, 2013
Bug fixes:
  • MCL-587 – Full game can be played with non-premium account
  • MCL-600 – Launcher gives wrong message when you sign in with username instead of email.
1.0.2 June 27, 2013
  • Unknown


1.0.1 June 26, 2013
  • Yggdrasil authentication re-deployed
    • Fixed: MCL-568 – Migrated Account - Can't login in 1.6 prerelease on 1.0.1 launcher
1.0.0 June 26, 2013
  • Launcher downgraded to 1.0.0
  • Disabled Yggdrasil because of login error
1.0.1 June 26, 2013
  • Enabled Yggdrasil, The new auth system
  • More secure and much more featureful.
1.0 June 25, 2013
  • Unknown
0.9.5 June 18, 2013
  • Unknown
0.9.4 June 18, 2013
  • Added "New Profile" and "Edit Profile" Buttons to the profile selection panel
0.9.3 June 14, 2013
  • Unknown
0.9.2 June 13, 2013
  • Unknown
0.9.1 June 10, 2013
  • Fixed: MCL-412 – OS X: Exception in thread "main" java.lang.NoClassDefFoundError: net/minecraft/client/main/Main
0.9 June 10, 2013
  • Now includes a Profile Editor tab.
    • Choosing the game's version can only be done by double clicking your profile and changing the version in the drop down list.
  • Changes to the Version Selector area.
0.8.3 June 7, 2013
  • Unknown
0.8.2 May 27, 2013
  • Unknown
0.8.1 May 21, 2013
  • Client window now uses Crafting Table icon for main window when a snapshot build is selected; Launcher window still uses Grass Block icon
    • Selecting release builds on Windows currently uses the basic Java icon
0.8 May 20, 2013
  • Unknown
0.7.2 May 15, 2013
  • Unknown
0.7 May 13, 2013
  • Launcher downgraded to 0.7
0.7.1 May 4, 2013
  • Unknown
0.7 May 2, 2013
  • Unknown
0.6 April 25, 2013
  • Unknown
0.5 April 23, 2013
  • Added 1.5.1 to the list of available versions in the launcher
0.4 April 23, 2013
  • Re-enabled crash reporting


0.3 April 22, 2013
  • Added Local Version Editor (NYI) tab to the launcher
  • Added window to check server status
  • Small bug fixes
0.2 April 19, 2013
  • Added Development Console tab to the launcher
  • Fixed starting game trouble
0.1 April 18, 2013 * .minecraft directory structure is changed:
    • "assets" folder; stores resources such as language packs and sounds.
      • All music discs now use .ogg format instead of .mus format.
    • "library" folder; stores Java libraries such as LWJGL and jinput.jar.
    • "versions" folder; there are file "versions.json" (meta data) and folders that stores minecraft.jar for each versions (but its name is same as its version. e.g. for 13w16a, "versions/13w16a/13w16a.jar").
Alpha
1.0.0 Initial release. In this version users can choose not only the current version but also Infdev.
Beta
1.3 (Client/Launcher Update) Added official links, community links and twitter links.
Added command line argument support.
Official release
1.1 Released in February 21, 2011.[21]
Now uses new Minecraft logo.
Added capability of automatic login to the game and/or server by command line arguments.
Added smarter update system that only updates changed files, prompts the user to update, allows HTTPS logins for a more secure connection, and offers general UI improvements. A technical sneak preview was published by Notch on February 18, 2011.[19]
Link to the Minecraft install directory for easy access.
Add Force Update button under the Options dialog.
The launcher also featured an inline "changelog" via a Tumblr called MCUpdate, and supports command-line arguments.[20]
1.2.1 Properly selects 64-bit Java installations for Mac OS X users.[22]
1.3.2 Added ability to launch demo mode for non-premium users.
1.6 13w16a New launcher added. See launcher history above.

[edit] Gallery

[edit] References

[edit] See also