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

Minecraft:Quick Play: Difference between revisions

From SAS Gaming Wiki
SyncBot (talk | contribs)
Sync: updated from Minecraft
Tag: Manual revert
SyncBot (talk | contribs)
Sync: updated from Minecraft
 
Line 34: Line 34:
{{exclusive|java|section=1}}
{{exclusive|java|section=1}}


The following table describes the command line arguments used to launch the game directly into a world.
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" data-description="Command line arguments"
{| class="wikitable"
|-
|-  
! Argument
! Argument
! Description
! Description
! Example
|-
|-
| {{cd|quickPlayPath}}
| {{code|--quickPlaySingleplayer [{{ph|world folder name}}]}}
| Takes a specified path of a file containing information about the world to join, relative to the [[Minecraft:.minecraft|run directory]].
| Automatically joins the singleplayer world once the game has started. Defaults to the most recently played world if the folder name is omitted.
| {{cd|--quickPlayPath "quickPlay/log.json"}} (resolved into {{cd|.minecraft/quickPlay/log.json}})
|-
|-
| {{cd|quickPlaySingleplayer}}
| {{code|--quickPlayMultiplayer {{ph|server address}}}}
| Takes a specified identifier representing the folder name of the world.
| Automatically joins the server once the game has started.
| {{cd|--quickPlaySingleplayer "New World"}}
|-
|-
| {{cd|quickPlayMultiplayer}}
| {{code|--quickPlayRealms {{ph|Realm ID}}}}
| Takes a specified identifier representing the IP address and port of the server, separated by a colon.
| Automatically joins the Realm once the game has started.
| {{cd|--quickPlayMultiplayer "localhost:25565"}}
|-
|-
| {{cd|quickPlayRealms}}
| {{code|--quickPlayPath {{ph|quick play logs path}}}}
| Takes a specified identifier representing the ID of the Realm.
| Sets the path to the file to write [[Minecraft:Quick Play#Logs|Quick Play logs]] to, relative to the instance's files.
| {{cd|--quickPlayRealms "1234"}}
|}
|}


== JSON format ==
== JSON format ==
This is the JSON format for <samp>launcher_quick_play.json</samp>, located in the root of the <samp>[[Minecraft:.minecraft]]</samp> folder.
This is the JSON format for {{file|file|[[Minecraft:.minecraft]]/launcher_quick_play.json}}.


<div class="treeview">
<div class="treeview">
Line 68: 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 ID of the instance. For singleplayer, this is the folder name of the world. For multiplayer, this is the server IP address. If {{nbt|string|source}} is {{cd|Launcher}}, seems to always be {{cd|bedrock-retail}}.
**** {{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 instance, which is the user-defined name of the world or server.
**** {{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 quick play instance.
**** {{nbt|compound|javaInstance}}: An object representing a Java Edition Quick Play instance.
***** {{nbt|string|configId}}: The ID of the [[Minecraft:launcher_profiles.json|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 default [[Minecraft:game mode]] of the world. Can be {{cd|adventure}}, {{cd|creative}}, {{cd|spectator}} or {{cd|survival}}.
****** {{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 the world. Can be {{cd|singleplayer}}, {{cd|multiplayer}} or {{cd|realms}}.{{verify|couldn't check for realms}}
****** {{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 quick play instance.
**** {{nbt|compound|bedrockInstance}}: An object representing a Bedrock Edition Quick Play instance.
***** {{nbt|string|gamemode}}: The default [[Minecraft:game mode]] of the world. Can be {{cd|Adventure}}, {{cd|Creative}}, {{cd|Spectator}} or {{cd|Survival}}.
***** {{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 the world. Can be {{cd|singleplayer}}, {{cd|multiplayer}} or {{cd|realms}}.{{verify|couldn't check for realms}}
***** {{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 94: 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 ==

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

File:Launcher Quick Play.png
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. 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

File:Launcher settings Quick Play.png
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.

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

File:Edit Quick Play Game Bedrock.png
The edit window for quick play.

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

Template:Exclusive

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.

The Quick Play feature is stored only locally in the run directory.

Logs

Template:Exclusive

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.


History

Java Edition

Template:HistoryTable

Minecraft Launcher

Template:HistoryTable

References

Template:Reflist

Navigation

Template:Navbox Java Edition technical Template:Navbox Bedrock Edition

Minecraft:de:Schnellspiel Minecraft:fr:Partie rapide Minecraft:pt:Partida rápida Minecraft:zh:快速进入游戏