Toggle menu
Toggle preferences menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

Minecraft:Minecraft Launcher: Difference between revisions

From SAS Gaming Wiki
SyncBot (talk | contribs)
Sync: updated from Minecraft
SyncBot (talk | contribs)
Sync: updated from Minecraft
 
(6 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Italic title}}
{{Italic title}}
{{redirect|Launcher}}{{Infobox program
{{redirect|Launcher}}
{{Infobox program
|image=Minecraft Launcher.png
|image=Minecraft Launcher.png
|title=''Minecraft Launcher''
|title=''Minecraft Launcher''
|invimage =  
|invimage=
|developer=[[Minecraft:Mojang Studios]]
|developer=[[Minecraft:Mojang Studios]]
|platform = {{OS|win|mac|lin}}
|platform={{OS|win|mac|lin}}
|programming language = {{os|ts|react|C++}}<ref>{{tweet|dinnerbone|1037686466250530816| We're expanding our Minecraft Launcher team! We have a lot of exciting plans and are looking for another senior C++ developer to help make them happen. Know someone interested? Send them our way!|September 6, 2018}}</ref>
|programming language={{OS|ts|react|C++}}<ref>{{tweet|dinnerbone|1037686466250530816| We're expanding our Minecraft Launcher team! We have a lot of exciting plans and are looking for another senior C++ developer to help make them happen. Know someone interested? Send them our way!|September 6, 2018}}</ref>
|version ={{#if: {{v|launcher-beta}} | '''Release''':&nbsp;}}{{v|launcher}}{{#if: {{v|launcher-beta}} |<br>'''Beta''': {{v|launcher-beta}}}}
|version={{#if: {{v|launcher-beta}} | '''Release''':&nbsp;}}{{v|launcher}}{{#if: {{v|launcher-beta}} |<br>'''Beta''': {{v|launcher-beta}}}}
|size = {{OS|w10+}} ~10.13 MB
|size={{OS|w10+}} ~10.13 MB
|customlinks =
|customlinks=
* [https://minecraft.net/download minecraft.net]
* [https://minecraft.net/download minecraft.net]
* [https://xbox.com/games/store/-/9PGW18NPBZV5 Microsoft Store]
* [https://xbox.com/games/store/-/9PGW18NPBZV5 Microsoft Store]
|date = June 30, 2010
|date=June 30, 2010
|source available= No
|source available=No
}}
}}
[[File:Minecraft Launcher Xbox Horizontal Key Art.jpg|thumb|width=250x250|Key art by Mojang Studios]]
[[File:Minecraft Launcher Xbox Horizontal Key Art.jpg|thumb|width=250x250|Key art by Mojang Studios]]
Line 24: Line 25:
On the initial login screen, users must log in with a pre-existing Microsoft account, otherwise they can create a new one by clicking the link. Subsequent logins can be done in the "Settings" tab.
On the initial login screen, users must log in with a pre-existing Microsoft account, otherwise they can create a new one by clicking the link. Subsequent logins can be done in the "Settings" tab.


On the left side, a "News" tab, a tab for each game, and the ''Minecraft Launcher'' "Settings" tab can be seen.
On the left side, a "Home" tab, a tab for each game, and the ''Minecraft Launcher'' "Settings" tab can be seen.


The top left corner of the ''Minecraft Launcher'' contains the user's Xbox gamertag for the currently active account (which might differ from their ''Minecraft: Java Edition'' username)<ref>https://help.minecraft.net/hc/articles/360052640612</ref>. By clicking on it, users can manage or log out of their active account, and see a "Help" page with various links to helpful resources.
The top left corner of the ''Minecraft Launcher'' contains the user's Xbox gamertag for the currently active account (which might differ from their ''Minecraft: Java Edition'' username)<ref>https://help.minecraft.net/hc/articles/360052640612</ref>. By clicking on it, users can manage or log out of their active account, and see a "Help" page with various links to helpful resources.


== ''Minecraft: Java Edition'' ==
== ''Minecraft: Java Edition'' ==
[[File:Launcher JE tab.png|alt=The default view of the Minecraft: Java Edition on the Minecraft Launcher|thumb|The default view of the ''Minecraft: Java Edition'' on the Minecraft Launcher]] [[File:Launcher_Demo.png|alt=The Minecraft: Java Edition page on the Minecraft Launcher if you have not purchased the game yet.|thumb|The default view of the ''Minecraft: Java Edition'' on the Minecraft Launcher if you have not purchased the game yet.]]
[[File:Launcher JE tab.png|thumb|The default view of the ''Minecraft: Java Edition'' page in the ''Minecraft Launcher'']]
There are 5 tabs on the [[Minecraft:Java Edition]] page: Play, Installations, Realms, Skins, and Patch notes.  
[[File:Launcher_Demo.png|thumb|The default view of the ''Minecraft: Java Edition'' page in the ''Minecraft Launcher'' if the user has not purchased the game]]
There are 5 tabs on the {{JE}} page: Play, Installations, Realms, Skins, and Patch notes.


The main "Play" section allows the user to download (if needed) and launch ''[[Minecraft: Java Edition]]'' with the "Play" button, and also includes an installation selection on the left (which sorts installations by last played), the user's ''Java Edition'' username on the right, and a list of the latest news for the game from [[Minecraft:minecraft.net]] below.  
The main "Play" tab allows the user to download (if needed) and launch ''[[Minecraft: Java Edition]]'' with the "Play" button, and also includes an installation selection on the left (which sorts installations by last played), the user's ''Java Edition'' username on the right, and a list of the latest news for the game from [[Minecraft:minecraft.net]] below.


* One can launch multiple instances of the game by pressing the "Play" button while the game is running.  
* One can launch multiple instances of the game by pressing the "Play" button while the game is running.
* If the device is not connected to the internet, the game can be run in offline mode, but only if the game has been initially downloaded.
* If the device is not connected to the internet, the game can be run in offline mode, but only if the game has been initially downloaded.
* If the user isn't logged into an account that has purchased the game, the "Play" button appears as a "Buy Now" button that links to Buy Minecraft on Minecraft.net.
* If the user isn't logged into an account that has purchased the game, the "Play" button appears as a "Buy Now" button that links to Buy Minecraft on Minecraft.net.
There is also a "Patch notes" section where the patch notes of the game's update can be seen, including the snapshots (if enabled).


=== Installations ===
=== Installations ===
[[File:New Installation.png|thumb|Creating a new installation.]]
[[File:New Installation.png|thumb|Creating a new installation]]
{{anchor|Version Control}}
{{anchor|Version Control}}
<!--The anchor for the Version Control page. Please move this with the version control information or update that page if this one splits.-->
<!--The anchor for the Version Control page. Please move this with the version control information or update that page if this one splits.-->


In the "Installations" section, custom installations can be created and edited. There are buttons to sort and search installations, as well as checkboxes to enable installations with "Releases", "Snapshot", and "Modded" versions of the game. Installations are stored in [[Minecraft:launcher_profiles.json]] (or launcher_profiles_microsoft_store.json when using the new Minecraft Launcher for Windows) in the game's directory ([[Minecraft:.minecraft]]).
In the "Installations" tab, custom installations can be created and edited. There are buttons to sort and search installations, as well as checkboxes to enable installations with "Releases", "Snapshots", and "Modded" versions of the game. Installations are stored in [[Minecraft:launcher_profiles.json]] (in the game's directory ([[Minecraft:.minecraft]]).


By default, there are installations for the "Latest release" and for "Latest snapshot" (if enabled), both of which the game versions cannot be changed. A new installation can be created by clicking the "New installation" button and an existing installation can be edited by clicking on it. There is a "Play" button that launches the selected installation and a folder icon that takes to the installation's game directory. The ellipses button contains the options to edit, duplicate, or delete an installation.
By default, there are installations for the "Latest release" and for "Latest snapshot" (if enabled), both of which the game versions cannot be changed. A new installation can be created by clicking the "New installation" button and an existing installation can be edited by clicking on it. There is a "Play" button that launches the selected installation and a folder icon that takes to the installation's game directory. The ellipsis button contains options to edit, duplicate, or delete an installation.


On the create/edit installation page, the following can be changed:
On the create/edit installation page, the following can be changed:
Line 54: Line 54:
* Version, which includes access to older releases and snapshots (if enabled).
* Version, which includes access to older releases and snapshots (if enabled).
* Game directory, the location of where the game files are saved, the default being [[Minecraft:.minecraft]]. The location can be typed in or selected using the "Browse" button.
* Game directory, the location of where the game files are saved, the default being [[Minecraft:.minecraft]]. The location can be typed in or selected using the "Browse" button.
* Resolution, which changes the game's windows size. It has a list of resolutions, or a custom one can be typed in.
* Resolution, which changes the game's window size. It has a list of resolutions, or a custom one can be typed in.
* Java executable, by default uses the bundled java runtime.
* Java executable, by default uses the bundled Java runtime.
* JVM arguments, such as heap size or enabling [[Minecraft:debug renderer]]s not normally accessible in the [[Minecraft:debug screen]] such as mob pathfinding.
* JVM arguments, such as heap size or enabling [[Minecraft:debug renderer]]s not normally accessible in the [[Minecraft:debug screen]] such as mob pathfinding.


Before, it was possible for the users to manually set a [http://logging.apache.org/log4j/2.x/manual/configuration.html logging configuration] (see [[Minecraft:Minecraft Wiki:Projects/wiki.vg merge/Debugging|Debugging]] for more info), however this doesn't seem to work anymore.<ref>{{bug|MCL-17489||Launcher does not allow to use a custom Log4J configuration|Won't Fix}}</ref>
Previously, it was possible for users to manually set a [http://logging.apache.org/log4j/2.x/manual/configuration.html logging configuration] (see [[Minecraft:Minecraft Wiki:Projects/wiki.vg merge/Debugging|Debugging]] for more info), however, this doesn't seem to work anymore.<ref>{{bug|MCL-17489||Launcher does not allow to use a custom Log4J configuration|Won't Fix}}</ref>


A specific game version's server jar can also be downloaded by selecting the version in the list and pressing the "Server" button next to it.
A specific game version's server jar can also be downloaded by selecting the version in the list and pressing the "Server" button next to it.


=== Backward compatibility ===
=== Backward compatibility ===
[[File:HowtoOldVersion2019.png|thumb|Selecting older versions in the create new installation screen.]]
[[File:HowtoOldVersion2019.png|thumb|Selecting older versions in the create new installation screen]]
 
The ''Minecraft Launcher'' has the ability to play most older releases of the game (and older snapshots, if enabled) by default, but also some older versions prior to [[Minecraft:Java Edition 1.0.0]]. In order to see these versions in the "Installations" tab, the player must enable "Show historical versions of ''Java Edition''" in the ''Minecraft Launcher'' "Settings" tab. Because these versions are outdated and unsupported, they may contain bugs and errors that are not present in newer versions. It is recommended to run old versions of the game in a separate directory and backup worlds to avoid save corruption or other problems.<ref>{{cite|url=https://help.minecraft.net/hc/en-us/articles/360034754852-How-to-Change-Game-Version-for-Minecraft-Java-Edition|title=How to Change Game Version for Minecraft: Java Edition|website=Minecraft Help Center}}</ref>
The ''Minecraft Launcher'' has the ability to play most older releases of the game (and older snapshots, if enabled) by default, but also some older versions prior to [[Minecraft:Java Edition 1.0.0]]. In order to see these versions in the installations section, the player must enable "Show historical versions of ''Java Edition''" in the ''Minecraft Launcher'' settings tab. Because these versions are outdated and unsupported, they may contain bugs and errors that are not present in newer versions. It is recommended to run old versions of the game in a separate directory and backup worlds to avoid save corruption or other problems.<ref>{{cite|url=https://help.minecraft.net/hc/en-us/articles/360034754852-How-to-Change-Game-Version-for-Minecraft-Java-Edition|title=How to Change Game Version for Minecraft: Java Edition|website=Minecraft Help Center}}</ref>


Once historical versions are enabled, the following can be accessed:
Once historical versions are enabled, the following can be accessed:
* Most [[Minecraft:Java Edition Beta|Beta]] versions.  
* Most [[Minecraft:Java Edition Beta|Beta]] versions.
* Most [[Minecraft:Java Edition Alpha|Alpha]] versions. (however, [[Minecraft:Alpha v1.2.0]] and [[Minecraft:Alpha v1.2.1]] are duplicated from [[Minecraft:Alpha v1.2.0_02]] and [[Minecraft:Alpha v1.2.1_01]] respectively.)
* Most [[Minecraft:Java Edition Alpha|Alpha]] versions (however, [[Minecraft:Alpha v1.2.0]] and [[Minecraft:Alpha v1.2.1]] are duplicates of [[Minecraft:Alpha v1.2.0_02]] and [[Minecraft:Alpha v1.2.1_01]] respectively).
* One [[Minecraft:Infdev]] version.
* One [[Minecraft:Infdev]] version.
* Four [[Minecraft:Java Edition Classic|Classic]] versions.
* Four [[Minecraft:Java Edition Classic|Classic]] versions.
* Five [[Minecraft:pre-Classic]] versions (however [[Minecraft:rd-20090515]] is a duplicate from [[Minecraft:rd-161348]]).<ref>{{tweet|dinnerbone|364762596387205120|2 classic versions, an infdev version and a version before minecraft was called minecraft have been added to the launcher!|August 6, 2013}}</ref>
* Five [[Minecraft:pre-Classic]] versions (however, [[Minecraft:rd-20090515]] is a duplicate of [[Minecraft:rd-161348]]).<ref>{{tweet|dinnerbone|364762596387205120|2 classic versions, an infdev version and a version before minecraft was called minecraft have been added to the launcher!|August 6, 2013}}</ref>
This list of versions is populated by <code>[[Minecraft:version_manifest.json]]</code>.
This list of versions is populated by <code>[[Minecraft:version_manifest.json]]</code>.


Line 83: Line 82:


=== Realms ===
=== Realms ===
In the "Realms" section, the user can buy, play, and manage a ''[[Minecraft:Realms|Minecraft Realm]]''. Players can choose their Installation of choice before launching a realm.
In the "Realms" tab, the user can buy, play, and manage a ''[[Minecraft:Realms|Minecraft Realm]]''. Players can choose their installation of choice before launching a realm.


=== Skins ===
=== Skins ===
[[File:Minecraft Launcher The skin section *animated*.webp|thumb|The skins section]]
[[File:Minecraft Launcher The skin section *animated*.webp|thumb|The "Skins" tab]]
In the "Skins" section, the user can view and change their in-game skin. By default, the skin is either [[Minecraft:Player|Steve, Alex, Noor, Sunny, Ari, Zuri, Makena, Kai, or Efe.]]
In the "Skins" tab, the user can view and change their in-game skin. By default, the skin is either [[Minecraft:Player|Steve, Alex, Noor, Sunny, Ari, Zuri, Makena, Kai, or Efe.]]


In the Skins library, skin can be applied by clicking "Use". The skin can also be edited, duplicated, chosen to be either wide or slim, or delete by clicking the ellipsis button. By default, the library contains the default Steve, Alex, Noor, Sunny, Ari, Zuri, Makena, Kai, and Efe skins, which can be duplicated or applied, but not removed. Custom skins can also be uploaded by clicking the "New skin" button.
In the skin library, a skin can be applied by clicking "Use". The skin can also be edited, duplicated, chosen to be either wide or slim, or delete by clicking the ellipsis button. By default, the library contains the default Steve, Alex, Noor, Sunny, Ari, Zuri, Makena, Kai, and Efe skins, which can be duplicated or applied, but not removed. Custom skins can also be uploaded by clicking the "New skin" button.


Visiting this section without purchasing the game displays a button that redirects to the [https://minecraft.net/store/minecraft-java-edition ''Minecraft: Java Edition'' store page].
Visiting this tab without purchasing the game displays a button that redirects to the [https://minecraft.net/store/minecraft-java-edition ''Minecraft: Java Edition'' store page].


=== Patch Notes ===
=== Patch notes ===
This section shows cards of the patch notes. Each card contains an image on top and the text below stating the name of the patch notes. When clicked, this displays the patch notes.
This tab shows cards of the patch notes. Each card contains an image on top and the text below stating the name of the patch notes. When clicked, this displays the patch notes.


== ''Minecraft: Bedrock Edition'' ==
== ''Minecraft: Bedrock Edition'' ==
There are 7 tabs on the [[Minecraft:Bedrock Edition]] page: Play, Realms, Creator Tools, Marketplace, FAQ, Installation and Patch notes.
[[File:Screenshot 2026-08-25 210601.jpg|thumb|width=283x283|The default view of the ''Minecraft: Bedrock Edition'' page in the ''Minecraft Launcher'']]
There are 7 tabs on the {{BE}} page: Play, Realms, Creator Tools, Marketplace Pass, FAQ, Installation, and Patch notes (the "Installation" tab is not shown on unsupported platforms).


The main "Play" section allows the user to download or purchase (if needed) and launch ''[[Minecraft:Bedrock Edition|Minecraft: Bedrock Edition]]''<ref name=":0">[https://x.com/MinecraftWikiEN/status/1833601184923361451?t=eVwtKRcXjZlqT9lp96oDSA&s=19 “Minecraft for Windows” has been renamed to “Minecraft: Bedrock Edition” in the Launcher] - [https://x.com/MinecraftWikiEN?t=w_1EMaIo-6Fw9Ud5C4Xzng&s=09 @MinecraftWikiEN] (Minecraft Wiki) on X (formerly Twitter), September 10, 2024</ref> with the "Play" button and also includes an installation selection on the left to choose between the latest release or the latest ''[[Minecraft:Preview]]''. The [[Minecraft:Minecoins]] balance is shown on the right which opens a Minecoins purchase screen when clicked. The latest game news from [[Minecraft:minecraft.net]] and [[Minecraft:Bedrock Edition#System requirements|system requirements]] are shown in a scrollable section below. [[Minecraft:Quick Play]] is accessible and can be managed from the top-right.
The main "Play" tab allows the user to download or purchase (if needed) and launch ''[[Minecraft:Bedrock Edition|Minecraft: Bedrock Edition]]''<ref name=":0">[https://x.com/MinecraftWikiEN/status/1833601184923361451?t=eVwtKRcXjZlqT9lp96oDSA&s=19 “Minecraft for Windows” has been renamed to “Minecraft: Bedrock Edition” in the Launcher] - [https://x.com/MinecraftWikiEN?t=w_1EMaIo-6Fw9Ud5C4Xzng&s=09 @MinecraftWikiEN] (Minecraft Wiki) on X (formerly Twitter), September 10, 2024</ref> with the "Play" button and also includes an installation selection on the left to choose between the latest release or the latest ''[[Minecraft:Preview]]''. The [[Minecraft:Minecoins]] balance is shown on the right which opens a Minecoins purchase screen when clicked. The latest game news from [[Minecraft:minecraft.net]] and [[Minecraft:Bedrock Edition#System requirements|system requirements]] are shown in a scrollable section below. [[Minecraft:Quick Play]] is accessible and can be managed from the top-right.


* If the device is not connected to the internet, the game can be run in offline mode, but only if the game has been initially downloaded.
* If the device is not connected to the internet, the game can be run in offline mode, but only if the game has been initially downloaded.
* If the user is on an unsupported device, a warning appears with a link to a website with supported devices, the "Play" button got replaced with "Not Playable on this Device".
* If the user is on an unsupported device, a warning appears with a link to a website with supported devices, and the "Play" button is replaced with "Not Playable on this Device".
* If the user isn't logged into an account that has purchased the game, the "Play" button appears as a "Play demo" button that links the player to Microsoft Store to download and launch the [[Minecraft:demo version]] of the game.
* If the user isn't logged into an account that has purchased the game, the "Play" button appears as a "Play demo" button that links the player to Microsoft Store to download and launch the [[Minecraft:demo version]] of the game.
The Play section is decorated with key art from the latest named update and allows ''[[Minecraft: Pixel Drift]]'' to be played in place.
 
[[File:Launcher BE tab.png|alt=The default view of the Minecraft: Bedrock Edition on the Minecraft Launcher|thumb|width=283x283|The default view of the ''Minecraft: Bedrock Edition'' on the Minecraft Launcher]]
The "Play" tab is decorated with key art from the latest named update and allows ''[[Minecraft: Pixel Drift]]'' to be played in place.


=== Realms ===
=== Realms ===
In the "Realms" section, the user can buy, join, and manage [[Minecraft:Realms]]''.'' Owned and joined Realms are shown with some server information, and a list of pending invites. Joined Realms can be left from here, but all other settings can only be managed in-game or from the minecraft.net page linked here.
In the "Realms" tab, the user can buy, join, and manage [[Minecraft:Realms]]. Owned and joined Realms are shown with some server information, and a list of pending invites. Joined Realms can be left from here, but all other settings can only be managed in-game or from the minecraft.net page linked here.


=== Creator Tools ===
=== Creator Tools ===
[[File:Bedrock Editor Section.png|thumb|width=282x282|The Creator Tools section]]
[[File:Bedrock Editor Section.png|thumb|width=282x282|The "Creator Tools" tab]]
In the "Creator Tools" section, the user can launch ''Bedrock Edition'' with the ''[[Minecraft:Editor]]'' tools enabled, where players can use the advanced in-game tools to edit [[Minecraft:world]]s through projects and export them as world templates, and create custom [[Minecraft:Vibrant Visuals]] resource packs. The Editor can be launched for both the latest release and ''Minecraft Preview''.
In the "Creator Tools" tab, the user can launch ''Bedrock Edition'' with the ''[[Minecraft:Editor]]'' tools enabled, where players can use the advanced in-game tools to edit [[Minecraft:world]]s through projects and export them as world templates, and create custom [[Minecraft:Vibrant Visuals]] resource packs. The Editor can be launched for both the latest release and ''Minecraft Preview''.


This section has some links to articles about [[Minecraft:Blockbench]] plug-ins, [[Minecraft:Chunker]], and the [[Minecraft:feedback site]].
This tab includes links to articles about [[Minecraft:Blockbench]] plug-ins, [[Minecraft:Chunker]], and the [[Minecraft:feedback site]].


=== Marketplace Pass ===
=== Marketplace Pass ===
[[File:Marketplace Pass Section.png|thumb|width=288x288|The Marketplace Pass section]]
[[File:Marketplace Pass Section.png|thumb|width=288x288|The "Marketplace Pass" tab]]
In the "Marketplace Pass" section, the user can subscribe to the [[Minecraft:Marketplace Pass]] and access to the 150+ Marketplace content that changes every month. The links to packs and the subscribe page launch ''Minecraft'' with the respective pack or subscribe page opened in the [[Minecraft:Marketplace]]. Furthermore, this section contains information about the Marketplace Pass, the Marketplace in general, and [[Minecraft:Realms Plus]], as well as links.
In the "Marketplace Pass" tab, the user can subscribe to the [[Minecraft:Marketplace Pass]] and access over 150 Marketplace content that changes every month. The links to packs and the subscribe page launch ''Minecraft'' with the respective pack or subscribe page opened in the [[Minecraft:Marketplace]]. Furthermore, this section contains information about the Marketplace Pass, the Marketplace in general, and [[Minecraft:Realms Plus]], as well as links.


=== FAQ ===
=== FAQ ===
The "FAQ" section with frequently asked questions and answers about the ''Minecraft Launcher'', ''Minecraft: Java Edition and Minecraft:'' ''Bedrock Edition''.
The "FAQ" tab provides frequently asked questions and answers about the ''Minecraft Launcher'', ''Minecraft: Java Edition'' and ''Minecraft: Bedrock Edition''.


=== Installation ===
=== Installation ===
The "Installation" section is used to install, repair, uninstall the game, or check for updates for {{BE}} & [[Minecraft:Minecraft Preview|''Minecraft Preview'']].  
The "Installation" tab is used to install, repair, uninstall the game, or check for updates for {{BE}} and [[Minecraft:Minecraft Preview|''Minecraft Preview'']].


=== Patch Notes ===
=== Patch notes ===
The "Patch notes" section is where the patch notes of the game's major and minor updates can be seen (not including development versions and hotfixes). Each card contains an image on top and the text below stating the name of the patch notes. When clicked, this displays the patch notes, which are the same as the patch notes on minecraft.net or the feedback site.
This tab displays patch notes of major and minor updates (not including development versions and hotfixes). Each card contains an image on top and the text below stating the name of the patch notes. When clicked, this displays the patch notes, which are the same as the patch notes on minecraft.net or the feedback site.


== ''Minecraft Dungeons II'' ==
== ''Minecraft Dungeons II'' ==
[[File:Launcher MCD2 tab.png|thumb|The default view of the ''Minecraft Dungeons II'' section in the ''Minecraft Launcher''.]]
[[File:Launcher MCD2 tab 2.png|thumb|The pre-order view of the ''Minecraft Dungeons II'' page in the ''Minecraft Launcher'']]
During its pre-order phase, the {{MCD2}} page contains only a single "Play" tab, which displays promotional media for the upcoming title, including background key art, an embedded trailer, and links to pre-order the game on the Xbox store.


The ''Minecraft Dungeons II'' tab displays promotional media for the upcoming title, including background key art, a trailer embed, and links to pre-order the game on the Xbox store.
This tab features a screenshot gallery, information about a limited-time pre-order bonus, and a promotional section linking to the original ''Minecraft Dungeons''. Additionally, the page contains an interactive puzzle consisting of eight note blocks that can be activated. If the activation sequence is correct, multiple secret events can be triggered as part of an [[Minecraft:Dungeons II:ARG|ARG]].
 
The page features a screenshot gallery, information about a limited-time pre-order bonus, and a promotional section linking to the original ''Minecraft Dungeons''. Additionally, the page contains an interactive puzzle consisting of eight note blocks, which can be activated. If the activation sequence is correct, multiple secret events can be triggered, which are part of an [[Minecraft:Dungeons II:ARG|ARG]].


== ''Minecraft Dungeons'' ==
== ''Minecraft Dungeons'' ==
[[File:Launcher MCD tab.png|alt=''Minecraft Dungeons'' default section|thumb|The default view of the ''Minecraft Dungeons'' section in the ''Minecraft Launcher''.]]
[[File:Launcher MCD tab.png|thumb|The default view of the ''Minecraft Dungeons'' page in the ''Minecraft Launcher'']]
There are 5 tabs on the {{MCD}} page: Play, DLC, FAQ, Installation, and Patch notes. (Only Play, DLC, and Patch notes are shown on an unsupported platform.)
There are 5 tabs on the {{MCD}} page: Play, DLC, FAQ, Installation, and Patch notes (only "Play", "DLC", and "Patch notes" are shown on unsupported platforms).


=== Play ===
=== Play ===
The main "Play" section allows the user to download (if needed) and launch the latest version of ''Minecraft Dungeons'' with the "Play" button and also includes images from the game and a list of the latest news articles from [[Minecraft:minecraft.net]] below. This section also contains a notice that the game can be purchased separately from {{w|Microsoft Store}} for {{w|Microsoft Windows|Windows}}. If the player is not playing on the supported platform, a small message on the bottom is shown that displays: {{cd|Where is the play button?! ''Minecraft Dungeons'' isn't available on (platform).}}  
The main "Play" tab allows the user to download (if needed) and launch the latest version of ''Minecraft Dungeons'' with the "Play" button and also includes images from the game and a list of the latest news articles from [[Minecraft:minecraft.net]] below. This page also contains a notice that the game can be purchased separately from {{w|Microsoft Store}} for {{w|Microsoft Windows|Windows}}. If the player is not playing on the supported platform, a small message on the bottom is shown that displays: {{cd|Where is the play button!? ''Minecraft Dungeons'' isn't available on (platform).}}


=== DLC ===
=== DLC ===
[[File:Minecraft Dungeons DLC Page.png|alt=''Minecraft Dungeons'' DLC Page in ''Minecraft Launcher''|thumb|The DLC tab on the ''Minecraft Dungeons'' page in the ''Minecraft Launcher''.]]
[[File:Minecraft Dungeons DLC Page.png|thumb|The "DLC" tab on the ''Minecraft Dungeons'' page in the ''Minecraft Launcher'']]
There is a search bar and a filter option to narrow down the results when searching the DLCs. The bundle and the DLCs can be shown by checking the box.  
The "DLC" tab includes a search bar and filter options to narrow down the results when searching the DLCs. The bundle and the DLCs can be shown by checking the box.


Each DLC is shown in a card-like structure with the DLC info on the left and a cover image on the right. There is also a slideshow on the bottom of the card.  
Each DLC is shown in a card-like structure with the DLC info on the left and a cover image on the right. There is also a slideshow on the bottom of the card.


=== FAQ ===
=== FAQ ===
[[File:Minecraft Dungeons FAQ Page.png|thumb|The FAQ tab in ''Minecraft Dungeons'' on the ''Minecraft Launcher''.|alt=''Minecraft Dungeons'' FAQ tab]]
[[File:Minecraft Dungeons FAQ Page.png|thumb|The "FAQ" tab on the ''Minecraft Dungeons'' page in the ''Minecraft Launcher'']]
The FAQ section is shown when pressing the FAQ tab. There are a list of troubleshooting sections and a link to the [https://help.minecraft.net/hc/articles/4409170005261 ''Minecraft Dungeons'' FAQ] on the ''Minecraft'' Help Center.
The "FAQ" tab provides frequently asked questions and troubleshooting information concerning passes, launcher compatibility, DLC access, system requirements, and installation repairs for ''Minecraft Dungeons''.


=== Installation ===
=== Installation ===
Visiting this section is one of the ways to install the game. If the game wasn't bought, the game purchased displays a button that redirects to the [https://minecraft.net/dungeons#buy ''Minecraft Dungeons'' buy page]. If the game was bought but wasn't installed, it displays the Install button and if the game was installed, it shows an uninstall, repair and check for updates button.
Visiting this tab is one of the ways to install the game. If the game wasn't bought, the game purchased displays a button that redirects to the [https://minecraft.net/dungeons#buy ''Minecraft Dungeons'' buy page]. If the game was bought but wasn't installed, it displays the Install button and if the game was installed, it shows an uninstall, repair and check for updates button.


=== Patch Notes ===
=== Patch notes ===
This section shows cards of the patch notes. Each card contains an image on top and the text below stating the name of the patch notes. When clicked, this displays the patch notes.
This tab shows cards of the patch notes. Each card contains an image on top and the text below stating the name of the patch notes. When clicked, this displays the patch notes.


== ''Minecraft Legends'' ==
== ''Minecraft Legends'' ==
There are 4 tabs on the {{MCL}} page: Play, FAQ, Installation, and Patch notes. (Only Play, DLC, and Patch notes are shown on an unsupported platform.)
[[File:Launcher MCL tab.png|thumb|The default view of the ''Minecraft Legends'' page in the ''Minecraft Launcher'']]
There are 4 tabs on the {{MCL}} page: Play, FAQ, Installation, and Patch notes (only "Play", "FAQ", and "Patch notes" are shown on unsupported platforms).


=== Play ===
=== Play ===
[[File:Launcher MCL tab.png|alt=''Minecraft Legends'' default section|thumb|The default view of the ''Minecraft Legends'' section in the ''Minecraft Launcher''.]]
The main "Play" tab allows the user to download (if needed) and launch the latest version of ''Minecraft Legends'' with the "Play" button and also includes images from the game and a list of the latest news articles from [[Minecraft:minecraft.net]] below. If the player is not playing on the supported platform, a small message on the bottom is shown that displays: {{cd|Where is the play button!? ''Minecraft Legends'' isn't available on (platform).}}
The main "Play" section allows the user to download (if needed) and launch the latest version of ''Minecraft Legends'' with the "Play" button and also includes images from the game and a list of the latest news articles from [[Minecraft:minecraft.net]] below. If the player is not playing on the supported platform, a small message on the bottom is shown that displays: {{cd|Where is the play button?! ''Minecraft Legends'' isn't available on (platform).}}


=== FAQ ===
=== FAQ ===
The FAQ section is shown when pressing the FAQ tab. There are a list of troubleshooting sections and a link to the [https://help.minecraft.net/hc/en-us/sections/12618077269261 ''Minecraft Legends'' FAQ] on the ''Minecraft'' Help Center.
[[File:Minecraft Legends FAQ Page.png|thumb|The "FAQ" tab on the ''Minecraft Legends'' page in the ''Minecraft Launcher'']]
[[File:Minecraft Legends FAQ Page.png|alt=The FAQ tab in Minecraft Legends on the Minecraft Launcher|thumb|The FAQ tab in ''Minecraft Legends'' on the Minecraft Launcher]]
The "FAQ" tab provides frequently asked questions and gameplay guides covering controls, unit spawning, village defense, and accessibility settings for ''Minecraft Legends''.


=== Installation ===
=== Installation ===
Like Minecraft Dungeon's page, visiting this section is one of the ways to install Minecraft Legends. If the game wasn't bought, the game purchased displays a button that redirects to the [https://minecraft.net/legends#buy ''Minecraft Legends'' buy page]. If the game was bought but wasn't installed, it displays the Install button and if the game was installed, it shows an uninstall, repair and check for updates button.
Like the ''Minecraft Dungeons'' page, visiting this tab is one of the ways to install ''Minecraft Legends''. If the game wasn't bought, the game purchased displays a button that redirects to the [https://minecraft.net/legends#buy ''Minecraft Legends'' buy page]. If the game was bought but wasn't installed, it displays the Install button and if the game was installed, it shows an uninstall, repair and check for updates button.


=== Patch Notes ===
=== Patch notes ===
This section shows cards of the patch notes. Each card contains an image on top and the text below stating the name of the patch notes. When clicked, this displays the patch notes.
This tab shows cards of the patch notes. Each card contains an image on top and the text below stating the name of the patch notes. When clicked, this displays the patch notes.


== Settings ==
== Settings ==
[[File:MC Launcher About Page.png|thumb|The "About" section in the ''Minecraft Launcher'' settings.]]
[[File:MC Launcher About Page.png|thumb|The "About" tab in the ''Minecraft Launcher'' settings.]]
In the main "General" section, users can:
There are 3 tabs on the settings page: General, Accounts, and About.
 
In the main "General" tab, users can:
* Change the ''Minecraft Launcher'' language. There are 63 languages available, including 3 joke languages (as of July 2026).
* Change the ''Minecraft Launcher'' language. There are 63 languages available, including 3 joke languages (as of July 2026).
* Use the beta version of the ''Minecraft Launcher'', which requires restarting the launcher to start downloading if there is one available.
* Use the beta version of the ''Minecraft Launcher'', which requires restarting the launcher to start downloading if there is one available.
Line 192: Line 193:
* Open the output log when the game starts.
* Open the output log when the game starts.
* Option to automatically send the game's crash reports to Mojang Studios.
* Option to automatically send the game's crash reports to Mojang Studios.
* Show historical versions of the game (versions prior to [[Minecraft:Java Edition 1.0.0|Release 1.0]]) in the version selector in the Installations section.
* Show historical versions of the game (versions prior to [[Minecraft:Java Edition 1.0.0|Release 1.0]]) in the version selector in the installations tab.


In the "Accounts" section, users can add, switch, manage, or remove their Microsoft accounts.
In the "Accounts" tab, users can add, switch, manage, or remove their Microsoft accounts.


The "About" section contains details about the ''Minecraft Launcher'' including its version, credits, and third-party licenses, as well as a list of patch notes by clicking the "What's New?" button.
The "About" tab contains details about the ''Minecraft Launcher'' including its version, credits, and third-party licenses, as well as a list of patch notes by clicking the "What's New?" button.
{{-}}
{{-}}


== Command line usage ==
== Command-line usage ==
{{msgbox|title=Important Note|text=On Windows, this works only on the old Unified Minecraft Launcher and NOT the Microsoft Store version.|type=issue|mini=1}}
{{msgbox|title=Important Note|text=On Windows, these options only apply to the old Unified Minecraft Launcher and NOT the Microsoft Store version.|type=issue|mini=1}}
{{missing information|section|the default host of the proxy (if available) and the --nativeLauncherVersion flag}}
The ''Minecraft Launcher'' can be invoked using the command line by typing {{cd|%ProgramFiles(x86)%\Minecraft Launcher\MinecraftLauncher.exe}} on Windows, {{cd|minecraft-launcher}} on Linux or {{cd|/Applications/Minecraft.app/Contents/MacOS/launcher}} on macOS.
The ''Minecraft Launcher'' can be invoked using the command line by typing {{cd|%ProgramFiles(x86)%\Minecraft Launcher\MinecraftLauncher.exe}} in Windows, {{cd|minecraft-launcher}} in Linux or {{cd|/Applications/Minecraft.app/Contents/MacOS/launcher}} on macOS.[[File:Minecraft Launcher Command Line Args.png|thumb|The Help Message when using MinecraftLauncher.exe --help]]
[[File:Minecraft Launcher Command Line Args.png|thumb|The help message when using MinecraftLauncher.exe --help]]
As of version [[Minecraft:Launcher 2.2.25xx|2.2.25xx]], the ''Minecraft Launcher'' has these command-line options available for ''Minecraft: Java Edition'':
As of version [[Minecraft:Launcher 3.37.2|3.37.2]], the ''Minecraft Launcher'' provides several command-line options:
* {{cd|--demo}} - This launches the demo version of the game, much like if the game hasn't been purchased yet.
 
* {{cd|-h, --help}} - This option displays a help message on how to run it in the command line.
* {{cd|-h, --help}} – Displays a help message listing standard command-line options.
* {{cd|--clean}} – This option deletes the "<samp>game</samp>" and "<samp>runtime</samp>" folders, including their contents, from the working directory.
* {{cd|-w, --workDir <path>}} – Sets the launcher working directory (the location of the [[Minecraft:.minecraft]] directory).
* {{cd|--launcherui}} - This option presents the login screen.
** Can be used to create a portable installation of the launcher by passing a custom path or {{cd|--workDir .}} to use the current directory.
* {{cd|-w, --workDir}} – This option, followed by a path (relative or absolute), changes the location (and/or name) of the <samp>.minecraft</samp> folder.
* {{cd|-l, --lockDir <path>}} – Restricts the launcher installation directory to the specified folder.
** Can be used to create a portable installation of the game. For example, {{cd|--workDir}} (or {{cd|--workDir<nowiki>=</nowiki>.}}) can be used to make the ''Minecraft Launcher'' use the current directory (no matter what the current folder is called).
* {{cd|-c, --config <path>}} – Specifies a custom path to a configuration file for the launcher.
* {{cd|--nativeLauncherVersion}} - .
* {{cd|--clean}} – Deletes the <samp>game</samp> and <samp>runtime</samp> directories, including their contents, from the working directory.
* {{cd|--tmpDir}} – This option, followed by a path (relative or absolute), changes the location (and/or name) of the <samp>tmp</samp> folder.
* {{cd|--launcherui}} – Starts the launcher directly in UI mode, skipping update and startup checks. Allows multiple launcher processes to run simultaneously.
* {{cd|-l, --lockDir}} - This option, followed by a path, restricts the installation directory to a specified folder.
* {{cd|--mclAllowProcessLockRetries}} – If another instance of the launcher is already running, retries starting up to 5 times (waiting 1 second between attempts) before bringing the existing window to the front.
* {{cd|--winTen}} – This option adds support for Windows 10. Since the ''Minecraft Launcher'' now supports Windows 10 fully, this option is unnecessary and seems to have no effect.
* {{cd|--launcherComponentDir <path>}} – Specifies an alternative directory to locate and store core launcher components (such as <samp>launcher.dll</samp>). Bypasses ordinary update checks if valid components are already present in the folder.
* {{cd|--proxyHost}} - This option changes where the host of the proxy is.
* {{cd|--stagingDir <path>}} – Specifies a custom staging directory where the updater downloads, extracts, and verifies component update files before replacing active files.
* {{cd|--proxyPort}} - This option changes the default port from {{cd|80}} to a custom one.
* {{cd|--skipUpdate}} – Skips the automatic check and download of launcher updates.
* {{cd|--disableGPU}} - This disables GPU acceleration in the ''Minecraft Launcher'', which might fix issues when playing ''Minecraft''..
* {{cd|--repair}} – Tells the installer to start a repair routine for the launcher and closes immediately.
* {{cd|--debugGPU}} - This opens up a new window showing debug information, like "Graphic Feature Stats", which shows if Hardware acceleration is enabled on certain features, and an option to copy the content to the clipboard. These might be useful for troubleshooting purposes.
* {{cd|--disableGPU}} – Disables GPU hardware acceleration inside the launcher interface, which can help resolve rendering glitches.
* {{cd|--debugGPU}} – Opens a dedicated debugging window showing GPU driver capabilities and hardware acceleration statistics for troubleshooting.
{{-}}
{{-}}


Line 223: Line 225:
Source: [https://help.minecraft.net/hc/articles/4412266387213 "Uninstalling the Old Minecraft Unified Launcher"] – Minecraft Help Center.
Source: [https://help.minecraft.net/hc/articles/4412266387213 "Uninstalling the Old Minecraft Unified Launcher"] – Minecraft Help Center.


This applies only to players using Windows 10 or newer. Older versions of Windows are not able to use the new ''Minecraft Launcher for Windows''. With the addition of a new launcher, you can uninstall the old launcher to remove any confusion between the two. For clarity, the new launcher is referred to as the "''Minecraft Launcher for Windows''" and the old launcher as the "''Minecraft Unified Launcher''".  
This applies only to players using Windows 10 or newer. Older versions of Windows are not able to use the new ''Minecraft Launcher for Windows''. With the addition of a new launcher, you can uninstall the old launcher to remove any confusion between the two. For clarity, the new launcher is referred to as the "''Minecraft Launcher for Windows''" and the old launcher as the "''Minecraft Unified Launcher''".


How to uninstall the ''Minecraft Unified Launcher'' (old launcher):
How to uninstall the ''Minecraft Unified Launcher'' (old launcher):
Line 251: Line 253:
|{{HistoryLine||v1.2.2|Command line arguments format changed.}}
|{{HistoryLine||v1.2.2|Command line arguments format changed.}}
|{{HistoryLine|java beta}}
|{{HistoryLine|java beta}}
|{{HistoryLine||1.3|Released in February 21, 2011.<ref>[[Minecraft:wordofnotch:3428176687|Server downtime, and a new Launcher]]</ref> A technical sneak preview was published by Notch on February 18, 2011.<ref>{{tweet|notch|38621269331025921|This requires some technical know-how|February 18, 2011}}</ref>
|{{HistoryLine||1.3|Released on February 21, 2011.<ref>[[Minecraft:wordofnotch:3428176687|Server downtime, and a new Launcher]]</ref> A technical sneak preview was published by Notch on February 18, 2011.<ref>{{tweet|notch|38621269331025921|This requires some technical know-how|February 18, 2011}}</ref>
|Added capability of automatic login to the game and/or server by command line arguments.
|Added capability of automatic login to the game and/or server by command line arguments.
|Added smarter update system that updates only changed files, prompts the user to update, allows HTTPS logins for a more secure connection, and offers general UI improvements.
|Added smarter update system that updates only changed files, prompts the user to update, allows HTTPS logins for a more secure connection, and offers general UI improvements.
Line 265: Line 267:
|The applet version was discontinued, in favor of the improved Minecraft Launcher.<ref>https://www.reddit.com/r/GoldenAgeMinecraft/comments/1bjfhm6/comment/kvv941b/</ref>
|The applet version was discontinued, in favor of the improved Minecraft Launcher.<ref>https://www.reddit.com/r/GoldenAgeMinecraft/comments/1bjfhm6/comment/kvv941b/</ref>
}}
}}
|{{HistoryLine||1.14|New 'beta' launcher added. See [[Minecraft:Launcher version history]] for version history from this point onward.}}
|{{HistoryLine||1.14|New 'beta' launcher added. See [[Minecraft:Launcher version history]] for version history from this point onward.}}
}}
}}


Line 271: Line 273:
{{HistoryTable
{{HistoryTable
|{{HistoryLine|launcher}}
|{{HistoryLine|launcher}}
|{{HistoryLine||February 24, 2020|link=none|With launcher version [[Minecraft:Launcher 2.1.1382x|2.1.1382''x'']], patch notes for the Launcher are added to the About section.}}
|{{HistoryLine||February 24, 2020|link=none|With launcher version [[Minecraft:Launcher 2.1.1382x|2.1.1382''x'']], patch notes for the Launcher are added to the "About" tab.}}
|{{HistoryLine||October 21, 2020|link={{ytl|i9cqIwrgz7w}}|It is announced that {{JE}} would be using Microsoft accounts for added security enhancements. With this, all Mojang Studios accounts would be migrated to Microsoft accounts.<ref>{{cite|url=https://www.minecraft.net/en-us/article/java-edition-moving-house|title=Java Edition is moving house|date=October 21, 2020|website=Minecraft.net}}</ref><ref>{{cite|url=https://www.minecraft.net/en-us/mojang-account-move|title=Mojang Java Account Move|website=Minecraft.net}}</ref> Since December 1, 2020, new players are no longer able to sign up for a Mojang Studios account; they are instead required to use or create a Microsoft account to buy and play the game.}}
|{{HistoryLine||October 21, 2020|link={{ytl|i9cqIwrgz7w}}|It is announced that {{JE}} would be using Microsoft accounts for added security enhancements. With this, all Mojang Studios accounts would be migrated to Microsoft accounts.<ref>{{cite|url=https://www.minecraft.net/en-us/article/java-edition-moving-house|title=Java Edition is moving house|date=October 21, 2020|website=Minecraft.net}}</ref><ref>{{cite|url=https://www.minecraft.net/en-us/mojang-account-move|title=Mojang Java Account Move|website=Minecraft.net}}</ref> Since December 1, 2020, new players are no longer able to sign up for a Mojang Studios account; they are instead required to use or create a Microsoft account to buy and play the game.}}
|{{HistoryLine||November 27, 2020|link=none|With launcher version [[Minecraft:Launcher 2.2.74x|2.2.74''x'']] it is now "Unified" and one can now log in with a Microsoft Account and launch ''Minecraft Dungeons'', which previously required a separate launcher.}}
|{{HistoryLine||November 27, 2020|link=none|With launcher version [[Minecraft:Launcher 2.2.74x|2.2.74''x'']] it is now "Unified" and one can now log in with a Microsoft Account and launch ''Minecraft Dungeons'', which previously required a separate launcher.}}
Line 278: Line 280:
|The legacy ''Minecraft Launcher'' (version 1.6.x) is discontinued (along with support for Windows XP and Vista) since this launcher does not support Microsoft accounts.}}
|The legacy ''Minecraft Launcher'' (version 1.6.x) is discontinued (along with support for Windows XP and Vista) since this launcher does not support Microsoft accounts.}}
|{{HistoryLine||July 2, 2022|link=none|A crown had been added to the [[Minecraft:pig]] on the menu image in memoriam of the popular [[Minecraft:YouTube]]r [[Minecraft:Technoblade]], whose death from Stage 4 cancer had been announced 2 days prior.}}
|{{HistoryLine||July 2, 2022|link=none|A crown had been added to the [[Minecraft:pig]] on the menu image in memoriam of the popular [[Minecraft:YouTube]]r [[Minecraft:Technoblade]], whose death from Stage 4 cancer had been announced 2 days prior.}}
|{{HistoryLine||August 23, 2022 |link=https://twitter.com/JORAX79/status/1562196723706998785|''[[Minecraft:Minecraft Preview]]'' is added to the Launcher.}}
|{{HistoryLine||August 23, 2022|link=https://twitter.com/JORAX79/status/1562196723706998785|''[[Minecraft:Minecraft Preview]]'' is added to the Launcher.}}
|{{HistoryLine||September 10, 2024|link=https://x.com/MinecraftWikiEN/status/1833601184923361451?t=eVwtKRcXjZlqT9lp96oDSA&s=19|Renamed the "Minecraft for Windows" tab to "Minecraft: Bedrock Edition."}}
|{{HistoryLine||September 10, 2024|link=https://x.com/MinecraftWikiEN/status/1833601184923361451?t=eVwtKRcXjZlqT9lp96oDSA&s=19|Renamed the "Minecraft for Windows" tab to "Minecraft: Bedrock Edition."}}
|{{HistoryLine||February 27, 2025|link=none|Added a new section to showcase "A Minecraft Movie" content.}}
|{{HistoryLine||February 27, 2025|link=none|Added a new tab to showcase "A Minecraft Movie" content.}}
|{{HistoryLine||March 24, 2025|link=none|Added falling leaves to celebrate the [[Minecraft:Spring to Life]] update, along with the "Triple Bundle".}}|{{HistoryLine||April 1, 2025|link=none|Added the [[Minecraft:Launcher 3.12.20|Launchcraft]] update.}}}}
|{{HistoryLine||March 24, 2025|link=none|Added falling leaves to celebrate the [[Minecraft:Spring to Life]] update, along with the "Triple Bundle".}}
|{{HistoryLine||April 1, 2025|link=none|Added the [[Minecraft:Launcher 3.12.20|Launchcraft]] update.}}
}}


== Issues ==
== Issues ==
Line 312: Line 316:
File:Launcher JE tab.png|The ''Minecraft: Java Edition'' tab
File:Launcher JE tab.png|The ''Minecraft: Java Edition'' tab
File:Launcher BE tab.png|The ''Minecraft: Bedrock Edition'' tab
File:Launcher BE tab.png|The ''Minecraft: Bedrock Edition'' tab
File:Launcher MCD2 tab.png|The ''Minecraft Dungeons II'' tab during pre-order
File:Launcher MCD2 tab 2.png|The ''Minecraft Dungeons II'' tab during pre-order
File:Launcher MCD tab.png|The ''Minecraft Dungeons'' tab
File:Launcher MCD tab.png|The ''Minecraft Dungeons'' tab
File:Launcher MCL tab.png|The ''Minecraft Legends'' tab
File:Launcher MCL tab.png|The ''Minecraft Legends'' tab
Line 319: Line 323:
File:Minecraft launcher.svg|Old Minecraft Launcher app icon
File:Minecraft launcher.svg|Old Minecraft Launcher app icon
File:Poisonous-potato-Minecraft-Launcher-font.png|Poisonous Potato "play" font
File:Poisonous-potato-Minecraft-Launcher-font.png|Poisonous Potato "play" font
File:Launcher 2.3.443 Minecraft Live Tab.png|Minecraft Live Tab
File:Launcher 2.3.443 Minecraft Live Tab.png|Minecraft Live tab
File:Launcher BE MacOS.png|The ''Bedrock Edition'' screen on macOS
File:Launcher BE MacOS.png|The ''Bedrock Edition'' screen on macOS
</gallery>
</gallery>
Line 325: Line 329:
=== ''Minecraft: Java Edition'' ===
=== ''Minecraft: Java Edition'' ===
<gallery>
<gallery>
File:Launcher installations.png|The default installations section (with snapshots enabled)
File:Launcher installations.png|The default installations tab (with snapshots enabled)
File:New Installation.png|Editing an installation
File:New Installation.png|Editing an installation
File:ChangingSkinLauncher.png|Adding a new skin
File:ChangingSkinLauncher.png|Adding a new skin

Latest revision as of 11:16, 26 August 2026

Template:Italic title Template:Redirect Template:Infobox program

File:Minecraft Launcher Xbox Horizontal Key Art.jpg
Key art by Mojang Studios

The Minecraft Launcher is the main game downloader and launcher for Minecraft: Java Edition and one of the game downloaders and launchers for Template:BE, Template:MCD, and Template:MCL. It is available for Template:W, Template:W and Template:W, but Minecraft: Bedrock Edition and Minecraft Legends can be played only on Windows 10 or later, and Minecraft Dungeons only on Windows 7 or later.

Features

File:Launcher login.png
The initial login screen
File:Minecraft Launcher Animated Loading Screen.webp
The initial loading screen

On the initial login screen, users must log in with a pre-existing Microsoft account, otherwise they can create a new one by clicking the link. Subsequent logins can be done in the "Settings" tab.

On the left side, a "Home" tab, a tab for each game, and the Minecraft Launcher "Settings" tab can be seen.

The top left corner of the Minecraft Launcher contains the user's Xbox gamertag for the currently active account (which might differ from their Minecraft: Java Edition username)<ref>https://help.minecraft.net/hc/articles/360052640612</ref>. By clicking on it, users can manage or log out of their active account, and see a "Help" page with various links to helpful resources.

Minecraft: Java Edition

File:Launcher JE tab.png
The default view of the Minecraft: Java Edition page in the Minecraft Launcher
File:Launcher Demo.png
The default view of the Minecraft: Java Edition page in the Minecraft Launcher if the user has not purchased the game

There are 5 tabs on the Template:JE page: Play, Installations, Realms, Skins, and Patch notes.

The main "Play" tab allows the user to download (if needed) and launch Minecraft: Java Edition with the "Play" button, and also includes an installation selection on the left (which sorts installations by last played), the user's Java Edition username on the right, and a list of the latest news for the game from Minecraft:minecraft.net below.

  • One can launch multiple instances of the game by pressing the "Play" button while the game is running.
  • If the device is not connected to the internet, the game can be run in offline mode, but only if the game has been initially downloaded.
  • If the user isn't logged into an account that has purchased the game, the "Play" button appears as a "Buy Now" button that links to Buy Minecraft on Minecraft.net.

Installations

File:New Installation.png
Creating a new installation

Template:Anchor

In the "Installations" tab, custom installations can be created and edited. There are buttons to sort and search installations, as well as checkboxes to enable installations with "Releases", "Snapshots", and "Modded" versions of the game. Installations are stored in Minecraft:launcher_profiles.json (in the game's directory (Minecraft:.minecraft).

By default, there are installations for the "Latest release" and for "Latest snapshot" (if enabled), both of which the game versions cannot be changed. A new installation can be created by clicking the "New installation" button and an existing installation can be edited by clicking on it. There is a "Play" button that launches the selected installation and a folder icon that takes to the installation's game directory. The ellipsis button contains options to edit, duplicate, or delete an installation.

On the create/edit installation page, the following can be changed:

  • Icon, by selecting one of the default ones or adding a custom one. Custom icons must be a .png and 128×128 pixels in size.
  • Name, by default called "<unnamed installation>".
  • Version, which includes access to older releases and snapshots (if enabled).
  • Game directory, the location of where the game files are saved, the default being Minecraft:.minecraft. The location can be typed in or selected using the "Browse" button.
  • Resolution, which changes the game's window size. It has a list of resolutions, or a custom one can be typed in.
  • Java executable, by default uses the bundled Java runtime.
  • JVM arguments, such as heap size or enabling Minecraft:debug renderers not normally accessible in the Minecraft:debug screen such as mob pathfinding.

Previously, it was possible for users to manually set a logging configuration (see Debugging for more info), however, this doesn't seem to work anymore.<ref>Template:Bug</ref>

A specific game version's server jar can also be downloaded by selecting the version in the list and pressing the "Server" button next to it.

Backward compatibility

File:HowtoOldVersion2019.png
Selecting older versions in the create new installation screen

The Minecraft Launcher has the ability to play most older releases of the game (and older snapshots, if enabled) by default, but also some older versions prior to Minecraft:Java Edition 1.0.0. In order to see these versions in the "Installations" tab, the player must enable "Show historical versions of Java Edition" in the Minecraft Launcher "Settings" tab. Because these versions are outdated and unsupported, they may contain bugs and errors that are not present in newer versions. It is recommended to run old versions of the game in a separate directory and backup worlds to avoid save corruption or other problems.<ref>Template:Cite</ref>

Once historical versions are enabled, the following can be accessed:

This list of versions is populated by Minecraft:version_manifest.json.

Some issues with these older versions include:

  • In Minecraft:Alpha v1.2.5 and Alpha v1.2.6 specifically, players are always named "Player524". Playing multiplayer in these versions is impossible, as joining a server kicks off other players with the same name.
  • As a side effect of the above, and as a result of old authentication servers being shut down, online mode no longer works in versions before Minecraft:Beta 1.8.

Realms

In the "Realms" tab, the user can buy, play, and manage a Minecraft Realm. Players can choose their installation of choice before launching a realm.

Skins

File:Minecraft Launcher The skin section *animated*.webp
The "Skins" tab

In the "Skins" tab, the user can view and change their in-game skin. By default, the skin is either Steve, Alex, Noor, Sunny, Ari, Zuri, Makena, Kai, or Efe.

In the skin library, a skin can be applied by clicking "Use". The skin can also be edited, duplicated, chosen to be either wide or slim, or delete by clicking the ellipsis button. By default, the library contains the default Steve, Alex, Noor, Sunny, Ari, Zuri, Makena, Kai, and Efe skins, which can be duplicated or applied, but not removed. Custom skins can also be uploaded by clicking the "New skin" button.

Visiting this tab without purchasing the game displays a button that redirects to the Minecraft: Java Edition store page.

Patch notes

This tab shows cards of the patch notes. Each card contains an image on top and the text below stating the name of the patch notes. When clicked, this displays the patch notes.

Minecraft: Bedrock Edition

File:Screenshot 2026-08-25 210601.jpg
The default view of the Minecraft: Bedrock Edition page in the Minecraft Launcher

There are 7 tabs on the Template:BE page: Play, Realms, Creator Tools, Marketplace Pass, FAQ, Installation, and Patch notes (the "Installation" tab is not shown on unsupported platforms).

The main "Play" tab allows the user to download or purchase (if needed) and launch Minecraft: Bedrock Edition<ref name=":0">“Minecraft for Windows” has been renamed to “Minecraft: Bedrock Edition” in the Launcher - @MinecraftWikiEN (Minecraft Wiki) on X (formerly Twitter), September 10, 2024</ref> with the "Play" button and also includes an installation selection on the left to choose between the latest release or the latest Minecraft:Preview. The Minecraft:Minecoins balance is shown on the right which opens a Minecoins purchase screen when clicked. The latest game news from Minecraft:minecraft.net and system requirements are shown in a scrollable section below. Minecraft:Quick Play is accessible and can be managed from the top-right.

  • If the device is not connected to the internet, the game can be run in offline mode, but only if the game has been initially downloaded.
  • If the user is on an unsupported device, a warning appears with a link to a website with supported devices, and the "Play" button is replaced with "Not Playable on this Device".
  • If the user isn't logged into an account that has purchased the game, the "Play" button appears as a "Play demo" button that links the player to Microsoft Store to download and launch the Minecraft:demo version of the game.

The "Play" tab is decorated with key art from the latest named update and allows Minecraft: Pixel Drift to be played in place.

Realms

In the "Realms" tab, the user can buy, join, and manage Minecraft:Realms. Owned and joined Realms are shown with some server information, and a list of pending invites. Joined Realms can be left from here, but all other settings can only be managed in-game or from the minecraft.net page linked here.

Creator Tools

File:Bedrock Editor Section.png
The "Creator Tools" tab

In the "Creator Tools" tab, the user can launch Bedrock Edition with the Minecraft:Editor tools enabled, where players can use the advanced in-game tools to edit Minecraft:worlds through projects and export them as world templates, and create custom Minecraft:Vibrant Visuals resource packs. The Editor can be launched for both the latest release and Minecraft Preview.

This tab includes links to articles about Minecraft:Blockbench plug-ins, Minecraft:Chunker, and the Minecraft:feedback site.

Marketplace Pass

File:Marketplace Pass Section.png
The "Marketplace Pass" tab

In the "Marketplace Pass" tab, the user can subscribe to the Minecraft:Marketplace Pass and access over 150 Marketplace content that changes every month. The links to packs and the subscribe page launch Minecraft with the respective pack or subscribe page opened in the Minecraft:Marketplace. Furthermore, this section contains information about the Marketplace Pass, the Marketplace in general, and Minecraft:Realms Plus, as well as links.

FAQ

The "FAQ" tab provides frequently asked questions and answers about the Minecraft Launcher, Minecraft: Java Edition and Minecraft: Bedrock Edition.

Installation

The "Installation" tab is used to install, repair, uninstall the game, or check for updates for Template:BE and Minecraft Preview.

Patch notes

This tab displays patch notes of major and minor updates (not including development versions and hotfixes). Each card contains an image on top and the text below stating the name of the patch notes. When clicked, this displays the patch notes, which are the same as the patch notes on minecraft.net or the feedback site.

Minecraft Dungeons II

File:Launcher MCD2 tab 2.png
The pre-order view of the Minecraft Dungeons II page in the Minecraft Launcher

During its pre-order phase, the Template:MCD2 page contains only a single "Play" tab, which displays promotional media for the upcoming title, including background key art, an embedded trailer, and links to pre-order the game on the Xbox store.

This tab features a screenshot gallery, information about a limited-time pre-order bonus, and a promotional section linking to the original Minecraft Dungeons. Additionally, the page contains an interactive puzzle consisting of eight note blocks that can be activated. If the activation sequence is correct, multiple secret events can be triggered as part of an ARG.

Minecraft Dungeons

File:Launcher MCD tab.png
The default view of the Minecraft Dungeons page in the Minecraft Launcher

There are 5 tabs on the Template:MCD page: Play, DLC, FAQ, Installation, and Patch notes (only "Play", "DLC", and "Patch notes" are shown on unsupported platforms).

Play

The main "Play" tab allows the user to download (if needed) and launch the latest version of Minecraft Dungeons with the "Play" button and also includes images from the game and a list of the latest news articles from Minecraft:minecraft.net below. This page also contains a notice that the game can be purchased separately from Template:W for Template:W. If the player is not playing on the supported platform, a small message on the bottom is shown that displays: Template:Cd

DLC

File:Minecraft Dungeons DLC Page.png
The "DLC" tab on the Minecraft Dungeons page in the Minecraft Launcher

The "DLC" tab includes a search bar and filter options to narrow down the results when searching the DLCs. The bundle and the DLCs can be shown by checking the box.

Each DLC is shown in a card-like structure with the DLC info on the left and a cover image on the right. There is also a slideshow on the bottom of the card.

FAQ

File:Minecraft Dungeons FAQ Page.png
The "FAQ" tab on the Minecraft Dungeons page in the Minecraft Launcher

The "FAQ" tab provides frequently asked questions and troubleshooting information concerning passes, launcher compatibility, DLC access, system requirements, and installation repairs for Minecraft Dungeons.

Installation

Visiting this tab is one of the ways to install the game. If the game wasn't bought, the game purchased displays a button that redirects to the Minecraft Dungeons buy page. If the game was bought but wasn't installed, it displays the Install button and if the game was installed, it shows an uninstall, repair and check for updates button.

Patch notes

This tab shows cards of the patch notes. Each card contains an image on top and the text below stating the name of the patch notes. When clicked, this displays the patch notes.

Minecraft Legends

File:Launcher MCL tab.png
The default view of the Minecraft Legends page in the Minecraft Launcher

There are 4 tabs on the Template:MCL page: Play, FAQ, Installation, and Patch notes (only "Play", "FAQ", and "Patch notes" are shown on unsupported platforms).

Play

The main "Play" tab allows the user to download (if needed) and launch the latest version of Minecraft Legends with the "Play" button and also includes images from the game and a list of the latest news articles from Minecraft:minecraft.net below. If the player is not playing on the supported platform, a small message on the bottom is shown that displays: Template:Cd

FAQ

File:Minecraft Legends FAQ Page.png
The "FAQ" tab on the Minecraft Legends page in the Minecraft Launcher

The "FAQ" tab provides frequently asked questions and gameplay guides covering controls, unit spawning, village defense, and accessibility settings for Minecraft Legends.

Installation

Like the Minecraft Dungeons page, visiting this tab is one of the ways to install Minecraft Legends. If the game wasn't bought, the game purchased displays a button that redirects to the Minecraft Legends buy page. If the game was bought but wasn't installed, it displays the Install button and if the game was installed, it shows an uninstall, repair and check for updates button.

Patch notes

This tab shows cards of the patch notes. Each card contains an image on top and the text below stating the name of the patch notes. When clicked, this displays the patch notes.

Settings

File:MC Launcher About Page.png
The "About" tab in the Minecraft Launcher settings.

There are 3 tabs on the settings page: General, Accounts, and About.

In the main "General" tab, users can:

  • Change the Minecraft Launcher language. There are 63 languages available, including 3 joke languages (as of July 2026).
  • Use the beta version of the Minecraft Launcher, which requires restarting the launcher to start downloading if there is one available.
  • Keep the Minecraft Launcher open while games are running.
  • Enable animations in the Minecraft Launcher, which are disabled by default to avoid potential motion sickness for some users.
  • Disable hardware acceleration.
  • Review the launcher.
  • Make text size bigger.
  • Disable video autoplay.
  • Enable or disable Minecraft:Quick Play feature and delete all entries.

Options exclusively for Minecraft: Java Edition:

  • Open the output log when the game starts.
  • Option to automatically send the game's crash reports to Mojang Studios.
  • Show historical versions of the game (versions prior to Release 1.0) in the version selector in the installations tab.

In the "Accounts" tab, users can add, switch, manage, or remove their Microsoft accounts.

The "About" tab contains details about the Minecraft Launcher including its version, credits, and third-party licenses, as well as a list of patch notes by clicking the "What's New?" button.

Command-line usage

Template:Msgbox The Minecraft Launcher can be invoked using the command line by typing Template:Cd on Windows, Template:Cd on Linux or Template:Cd on macOS.

File:Minecraft Launcher Command Line Args.png
The help message when using MinecraftLauncher.exe --help

As of version 3.37.2, the Minecraft Launcher provides several command-line options:

  • Template:Cd – Displays a help message listing standard command-line options.
  • Template:Cd – Sets the launcher working directory (the location of the Minecraft:.minecraft directory).
    • Can be used to create a portable installation of the launcher by passing a custom path or Template:Cd to use the current directory.
  • Template:Cd – Restricts the launcher installation directory to the specified folder.
  • Template:Cd – Specifies a custom path to a configuration file for the launcher.
  • Template:Cd – Deletes the game and runtime directories, including their contents, from the working directory.
  • Template:Cd – Starts the launcher directly in UI mode, skipping update and startup checks. Allows multiple launcher processes to run simultaneously.
  • Template:Cd – If another instance of the launcher is already running, retries starting up to 5 times (waiting 1 second between attempts) before bringing the existing window to the front.
  • Template:Cd – Specifies an alternative directory to locate and store core launcher components (such as launcher.dll). Bypasses ordinary update checks if valid components are already present in the folder.
  • Template:Cd – Specifies a custom staging directory where the updater downloads, extracts, and verifies component update files before replacing active files.
  • Template:Cd – Skips the automatic check and download of launcher updates.
  • Template:Cd – Tells the installer to start a repair routine for the launcher and closes immediately.
  • Template:Cd – Disables GPU hardware acceleration inside the launcher interface, which can help resolve rendering glitches.
  • Template:Cd – Opens a dedicated debugging window showing GPU driver capabilities and hardware acceleration statistics for troubleshooting.


Uninstalling the old Minecraft Unified Launcher

Source: "Uninstalling the Old Minecraft Unified Launcher" – Minecraft Help Center.

This applies only to players using Windows 10 or newer. Older versions of Windows are not able to use the new Minecraft Launcher for Windows. With the addition of a new launcher, you can uninstall the old launcher to remove any confusion between the two. For clarity, the new launcher is referred to as the "Minecraft Launcher for Windows" and the old launcher as the "Minecraft Unified Launcher".

How to uninstall the Minecraft Unified Launcher (old launcher):

  1. Click the start menu in Windows (windows icon in the bottom left).
  2. Type in "Add or remove programs" and click the top entry.
  3. Search for "Minecraft Launcher". The launcher to uninstall displays Mojang underneath the title "Minecraft Launcher".
  4. Click the three dots shown to the left of the "Minecraft Launcher" title and select "Uninstall".

Now only one launcher should be installed. Run the Minecraft Launcher for Windows to ensure it still works; if it doesn't, reinstall using Microsoft Store.

Launcher or game mods may need to be migrated or re-installed to the new Minecraft Launcher for Windows installation location before uninstalling the old launcher. Check with the mod developer for more detail.

History

Template:Hatnote

Java Edition

Template:HistoryTable

Minecraft Launcher

Template:HistoryTable

Issues

Template:Issue list

Trivia

  • In version 2.2.2529 release notes there's text that reads: T⍑ᒷ ᔑ ̇/𝙹ꖎ𝙹ℸ ̣ ꖎᓭ ᔑ∷ᒷ リ𝙹ℸ ̣ ∴⍑ᔑℸ ̣ ℸ ̣ ⍑ᒷ|| ᓭᒷᒷᒲ - which translates to "THE AXOLOTLS ARE NOT WHAT THEY SEEM".
  • Both Alpha and Classic versions of Minecraft: Java Edition are listed as "old_alpha", despite them not being the same.<ref>Template:Bug</ref>
  • The Minecraft Launcher doesn't store passwords locally. Instead, it uses a 'refresh token'.
  • The current Minecraft Launcher is the eighth launcher for Minecraft: Java Edition, and the third that was built to automatically update itself.
  • Game crashes are reported to Mojang Studios through Hopper.
  • The legacy Minecraft Launcher can be downloaded Template:Dl (version 1.6.93, ~4.6MB as opposed to the modern launcher's ~85MB). However, the legacy Minecraft Launcher is incompatible with Microsoft accounts and was discontinued in Q2 2021 due to account migration.
  • In version 2.3.240, the pig on the Minecraft Launcher screen was given a crown in light of popular Minecraft YouTuber Minecraft:Technoblade passing away due to cancer.
  • The Armadillo loading screen animation is scaled to 1280×720 (16:9) but was originally 646×364 (≈16:9.02), causing distortion to the animation.

Gallery

Minecraft: Java Edition

Backgrounds

Version history

2013–16

2016–19

See also

References

Template:Reflist

Navigation

Template:Navbox Minecraft (franchise)

Minecraft:cs:Spouštěč Minecraftu Minecraft:de:Minecraft Launcher Minecraft:es:Lanzador de Minecraft Minecraft:fr:Launcher Minecraft:it:Launcher di Minecraft Minecraft:ja:Minecraftランチャー Minecraft:ko:Minecraft 런처 Minecraft:lzh:礦藝啟者 Minecraft:nl:Minecraft launcher Minecraft:pl:Minecraft Launcher Minecraft:pt:Minecraft Launcher Minecraft:ru:Лаунчер Minecraft:th:ลันเชอร์ Minecraft Minecraft:uk:Лаунчер Minecraft:zh:Minecraft启动器