Minecraft:Quick Play: Difference between revisions
More actions
Remove broken links to missing pages |
Sync: updated from Minecraft |
||
| (5 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
'''Quick Play''' is a feature available in the ''Minecraft Launcher'', allowing players to directly join a singleplayer world or a [[Minecraft:multiplayer]] server, by skipping the | '''Quick Play''' is a feature available in the ''[[Minecraft:Minecraft Launcher]]'', allowing players to directly join a [[Minecraft:singleplayer]] world or a [[Minecraft:multiplayer]] server, by skipping the menus in-between.<ref>{{mcnet|quick-play-coming-java-and-bedrock-edition|Quick Play is coming to Java and Bedrock Edition|February 12, 2024}}</ref> | ||
== Usage == | == Usage == | ||
[[File:Launcher Quick Play.png|thumb|The launcher with the Quick Play | [[File:Launcher Quick Play.png|thumb|The launcher with the Quick Play buttons selected]] | ||
Quick Play instances are created automatically once you play in a world or a server. They appear as icons stacked next to the green "Play" button on the ''Java Edition'' or ''Bedrock Edition'' tabs of the launcher. By hovering over the icons with the mouse, all buttons are shown separately and show the name, installation, last played date, multiplayer type, and game mode. | Quick Play instances are created automatically once you play in a world or a server. They appear as icons stacked next to the green "Play" button on the ''Java Edition'' or ''Bedrock Edition'' tabs of the launcher. By hovering over the icons with the mouse, all buttons are shown separately and show the name, installation, last played date, multiplayer type, and game mode. | ||
| Line 9: | Line 9: | ||
There are a total of five slots. Once they are all filled, playing another world causes the oldest instance to be removed from the list, and the newest instance to be added. This behavior can be avoided by pinning instances; however, pinned instances still count for the five slots. | There are a total of five slots. Once they are all filled, playing another world causes the oldest instance to be removed from the list, and the newest instance to be added. This behavior can be avoided by pinning instances; however, pinned instances still count for the five slots. | ||
Quick Play works for both [[Minecraft:Java Edition|''Java Edition'']] and [[Minecraft:Bedrock Edition|''Bedrock Edition'']], and creates instances for worlds, ''Editor'' projects, servers and [[Minecraft:Realms]]. Realms can also be opened through Quick Play from the "Realms" tab. | Quick Play works for both [[Minecraft:Java Edition|''Java Edition'']] and [[Minecraft:Bedrock Edition|''Bedrock Edition'']], and creates instances for [[Minecraft:worlds]], ''Editor'' [[Minecraft:projects]], [[Minecraft:servers]] and [[Minecraft:Realms]]. Realms can also be opened through Quick Play from the "Realms" tab. | ||
If one plays a world with the same name, the icon is reused. | If one plays a world with the same name, the icon is reused. | ||
| Line 16: | Line 16: | ||
[[File:Launcher settings Quick Play.png|thumb|Settings related to Quick Play in the launcher.]] | [[File:Launcher settings Quick Play.png|thumb|Settings related to Quick Play in the launcher.]] | ||
Quick Play can be toggled in the launcher settings. Disabling it does not remove instances, therefore enabling it again displays previously saved instances. | Quick Play can be toggled in the [[Minecraft:Minecraft Launcher#Settings|launcher settings]]. Disabling it does not remove instances, therefore enabling it again displays previously saved instances. | ||
To actually remove quick play instances, you can click on the "Delete All Quick Play Entries" button. After a confirmation dialog, it deletes all instances, pinned and unpinned, of the user currently logged in. | To actually remove quick play instances, you can click on the "Delete All Quick Play Entries" button. After a confirmation dialog, it deletes all instances, pinned and unpinned, of the user currently logged in. | ||
== Options == | == Options == | ||
[[File:Edit Quick Play Game Bedrock.png|thumb|The edit window for quick play.]] | |||
[[File:Edit Quick Play Game Bedrock.png|thumb|The edit window for | |||
Quick Play instances can be customized by clicking on the button at the right of quick play icons. | Quick Play instances can be customized by clicking on the button at the right of quick play icons. | ||
An instance icon can be changed. For [[Minecraft:Java Edition|''Java Edition'']], these are the same 3D-rendered icons as the ones for installations. For [[Minecraft:Bedrock Edition|''Bedrock Edition'']], these are 2D square icons. It is also possible to select a custom icon, which must be 128x128 pixels in size. | An instance icon can be changed. For [[Minecraft:Java Edition|''Java Edition'']], these are the same 3D-rendered icons as the ones for [[Minecraft:Minecraft Launcher#Installations|installations]]. For [[Minecraft:Bedrock Edition|''Bedrock Edition'']], these are 2D square icons. It is also possible to select a custom icon, which must be 128x128 pixels in size. | ||
An instance can be pinned, which moves it to the very left. On the edit screen, pinned and non-pinned instances are separated by a vertical bar. To change order of pinned instances, you have to unpin and pin again an instance. | An instance can be pinned, which moves it to the very left. On the edit screen, pinned and non-pinned instances are separated by a vertical bar. To change order of pinned instances, you have to unpin and pin again an instance. | ||
The third option, "Show Title Initial", displays the first letter of the instance name on the icon, in uppercase. For example, on the | The third option, "Show Title Initial", displays the first letter of the instance name on the icon, in uppercase. For example, on the image on the right, checking this option would display an uppercase white "M" in front of the logo. | ||
== Command line arguments == | == Command line arguments == | ||
{{exclusive|java|section=1}} | {{exclusive|java|section=1}} | ||
These [[Minecraft:Java Edition client command line arguments#Game arguments|command line game arguments]] can be used to automatically join a world or server once the game has started. | |||
{| class="wikitable | {| class="wikitable" | ||
|- | |- | ||
! Argument | ! Argument | ||
! Description | ! Description | ||
|- | |- | ||
| {{ | | {{code|--quickPlaySingleplayer [{{ph|world folder name}}]}} | ||
| | | Automatically joins the singleplayer world once the game has started. Defaults to the most recently played world if the folder name is omitted. | ||
|- | |- | ||
| {{ | | {{code|--quickPlayMultiplayer {{ph|server address}}}} | ||
| | | Automatically joins the server once the game has started. | ||
|- | |- | ||
| {{ | | {{code|--quickPlayRealms {{ph|Realm ID}}}} | ||
| | | Automatically joins the Realm once the game has started. | ||
|- | |- | ||
| {{ | | {{code|--quickPlayPath {{ph|quick play logs path}}}} | ||
| | | Sets the path to the file to write [[Minecraft:Quick Play#Logs|Quick Play logs]] to, relative to the instance's files. | ||
|} | |} | ||
== JSON format == | == JSON format == | ||
This is the JSON format for | This is the JSON format for {{file|file|[[Minecraft:.minecraft]]/launcher_quick_play.json}}. | ||
<div class="treeview"> | <div class="treeview"> | ||
| Line 69: | Line 63: | ||
**** {{nbt|string|customizedIcon}}: The image data of the customized icon, if applicable. | **** {{nbt|string|customizedIcon}}: The image data of the customized icon, if applicable. | ||
**** {{nbt|long|epochLastPlayedTimeMs}}: The timestamp when the world or server was last played. | **** {{nbt|long|epochLastPlayedTimeMs}}: The timestamp when the world or server was last played. | ||
**** {{nbt|string|id}}: The | **** {{nbt|string|id}}: The folder name of the singleplayer world, the address of the server, or the ID of the Realm. If {{nbt|string|source}} is {{cd|Launcher}}, seems to always be {{cd|bedrock-retail}}.{{info needed|Is it always bedrock-retail, even in Java?}} | ||
**** {{nbt|string|name}}: The name of the | **** {{nbt|string|name}}: The name of the singleplayer world, the name of the server if it is in the server list, {{code|Minecraft Server}} if the server is not in the list, or the name of the Realm. | ||
**** {{nbt|string|source}}: The source of the instance. Can be {{cd|Java}}, {{cd|Bedrock}} or {{cd|Launcher}}. Additional fields depend on its value. | **** {{nbt|string|source}}: The source of the instance. Can be {{cd|Java}}, {{cd|Bedrock}} or {{cd|Launcher}}. Additional fields depend on its value. | ||
**** {{nbt|int|pinnedIndex}}: If the instance is pinned, represents the index in the pinned list. | **** {{nbt|int|pinnedIndex}}: If the instance is pinned, represents the index in the pinned list. | ||
****; If {{cd|source}} is {{cd|Java}}, additional field is as follows<nowiki>:</nowiki> | ****; If {{cd|source}} is {{cd|Java}}, additional field is as follows<nowiki>:</nowiki> | ||
**** {{nbt|compound|javaInstance}}: An object representing a Java Edition | **** {{nbt|compound|javaInstance}}: An object representing a Java Edition Quick Play instance. | ||
***** {{nbt|string|configId}}: The ID of the launcher profile. | ***** {{nbt|string|configId}}: The ID of the [[Minecraft:launcher_profiles.json|launcher profile]]. | ||
***** {{nbt|compound|game}} | ***** {{nbt|compound|game}} | ||
****** {{nbt|string|gamemode}}: The | ****** {{nbt|string|gamemode}}: The game mode the world was joined in. One of {{code|adventure}}, {{code|creative}}, {{code|spectator}} or {{code|survival}}. | ||
****** {{nbt|string|type}}: The type of | ****** {{nbt|string|type}}: The type of world joined. One of {{code|singleplayer}}, {{code|multiplayer}} or {{code|realms}}. | ||
****; If {{cd|source}} is {{cd|Bedrock}}, additional field is as follows<nowiki>:</nowiki> | ****; If {{cd|source}} is {{cd|Bedrock}}, additional field is as follows<nowiki>:</nowiki> | ||
**** {{nbt|compound|bedrockInstance}}: An object representing a Bedrock Edition | **** {{nbt|compound|bedrockInstance}}: An object representing a Bedrock Edition Quick Play instance. | ||
***** {{nbt|string|gamemode}}: The | ***** {{nbt|string|gamemode}}: The game mode the world was joined in. One of {{code|adventure}}, {{code|creative}}, {{code|spectator}} or {{code|survival}}. | ||
***** {{nbt|compound|local}} | ***** {{nbt|compound|local}} | ||
****** {{nbt|string|levelId}}: The unique ID of the world. | ****** {{nbt|string|levelId}}: The unique ID of the world. | ||
****** {{nbt|string|name}}: The user-defined name of the world. | ****** {{nbt|string|name}}: The user-defined name of the world. | ||
***** {{nbt|string|type}}: The type of | ***** {{nbt|string|type}}: The type of world joined. One of {{code|singleplayer}}, {{code|multiplayer}} or {{code|realms}}. | ||
***** {{nbt|string|versionId}}: The version ID of the instance. Seems to always be {{cd|retail}}. | ***** {{nbt|string|versionId}}: The version ID of the instance. Seems to always be {{cd|retail}}. | ||
****; If {{cd|source}} is {{cd|Launcher}}, additional field is as follows<nowiki>:</nowiki> | ****; If {{cd|source}} is {{cd|Launcher}}, additional field is as follows<nowiki>:</nowiki> | ||
| Line 95: | Line 89: | ||
The Quick Play feature is stored only locally in the run directory. | The Quick Play feature is stored only locally in the run directory. | ||
== Logs == | |||
{{exclusive|java|section=1}} | |||
This is the JSON format for Quick Play logs, which are written when the game successfully joins a world or server through Quick Play, and saved to the Quick Play logs path specified with the {{code|--quickPlayPath}} [[Minecraft:Java Edition client command line arguments#Game arguments|command line game argument]]. | |||
<div class="treeview"> | |||
* {{nbt|list}} A list containing exactly one Quick Play log. | |||
** {{nbt|compound|Quick Play log}} | |||
*** {{nbt|string|type}}: The type of world joined. One of {{code|singleplayer}}, {{code|multiplayer}} or {{code|realms}}. | |||
*** {{nbt|string|id}}: The folder name of the singleplayer world, the address of the server, or the ID of the Realm. | |||
*** {{nbt|string|name}}: The name of the singleplayer world, the name of the server if it is in the server list, {{code|Minecraft Server}} if the server is not in the list, or the name of the Realm. | |||
*** {{nbt|string|lastPlayedTime}}: The current timestamp as ISO 8601 in UTC with microsecond precision. | |||
*** {{nbt|string|gamemode}}: The game mode the world was joined in. One of {{code|adventure}}, {{code|creative}}, {{code|spectator}} or {{code|survival}}. | |||
</div> | |||
== History == | == History == | ||
| Line 120: | Line 130: | ||
{{Navbox Bedrock Edition}} | {{Navbox Bedrock Edition}} | ||
de:Schnellspiel | [[Minecraft:de:Schnellspiel]] | ||
fr:Partie rapide | [[Minecraft:fr:Partie rapide]] | ||
zh:快速进入游戏 | [[Minecraft:pt:Partida rápida]] | ||
[[Minecraft:zh:快速进入游戏]] | |||
Latest revision as of 11:14, 26 June 2026
Quick Play is a feature available in the Minecraft:Minecraft Launcher, allowing players to directly join a Minecraft:singleplayer world or a Minecraft:multiplayer server, by skipping the menus in-between.<ref>Template:Mcnet</ref>
Usage
Quick Play instances are created automatically once you play in a world or a server. They appear as icons stacked next to the green "Play" button on the Java Edition or Bedrock Edition tabs of the launcher. By hovering over the icons with the mouse, all buttons are shown separately and show the name, installation, last played date, multiplayer type, and game mode. Instances are sorted from the most recently played (bottom) to the least recently played (top).
There are a total of five slots. Once they are all filled, playing another world causes the oldest instance to be removed from the list, and the newest instance to be added. This behavior can be avoided by pinning instances; however, pinned instances still count for the five slots.
Quick Play works for both Java Edition and Bedrock Edition, and creates instances for Minecraft:worlds, Editor Minecraft:projects, Minecraft:servers and Minecraft:Realms. Realms can also be opened through Quick Play from the "Realms" tab.
If one plays a world with the same name, the icon is reused.
Disabling Quick Play
Quick Play can be toggled in the launcher settings. Disabling it does not remove instances, therefore enabling it again displays previously saved instances.
To actually remove quick play instances, you can click on the "Delete All Quick Play Entries" button. After a confirmation dialog, it deletes all instances, pinned and unpinned, of the user currently logged in.
Options
Quick Play instances can be customized by clicking on the button at the right of quick play icons.
An instance icon can be changed. For Java Edition, these are the same 3D-rendered icons as the ones for installations. For Bedrock Edition, these are 2D square icons. It is also possible to select a custom icon, which must be 128x128 pixels in size.
An instance can be pinned, which moves it to the very left. On the edit screen, pinned and non-pinned instances are separated by a vertical bar. To change order of pinned instances, you have to unpin and pin again an instance.
The third option, "Show Title Initial", displays the first letter of the instance name on the icon, in uppercase. For example, on the image on the right, checking this option would display an uppercase white "M" in front of the logo.
Command line arguments
These command line game arguments can be used to automatically join a world or server once the game has started.
| Argument | Description |
|---|---|
| Template:Code | Automatically joins the singleplayer world once the game has started. Defaults to the most recently played world if the folder name is omitted. |
| Template:Code | Automatically joins the server once the game has started. |
| Template:Code | Automatically joins the Realm once the game has started. |
| Template:Code | Sets the path to the file to write Quick Play logs to, relative to the instance's files. |
JSON format
This is the JSON format for Template:File.
- Template:Nbt The root object.
- Template:Nbt
- Template:Nbt: A list of Quick Play instances. The field name is the remote ID of a Microsoft account.
- Template:Nbt: The image data of the customized icon, if applicable.
- Template:Nbt: The timestamp when the world or server was last played.
- Template:Nbt: The folder name of the singleplayer world, the address of the server, or the ID of the Realm. If Template:Nbt is Template:Cd, seems to always be Template:Cd.Template:Info needed
- Template:Nbt: The name of the singleplayer world, the name of the server if it is in the server list, Template:Code if the server is not in the list, or the name of the Realm.
- Template:Nbt: The source of the instance. Can be Template:Cd, Template:Cd or Template:Cd. Additional fields depend on its value.
- Template:Nbt: If the instance is pinned, represents the index in the pinned list.
- If Template:Cd is Template:Cd, additional field is as follows:
- Template:Nbt: An object representing a Java Edition Quick Play instance.
- Template:Nbt: The ID of the launcher profile.
- Template:Nbt
- Template:Nbt: The game mode the world was joined in. One of Template:Code, Template:Code, Template:Code or Template:Code.
- Template:Nbt: The type of world joined. One of Template:Code, Template:Code or Template:Code.
- If Template:Cd is Template:Cd, additional field is as follows:
- Template:Nbt: An object representing a Bedrock Edition Quick Play instance.
- Template:Nbt: The game mode the world was joined in. One of Template:Code, Template:Code, Template:Code or Template:Code.
- Template:Nbt
- Template:Nbt: The unique ID of the world.
- Template:Nbt: The user-defined name of the world.
- Template:Nbt: The type of world joined. One of Template:Code, Template:Code or Template:Code.
- Template:Nbt: The version ID of the instance. Seems to always be Template:Cd.
- If Template:Cd is Template:Cd, additional field is as follows:
- Template:Nbt: An object representing a Launcher instance. This type of instance does not appear in the launcher.
- Template:Nbt: The ID of the product. Seems to always be Template:Cd.
- Template:Nbt: The version ID of the instance. Seems to always be Template:Cd.
- Template:Nbt: A list of Quick Play instances. The field name is the remote ID of a Microsoft account.
- Template:Nbt: The version number of the file.
- Template:Nbt
The Quick Play feature is stored only locally in the run directory.
Logs
This is the JSON format for Quick Play logs, which are written when the game successfully joins a world or server through Quick Play, and saved to the Quick Play logs path specified with the Template:Code command line game argument.
- Template:Nbt A list containing exactly one Quick Play log.
- Template:Nbt
- Template:Nbt: The type of world joined. One of Template:Code, Template:Code or Template:Code.
- Template:Nbt: The folder name of the singleplayer world, the address of the server, or the ID of the Realm.
- Template:Nbt: The name of the singleplayer world, the name of the server if it is in the server list, Template:Code if the server is not in the list, or the name of the Realm.
- Template:Nbt: The current timestamp as ISO 8601 in UTC with microsecond precision.
- Template:Nbt: The game mode the world was joined in. One of Template:Code, Template:Code, Template:Code or Template:Code.
- Template:Nbt
History
Java Edition
Minecraft Launcher
References
Template:Navbox Java Edition technical Template:Navbox Bedrock Edition
Minecraft:de:Schnellspiel Minecraft:fr:Partie rapide Minecraft:pt:Partida rápida Minecraft:zh:快速进入游戏