Minecraft:Quick Play: Difference between revisions
More actions
Remove broken links to missing pages |
Fix template calls: add MC/ prefix |
||
| Line 33: | Line 33: | ||
== Command line arguments == | == Command line arguments == | ||
{{ | {{MC/Exclusive|java|section=1}} | ||
The following table describes the command line arguments used to launch the game directly into a world. | The following table describes the command line arguments used to launch the game directly into a world. | ||
| Line 43: | Line 43: | ||
! Example | ! Example | ||
|- | |- | ||
| {{ | | {{MC/Cd|quickPlayPath}} | ||
| Takes a specified path of a file containing information about the world to join, relative to the run directory. | | Takes a specified path of a file containing information about the world to join, relative to the run directory. | ||
| {{ | | {{MC/Cd|--quickPlayPath "quickPlay/log.json"}} (resolved into {{MC/Cd|.minecraft/quickPlay/log.json}}) | ||
|- | |- | ||
| {{ | | {{MC/Cd|quickPlaySingleplayer}} | ||
| Takes a specified identifier representing the folder name of the world. | | Takes a specified identifier representing the folder name of the world. | ||
| {{ | | {{MC/Cd|--quickPlaySingleplayer "New World"}} | ||
|- | |- | ||
| {{ | | {{MC/Cd|quickPlayMultiplayer}} | ||
| Takes a specified identifier representing the IP address and port of the server, separated by a colon. | | Takes a specified identifier representing the IP address and port of the server, separated by a colon. | ||
| {{ | | {{MC/Cd|--quickPlayMultiplayer "localhost:25565"}} | ||
|- | |- | ||
| {{ | | {{MC/Cd|quickPlayRealms}} | ||
| Takes a specified identifier representing the ID of the Realm. | | Takes a specified identifier representing the ID of the Realm. | ||
| {{ | | {{MC/Cd|--quickPlayRealms "1234"}} | ||
|} | |} | ||
| Line 64: | Line 64: | ||
<div class="treeview"> | <div class="treeview"> | ||
* {{ | * {{MC/Nbt|compound}} The root object. | ||
** {{ | ** {{MC/Nbt|compound|quickPlayData}} | ||
*** {{ | *** {{MC/Nbt|list|<remoteId>}}: A list of Quick Play instances. The field name is the remote ID of a Microsoft account. | ||
**** {{ | **** {{MC/Nbt|string|customizedIcon}}: The image data of the customized icon, if applicable. | ||
**** {{ | **** {{MC/Nbt|long|epochLastPlayedTimeMs}}: The timestamp when the world or server was last played. | ||
**** {{ | **** {{MC/Nbt|string|id}}: The ID of the instance. For singleplayer, this is the folder name of the world. For multiplayer, this is the server IP address. If {{MC/Nbt|string|source}} is {{MC/Cd|Launcher}}, seems to always be {{MC/Cd|bedrock-retail}}. | ||
**** {{ | **** {{MC/Nbt|string|name}}: The name of the instance, which is the user-defined name of the world or server. | ||
**** {{ | **** {{MC/Nbt|string|source}}: The source of the instance. Can be {{MC/Cd|Java}}, {{MC/Cd|Bedrock}} or {{MC/Cd|Launcher}}. Additional fields depend on its value. | ||
**** {{ | **** {{MC/Nbt|int|pinnedIndex}}: If the instance is pinned, represents the index in the pinned list. | ||
****; If {{ | ****; If {{MC/Cd|source}} is {{MC/Cd|Java}}, additional field is as follows<nowiki>:</nowiki> | ||
**** {{ | **** {{MC/Nbt|compound|javaInstance}}: An object representing a Java Edition quick play instance. | ||
***** {{ | ***** {{MC/Nbt|string|configId}}: The ID of the launcher profile. | ||
***** {{ | ***** {{MC/Nbt|compound|game}} | ||
****** {{ | ****** {{MC/Nbt|string|gamemode}}: The default game mode of the world. Can be {{MC/Cd|adventure}}, {{MC/Cd|creative}}, {{MC/Cd|spectator}} or {{MC/Cd|survival}}. | ||
****** {{ | ****** {{MC/Nbt|string|type}}: The type of the world. Can be {{MC/Cd|singleplayer}}, {{MC/Cd|multiplayer}} or {{MC/Cd|realms}}.{{MC/Verify|couldn't check for realms}} | ||
****; If {{ | ****; If {{MC/Cd|source}} is {{MC/Cd|Bedrock}}, additional field is as follows<nowiki>:</nowiki> | ||
**** {{ | **** {{MC/Nbt|compound|bedrockInstance}}: An object representing a Bedrock Edition quick play instance. | ||
***** {{ | ***** {{MC/Nbt|string|gamemode}}: The default game mode of the world. Can be {{MC/Cd|Adventure}}, {{MC/Cd|Creative}}, {{MC/Cd|Spectator}} or {{MC/Cd|Survival}}. | ||
***** {{ | ***** {{MC/Nbt|compound|local}} | ||
****** {{ | ****** {{MC/Nbt|string|levelId}}: The unique ID of the world. | ||
****** {{ | ****** {{MC/Nbt|string|name}}: The user-defined name of the world. | ||
***** {{ | ***** {{MC/Nbt|string|type}}: The type of the world. Can be {{MC/Cd|singleplayer}}, {{MC/Cd|multiplayer}} or {{MC/Cd|realms}}.{{MC/Verify|couldn't check for realms}} | ||
***** {{ | ***** {{MC/Nbt|string|versionId}}: The version ID of the instance. Seems to always be {{MC/Cd|retail}}. | ||
****; If {{ | ****; If {{MC/Cd|source}} is {{MC/Cd|Launcher}}, additional field is as follows<nowiki>:</nowiki> | ||
**** {{ | **** {{MC/Nbt|compound|productQuickPlay}}: An object representing a Launcher instance. This type of instance does not appear in the launcher. | ||
***** {{ | ***** {{MC/Nbt|string|productId}}: The ID of the product. Seems to always be {{MC/Cd|bedrock}}. | ||
***** {{ | ***** {{MC/Nbt|string|versionId}}: The version ID of the instance. Seems to always be {{MC/Cd|retail}}. | ||
** {{ | ** {{MC/Nbt|int|version}}: The version number of the file. | ||
</div> | </div> | ||
| Line 99: | Line 99: | ||
=== ''Java Edition'' === | === ''Java Edition'' === | ||
{{HistoryTable | {{HistoryTable | ||
|{{HistoryLine|java}} | |{{MC/HistoryLine|java}} | ||
|{{HistoryLine||1.20|dev=23w14a|Added support for Quick Play, with new command line arguments that allow the game to be launched directly into a world.}} | |{{MC/HistoryLine||1.20|dev=23w14a|Added support for Quick Play, with new command line arguments that allow the game to be launched directly into a world.}} | ||
}} | }} | ||
=== ''Minecraft Launcher'' === | === ''Minecraft Launcher'' === | ||
{{HistoryTable | {{HistoryTable | ||
|{{HistoryLine|launcher}} | |{{MC/HistoryLine|launcher}} | ||
|{{HistoryLine||2.7.12|Added quick play for {{JE}} as an experimental feature, disabled by default.<ref>[https://feedback.minecraft.net/hc/en-us/community/posts/18189595004173 Java Quick Play in the Launcher] - August 15, 2023</ref>}} | |{{HistoryLine||2.7.12|Added quick play for {{MC/JE}} as an experimental feature, disabled by default.<ref>[https://feedback.minecraft.net/hc/en-us/community/posts/18189595004173 Java Quick Play in the Launcher] - August 15, 2023</ref>}} | ||
|{{HistoryLine||2.17.13|Added quick play for {{BE}}, enabled by default. | |{{HistoryLine||2.17.13|Added quick play for {{MC/BE}}, enabled by default. | ||
|Quick play for {{JE}} is no longer experimental, and now enabled by default.}} | |Quick play for {{MC/JE}} is no longer experimental, and now enabled by default.}} | ||
|{{HistoryLine||2.19.2|Quick Play has been temporarily turned off for {{BE}}.}} | |{{HistoryLine||2.19.2|Quick Play has been temporarily turned off for {{MC/BE}}.}} | ||
|{{HistoryLine||?|Quick Play has been re-enabled for {{BE}}.}} | |{{HistoryLine||?|Quick Play has been re-enabled for {{MC/BE}}.}} | ||
}} | }} | ||
== References == | == References == | ||
{{ | {{MC/Reflist}} | ||
== Navigation == | == Navigation == | ||
{{Navbox Java Edition technical|general}} | {{MC/Navbox Java Edition technical|general}} | ||
{{Navbox Bedrock Edition}} | {{MC/Navbox Bedrock Edition}} | ||
de:Schnellspiel | de:Schnellspiel | ||
fr:Partie rapide | fr:Partie rapide | ||
zh:快速进入游戏 | zh:快速进入游戏 | ||
Latest revision as of 20:52, 9 April 2026
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 screens and 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 worlds, Editor projects, 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 first image on the right, checking this option would display an uppercase white "M" in front of the logo.
Command line arguments
Script error: No such module "Exclusive".
The following table describes the command line arguments used to launch the game directly into a world.
| Argument | Description | Example |
|---|---|---|
|
Takes a specified path of a file containing information about the world to join, relative to the run directory. |
Template:Redr (resolved into
|
|
Takes a specified identifier representing the folder name of the world. |
|
|
Takes a specified identifier representing the IP address and port of the server, separated by a colon. |
|
|
Takes a specified identifier representing the ID of the Realm. |
|
JSON format
This is the JSON format for launcher_quick_play.json, located in the root of the .minecraft folder.
- Template:Nbt/sprite The root object.
- Template:Nbt/sprite quickPlayData
- Template:Nbt/sprite <remoteId>: A list of Quick Play instances. The field name is the remote ID of a Microsoft account.
- Template:Nbt/sprite customizedIcon: The image data of the customized icon, if applicable.
- Template:Nbt/sprite epochLastPlayedTimeMs: The timestamp when the world or server was last played.
- Template:Nbt/sprite id: The ID of the instance. For singleplayer, this is the folder name of the world. For multiplayer, this is the server IP address. If Template:Nbt/sprite source is
- Template:Nbt/sprite <remoteId>: A list of Quick Play instances. The field name is the remote ID of a Microsoft account.
- Template:Nbt/sprite quickPlayData
- REDIRECT Template:Code
Template:Redr, seems to always be
- REDIRECT Template:Code
- Template:Nbt/sprite name: The name of the instance, which is the user-defined name of the world or server.
- Template:Nbt/sprite source: The source of the instance. Can be
- REDIRECT Template:Code
- REDIRECT Template:Code
- REDIRECT Template:Code
Template:Redr. Additional fields depend on its value.
- Template:Nbt/sprite pinnedIndex: If the instance is pinned, represents the index in the pinned list.
- If
- Template:Nbt/sprite pinnedIndex: If the instance is pinned, represents the index in the pinned list.
- REDIRECT Template:Code
- REDIRECT Template:Code
Template:Redr, additional field is as follows:
- Template:Nbt/sprite javaInstance: An object representing a Java Edition quick play instance.
- Template:Nbt/sprite configId: The ID of the launcher profile.
- Template:Nbt/sprite game
- Template:Nbt/sprite gamemode: The default game mode of the world. Can be
- Template:Nbt/sprite javaInstance: An object representing a Java Edition quick play instance.
- REDIRECT Template:Code
- REDIRECT Template:Code
- REDIRECT Template:Code
- REDIRECT Template:Code
- Template:Nbt/sprite type: The type of the world. Can be
- REDIRECT Template:Code
- REDIRECT Template:Code
- REDIRECT Template:Code
#vardefine: verifyedition |
}}<verify for {{#var:verifyedition}}></verify for {{#var:verifyedition}}>{{
#vardefine: verifyedition |
}}
- If
- REDIRECT Template:Code
- REDIRECT Template:Code
Template:Redr, additional field is as follows:
- Template:Nbt/sprite bedrockInstance: An object representing a Bedrock Edition quick play instance.
- Template:Nbt/sprite gamemode: The default game mode of the world. Can be
- Template:Nbt/sprite bedrockInstance: An object representing a Bedrock Edition quick play instance.
- REDIRECT Template:Code
- REDIRECT Template:Code
- REDIRECT Template:Code
- REDIRECT Template:Code
- Template:Nbt/sprite local
- Template:Nbt/sprite levelId: The unique ID of the world.
- Template:Nbt/sprite name: The user-defined name of the world.
- Template:Nbt/sprite type: The type of the world. Can be
- Template:Nbt/sprite local
- REDIRECT Template:Code
- REDIRECT Template:Code
- REDIRECT Template:Code
#vardefine: verifyedition |
}}<verify for {{#var:verifyedition}}></verify for {{#var:verifyedition}}>{{
#vardefine: verifyedition |
}}
- Template:Nbt/sprite versionId: The version ID of the instance. Seems to always be
- REDIRECT Template:Code
- If
- REDIRECT Template:Code
- REDIRECT Template:Code
Template:Redr, additional field is as follows:
- Template:Nbt/sprite productQuickPlay: An object representing a Launcher instance. This type of instance does not appear in the launcher.
- Template:Nbt/sprite productId: The ID of the product. Seems to always be
- Template:Nbt/sprite productQuickPlay: An object representing a Launcher instance. This type of instance does not appear in the launcher.
- REDIRECT Template:Code
- Template:Nbt/sprite versionId: The version ID of the instance. Seems to always be
- REDIRECT Template:Code
- Template:Nbt/sprite version: The version number of the file.
The Quick Play feature is stored only locally in the run directory.
History
Java Edition
Minecraft Launcher
References
<references group="">
</references>
| Editions |
| ||||||||
|---|---|---|---|---|---|---|---|---|---|
| Development |
| ||||||||
| Technical |
| ||||||||
| Multiplayer | |||||||||
| Exclusive features |
| ||||||||
| Removed |
de:Schnellspiel fr:Partie rapide zh:快速进入游戏