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
 
(3 intermediate revisions by the same user not shown)
Line 16: Line 16:
|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|Key art by Mojang Studios]]


The '''''Minecraft Launcher''''' is the main game downloader and launcher for {{JE}}, {{BE}}, {{MCD}}, and {{MCL}}. It is available for {{w|Microsoft Windows|Windows}}, {{w|macOS}} and {{w|Linux}}, 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.
The '''''Minecraft Launcher''''' is the main game downloader and launcher for {{JE}}, {{BE}}, {{MCD}}, {{MCD2}} and {{MCL}} on PC. It is available for {{w|Microsoft Windows|Windows}}, {{w|macOS}} and {{w|Linux}}, but ''Minecraft: Bedrock Edition'', ''Minecraft Dungeons'', and ''Minecraft Legends'' can be played only on Windows.


== Features ==
== Features ==
[[File:Launcher login.png|right|thumb|The initial login screen]]
[[File:Launcher login.png|thumb|The initial login screen|width=200x200]]
[[File:Minecraft Launcher Animated Loading Screen.webp|thumb|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 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.
On the left side, all tabs can be selected. The launcher version is shown in the bottom-left.


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.
=== Home ===
The "Home" tabs contains a button to play, with a dropdown allowing to select a game and installation, as well as [[Minecraft:Quick Play]] links. The Home tab also shows the player's [[Minecraft:Minecoin]] balance with a link to purchase more, and a button to open the [[Minecraft:Inbox]] with ''Bedrock Edition'' news messages.
 
The rest of the page is filled with promotions and [[Minecraft:minecraft.net]] news articles.
 
=== Account ===
The top left corner of the ''Minecraft Launcher'' contains the user's Xbox [[Minecraft:gamertag]] for the currently active account (which might differ from their ''Java Edition'' username<ref>https://help.minecraft.net/hc/articles/360052640612</ref>). Clicking on it shows a dropdown:
 
* Help, with links to various support websites, official social media, and the [[Minecraft:Minecraft Wiki (website)|Minecraft Wiki]] and [https://www.planetminecraft.com/forums/?OCID=Launcher Planet Minecraft].
* Manage profile, opening the player's [[Minecraft:Profile]] page similar to the one on minecraft.net. Players can view their games, account information, Realms, and ''Bedrock Edition'' profile information here, as well as various external links.
* A link to the profile page on minecraft.net, with mostly the same options.
* Log out
* An account selector. Multiple accounts can be stored only on Linux and macOS, and can be switched here.
* View all accounts, opening the Account settings.
 
=== What's new ===
This screen shows changes in recent launcher updates.<gallery widths="220" heights="140">
File:Launcher help page.png|The Help page
File:Launcher profile.png|The Profile with the Bedrock Profile drawer open
File:Launcher whats new.png|The What's new page
</gallery>


== ''Minecraft: Java Edition'' ==
== ''Minecraft: Java Edition'' ==
Line 56: Line 75:
* Resolution, which changes the game's window 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.
* Use Java argument files, whether the launcher writes JVM arguments and classpath to a temporary file instead of passing them directly in the command line invocation.
* 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.


Line 83: Line 101:


=== Realms ===
=== Realms ===
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.
In the "Realms" tab, the user can buy, quick play, and manage a ''[[Minecraft:Realms|Minecraft Realm]]''. Players can choose their installation of choice before launching a realm.


=== Skins ===
=== Skins ===
Line 97: Line 115:


== ''Minecraft: Bedrock Edition'' ==
== ''Minecraft: Bedrock Edition'' ==
[[File:Screenshot 2026-08-25 210601.jpg|thumb|width=283x283|The default view of the ''Minecraft: Bedrock Edition'' page in the ''Minecraft Launcher'']]
[[File:Launcher Bedrock Edition.png|thumb|300x300px|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).
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). On the top-right, a bell icon links to the [[Minecraft:Inbox]].


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.
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.
Line 106: Line 124:
* 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" tab is decorated with key art from the latest named update and allows ''[[Minecraft: Pixel Drift]]'' to be played in place.
The "Play" tab is decorated with key art from the latest named update and allows update music to be played. There can also be advertisements and there is a gift purchase.


=== Realms ===
=== Realms ===
[[File:The Minecraft Realms when you already invited.png|thumb|The "Realms" tab]]
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.
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" tab]]
[[File:Bedrock Editor Section.png|thumb|250x250px|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: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 tab includes 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" tab]]
[[File:Marketplace Pass Section.png|thumb|250x250px|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.
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.


Line 128: Line 147:


=== Patch notes ===
=== 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.
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.<gallery widths="220" heights="140">
File:Launcher faq.png|The "FAQ" tab
File:Launcher Bedrock installation.png|The "Installation" tab
File:Launcher patch notes.png|The "Patch notes" tab
</gallery>


== ''Minecraft Dungeons II'' ==
== ''Minecraft Dungeons II'' ==
Line 177: Line 200:


== Settings ==
== Settings ==
[[File:MC Launcher About Page.png|thumb|The "About" tab in the ''Minecraft Launcher'' settings.]]
There are 3 tabs on the settings page: General, Accounts, and About.
There are 3 tabs on the settings page: General, Accounts, and About.


In the main "General" tab, users can:
=== General ===
* Change the ''Minecraft Launcher'' language. There are 63 languages available, including 3 joke languages (as of July 2026).
[[File:Launcher settings.png|thumb|The General settings]]
* Use the beta version of the ''Minecraft Launcher'', which requires restarting the launcher to start downloading if there is one available.
; Language (System language)
* Keep the ''Minecraft Launcher'' open while games are running.
: There are 63 languages available, including 3 joke languages.
* Enable animations in the ''Minecraft Launcher'', which are disabled by default to avoid potential motion sickness for some users.
; Review the Launcher
* Disable hardware acceleration.
: Opens the store review page.
* Review the launcher.
 
* Make text size bigger.
<u>Launcher settings</u>
* Disable video autoplay.
; Use beta version of the Launcher (OFF)
* Enable or disable [[Minecraft:Quick Play]] feature and delete all entries.
: After restarting, beta features will be applied.
; Keep the Launcher open while games are running (OFF)
: Enabling this prevents the launcher from closing automatically when a game launches.
; Animate transitions between pages in the Launcher (OFF)
: Screen animations are applied when changing pages or tabs.
; Animate play button on the Play pages in the Launcher (OFF)
: Animations can play on the Play button on some pages.
; Disable hardware acceleration (requires restarting the Launcher) (OFF)
 
<u>Launcher accessibility settings</u>
; Make text bigger (OFF)
: Increases the font size.
; Disable video autoplay (OFF)
: Videos, when available, will play automatically when this option is disabled.
 
<u>Minecraft: Java Edition settings</u>
; Open output log when Minecraft<nowiki>:</nowiki> Java Edition starts (OFF)
; Automatically send Minecraft<nowiki>:</nowiki> Java Edition crash reports to Mojang Studios (OFF)
; Show historical versions of Minecraft<nowiki>:</nowiki> Java Edition in the Launcher (OFF)
: In the version selector in the installations tab, versions prior to [[Minecraft:Java Edition 1.0.0|Release 1.0]] will be shown.
 
<u>Quick play</u>
; Enable Quick Play feature for Minecraft<nowiki>:</nowiki> Java Edition and Minecraft<nowiki>:</nowiki> Bedrock Edition (ON)
: Toggles to show [[Minecraft:Quick Play]] buttons.
; Delete All Quick Play Entries
: Permanently deletes all Quick Play data.


Options exclusively for ''Minecraft: Java Edition'':
<u>Inbox settings</u>
* Open the output log when the game starts.
; Show new inbox message badge (ON)
* Option to automatically send the game's crash reports to Mojang Studios.
: A red notification dot shows on the [[Minecraft:Inbox]] button when unread messages are available.
* 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.
; Mark all inbox messages as read
: Permanently marks all messages as read. This also applies to the Inbox in-game.
; Delete all read inbox messages
Permanently deletes all messages marked as read. This also applies to the Inbox in-game.


=== Accounts ===
[[File:Launcher acount settings.png|thumb|The "Account" tab]]
In the "Accounts" tab, users can add, switch, manage, or remove their Microsoft accounts.
In the "Accounts" tab, users can add, switch, manage, or remove their Microsoft accounts.


=== About ===
[[File:Launcher {{v|launcher|nolink=1}}.png|thumb|The "About" tab]]
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.
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, these options only apply to the old Unified Minecraft Launcher and NOT the Microsoft Store version.|type=issue|mini=1}}
{{Warning|On Windows, these options only apply to the old Unified Minecraft Launcher and not the Microsoft Store version.|section=1}}
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}} on Windows, {{cd|minecraft-launcher}} on 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]]
Line 224: Line 278:


== Uninstalling the old ''Minecraft Unified Launcher'' ==
== Uninstalling the old ''Minecraft Unified Launcher'' ==
{{Rewrite|Remove tutorial info and describe what the Unified Launcher actually is|section=1}}
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.


Line 298: Line 353:
* Game crashes are reported to Mojang Studios through [[Minecraft:Hopper (crash utility)|Hopper]].
* Game crashes are reported to Mojang Studios through [[Minecraft:Hopper (crash utility)|Hopper]].
* The legacy ''Minecraft Launcher'' can be downloaded {{dl|eabbff5ff8e21250e33670924a0c5e38f47c840b|custom|name=launcher.jar|title=here}} (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.
* The legacy ''Minecraft Launcher'' can be downloaded {{dl|eabbff5ff8e21250e33670924a0c5e38f47c840b|custom|name=launcher.jar|title=here}} (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 [https://www.mayoclinic.org/diseases-conditions/sarcoma/symptoms-causes/syc-20351048 cancer].
* [[File:Technoblade On Launch Screen.png|thumb|Close up of the pig with Technoblade’s crown]]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 [https://www.mayoclinic.org/diseases-conditions/sarcoma/symptoms-causes/syc-20351048 cancer].
* The Armadillo loading screen animation is scaled to 1280×720 (16:9) but was originally 646×364 (&approx;16:9.02), causing distortion to the animation.
* The Armadillo loading screen animation is scaled to 1280×720 (16:9) but was originally 646×364 (&approx;16:9.02), causing distortion to the animation.


== Gallery ==
== Gallery ==
=== General ===
<gallery>
<gallery>
File:Minecraft Launcher MS Icon.png|''Minecraft Launcher for Windows'' app icon
File:Minecraft Launcher MS Icon.png|''Minecraft Launcher for Windows'' app icon
Line 309: Line 366:
File:MCL vertical key art.png|''Minecraft Launcher'' Microsoft Store vertical key art
File:MCL vertical key art.png|''Minecraft Launcher'' Microsoft Store vertical key art
File:Minecraft Launcher Xbox Horizontal Key Art.jpg|''Minecraft Launcher'' Microsoft Store horizontal key art
File:Minecraft Launcher Xbox Horizontal Key Art.jpg|''Minecraft Launcher'' Microsoft Store horizontal key art
File:MCL splash screen.png|''Minecraft Launcher for Windows'' splash screen
File:Launcher BE MacOS.png|The ''Bedrock Edition'' screen on macOS
File:Launcher buy minecoins.png|The Minecoin purchase page
File:Launcher inbox.png|The Inbox
File:Edit Quick Play Game Bedrock.png|Quick Play edit window
</gallery>
==== Old ====
<gallery>
File:MCL horizontal key art.png|Old ''Minecraft Launcher'' Microsoft Store horizontal key art
File:MCL horizontal key art.png|Old ''Minecraft Launcher'' Microsoft Store horizontal key art
File:MCL splash screen.png|''Minecraft Launcher for Windows'' splash screen
File:Launcher Armored Paws Loading.webp|The initial loading screen (2024-2025)
File:Launcher Armored Paws Loading.webp|The initial loading screen (2024-2025)
File:Minecraft Launcher Animated Loading Screen.webp|The initial loading screen (2025-present)
File:Minecraft Launcher Animated Loading Screen.webp|The initial loading screen (Mounts of Mayhem)
File:Launcher login.png|The initial login screen
File:A Minecraft Movie Launcher Section.png|''[[Minecraft:A Minecraft Movie]]'' tab
File:Minecraft Launcher.png|The home tab
File:Minecraft launcher.svg|Old app icon
File:Launcher JE tab.png|The ''Minecraft: Java Edition'' tab
File:Poisonous-potato-Minecraft-Launcher-font.png|[[Minecraft:Poisonous Potato Update|Poisonous Potato]] "play" font
File:Launcher BE tab.png|The ''Minecraft: Bedrock Edition'' tab
File:Launcher 2.3.443 Minecraft Live Tab.png|[[Minecraft:Minecraft LIVE|Minecraft Live]] tab
File:Launcher MCD2 tab 2.png|The ''Minecraft Dungeons II'' tab during pre-order
File:Launcher Alex.png|A removed Alex skin that used to represent the default [[Minecraft:Alex]] on the Skins tab. Selecting this would simply give the player the default one instead.
File:Launcher MCD tab.png|The ''Minecraft Dungeons'' tab
File:Launcher Alex (texture).png|A texture recreation of the removed Alex skin
File:Launcher MCL tab.png|The ''Minecraft Legends'' tab
File:A Minecraft Movie Launcher Section.png|''A Minecraft Movie'' tab
File:Technoblade On Launch Screen.png|Close up of the pig with Technoblade’s crown. Added as a memorial after famous YouTuber Technoblade had passed away.
File:Minecraft launcher.svg|Old Minecraft Launcher app icon
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 BE MacOS.png|The ''Bedrock Edition'' screen on macOS
</gallery>
</gallery>


Line 336: Line 394:
File:Mclauncher already running 2020.png|A warning about running another copy of the game if it is already running
File:Mclauncher already running 2020.png|A warning about running another copy of the game if it is already running
File:MC Launcher Safety Warning.png|A warning about playing a version that doesn't support the latest player safety features
File:MC Launcher Safety Warning.png|A warning about playing a version that doesn't support the latest player safety features
File:Launcher Alex.png|A removed Alex skin that used to represent the default [[Minecraft:Alex]] on the Skins tab. Selecting this would simply give the player the default one instead.
File:Launcher Alex (texture).png|A texture recreation of the removed Alex skin
</gallery>
</gallery>


=== Backgrounds ===
=== Historical screenshots ===
<gallery>
File:Mounts of Mayhem Key Art.png|The background for ''[[Minecraft:Java Edition]]'' and ''[[Minecraft:Bedrock Edition]]'', featuring the [[Minecraft:Mounts of Mayhem]] official artwork
File:Minecraft Dungeons Key Art (without logo).jpeg|The background for ''[[Minecraft:Minecraft Dungeons]]''
File:MCLUltimateEditionArtwork.jpg|The background for ''[[Minecraft:Minecraft Legends]]''
File:Launcher login background.jpg|The old background for the initial login screen
</gallery>


=== Version history ===
==== Version history ====
<gallery>
<gallery>
AlphaLauncher.png|The first ''Minecraft Launcher''
AlphaLauncher.png|The first ''Minecraft Launcher''
Line 363: Line 413:
</gallery>
</gallery>


=== 2013–16 ===
==== 2013–16 ====
<gallery>
<gallery>
Grum Launcher.png|The 2013 launcher in development
Grum Launcher.png|The 2013 launcher in development
Line 376: Line 426:
</gallery>
</gallery>


=== 2016–19 ===
==== 2016–19 ====
<gallery>
<gallery>
2016LauncherProfileIcons.png|Profile icons selection from the launcher
2016LauncherProfileIcons.png|Profile icons selection from the launcher
Line 397: Line 447:
== Navigation ==
== Navigation ==
{{Navbox Minecraft (franchise)|games}}
{{Navbox Minecraft (franchise)|games}}
[[Category:Minecraft Launcher]]


[[Minecraft:cs:Spouštěč Minecraftu]]
[[Minecraft:cs:Spouštěč Minecraftu]]
Line 402: Line 453:
[[Minecraft:es:Lanzador de Minecraft]]
[[Minecraft:es:Lanzador de Minecraft]]
[[Minecraft:fr:Launcher]]
[[Minecraft:fr:Launcher]]
[[Minecraft:he:Minecraft Launcher]]
[[Minecraft:it:Launcher di Minecraft]]
[[Minecraft:it:Launcher di Minecraft]]
[[Minecraft:ja:Minecraftランチャー]]
[[Minecraft:ja:Minecraftランチャー]]

Latest revision as of 11:24, 29 September 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 Template:JE, Template:BE, Template:MCD, Template:MCD2 and Template:MCL on PC. It is available for Template:W, Template:W and Template:W, but Minecraft: Bedrock Edition, Minecraft Dungeons, and Minecraft Legends can be played only on Windows.

Features

File:Launcher login.png
width=200x200

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, all tabs can be selected. The launcher version is shown in the bottom-left.

Home

The "Home" tabs contains a button to play, with a dropdown allowing to select a game and installation, as well as Minecraft:Quick Play links. The Home tab also shows the player's Minecraft:Minecoin balance with a link to purchase more, and a button to open the Minecraft:Inbox with Bedrock Edition news messages.

The rest of the page is filled with promotions and Minecraft:minecraft.net news articles.

Account

The top left corner of the Minecraft Launcher contains the user's Xbox Minecraft:gamertag for the currently active account (which might differ from their Java Edition username<ref>https://help.minecraft.net/hc/articles/360052640612</ref>). Clicking on it shows a dropdown:

  • Help, with links to various support websites, official social media, and the Minecraft Wiki and Planet Minecraft.
  • Manage profile, opening the player's Minecraft:Profile page similar to the one on minecraft.net. Players can view their games, account information, Realms, and Bedrock Edition profile information here, as well as various external links.
  • A link to the profile page on minecraft.net, with mostly the same options.
  • Log out
  • An account selector. Multiple accounts can be stored only on Linux and macOS, and can be switched here.
  • View all accounts, opening the Account settings.

What's new

This screen shows changes in recent launcher updates.

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, quick 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:Launcher Bedrock Edition.png
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). On the top-right, a bell icon links to the Minecraft:Inbox.

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 update music to be played. There can also be advertisements and there is a gift purchase.

Realms

File:The Minecraft Realms when you already invited.png
The "Realms" tab

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

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

General

File:Launcher settings.png
The General settings
Language (System language)
There are 63 languages available, including 3 joke languages.
Review the Launcher
Opens the store review page.

Launcher settings

Use beta version of the Launcher (OFF)
After restarting, beta features will be applied.
Keep the Launcher open while games are running (OFF)
Enabling this prevents the launcher from closing automatically when a game launches.
Animate transitions between pages in the Launcher (OFF)
Screen animations are applied when changing pages or tabs.
Animate play button on the Play pages in the Launcher (OFF)
Animations can play on the Play button on some pages.
Disable hardware acceleration (requires restarting the Launcher) (OFF)

Launcher accessibility settings

Make text bigger (OFF)
Increases the font size.
Disable video autoplay (OFF)
Videos, when available, will play automatically when this option is disabled.

Minecraft: Java Edition settings

Open output log when Minecraft: Java Edition starts (OFF)
Automatically send Minecraft: Java Edition crash reports to Mojang Studios (OFF)
Show historical versions of Minecraft: Java Edition in the Launcher (OFF)
In the version selector in the installations tab, versions prior to Release 1.0 will be shown.

Quick play

Enable Quick Play feature for Minecraft: Java Edition and Minecraft: Bedrock Edition (ON)
Toggles to show Minecraft:Quick Play buttons.
Delete All Quick Play Entries
Permanently deletes all Quick Play data.

Inbox settings

Show new inbox message badge (ON)
A red notification dot shows on the Minecraft:Inbox button when unread messages are available.
Mark all inbox messages as read
Permanently marks all messages as read. This also applies to the Inbox in-game.
Delete all read inbox messages

Permanently deletes all messages marked as read. This also applies to the Inbox in-game.

Accounts

File:Launcher acount settings.png
The "Account" tab

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

About

[[File:Launcher Template:V.png|thumb|The "About" tab]] 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:Warning 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

Template:Rewrite 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.
  • File:Technoblade On Launch Screen.png
    Close up of the pig with Technoblade’s crown
    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

General

Old

Minecraft: Java Edition

Historical screenshots

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:he:Minecraft 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启动器