View source for Minecraft:Friends List

{{For|the similar system {{in|be}}|Social}}
{{in dev|je||26.2}}

[[File:Friends List Screen.png|thumb|The Friends List screen]]The '''friends list''' is a social menu {{in|JE}}. It allows users to add or remove friends, view their friends' statuses, and invite to or request to join online [[Minecraft:world]]s.

== Usage ==
[[File:Java_Friends_List_activation_prompt.png|right|thumb|Prompt when first interacting with the feature]]
The friends list can be accessed via the "Friends" button on the main menu or pause menu, or by using a [[Minecraft:keyboard shortcut]] (default {{key|O}}).

The friends list is presented as an overlay, containing two tabs:

* '''Friends''': Displays currently added friends. Friends can be removed here or friend requests can be sent by entering the player's profile name.
* '''Requests''': Displays received friend requests (acceptable or rejectable) and sent friend requests (cancellable).

The friends list updates every minute while it is open; otherwise it updates every five minutes.

=== Enabling ===
When the "Friends" button is interacted with for the first time, a confirmation dialog box will appear asking the player whether they agree to use the friends list.
[[File:Java Online menu accessing.png|thumb|225px|right|Accessing the Online settings menu]]
[[File:Java_Online_menu.png|right|thumb|width=225x225|The friends list options present in the Online settings menu]]
Some features must be enabled in the separate [[Minecraft:Options#Online|Online settings]] to allow friend requests, and by extension allow multiplayer functionality.<ref group="note">While multiplayer functionality is technically fully functional without needing to enable friend requests, it cannot be utilized unless the user already has friends added from outside the game.</ref> By default, the "Allow Requests" setting is disabled, which must be enabled to be able to receive friend requests.

The user's [[Minecraft:Social#Privacy & online safety|Xbox account settings]] may also hinder the functionality of the friends list. These can also be accessed and changed from the in-game Online settings menu by selecting Xbox Settings. The friends list can be disabled and enabled as a whole using the "Friends List" setting. When disabled, the "Friends" button is hidden and the list cannot be opened.

=== Friends ===
The player can send a friend request to another player by entering their {{JE}} profile name into the search box in the "Friends" tab, which will also send a friend request on the [[Minecraft:Social#Xbox network|Xbox network]].
[[File:Friends_List_Friend_Request_Received_Screen.png|thumb|The Requests tab showing a received friend request]]
[[File:Friend_Request_Accepted_Toast.png|thumb|width=250x250|Friend request accepted toast]]
A list of sent and received friend requests can be found in the "Requests" tab. Sent friend requests can be cancelled at any time. Received friend requests can be accepted or rejected, either in the Requests tab or on the Xbox network.

If the other player has "Allow Requests" disabled, the friend request won't be sent and an error message will be diplayed. The Friends button shows a notification badge with the number of incoming friend requests, up to 5.

Friends added through the Xbox network that own ''Java Edition'' will be synchronized in-game, and vice versa.

Friends can be seen in the "Friends" tab, displaying their skin's face, their profile name, and their online status. Players that have their chat settings set to "Friends Only" on their Xbox profile will only see [[Minecraft:chat]] messages from players if they are friends.

Friends can be removed from the list in the "Friends" tab with the "Remove friend" button. This will also remove the friend from the Xbox friends list.

==== Online status ====
A friend's online status is displayed under their name, with there being four possible online statuses:

* Offline
* Online (in ''Java Edition'')
* In a world
* In a joinable world

The way the user's activity appears to their friends can be customized using the "Presence" setting in the Online settings menu, with three states:
*All: Friends will see when the user is online and what they are doing (such as if they are actively playing in a world).
*Limited: The user will appear as offline to their friends even when they are online, and their activity will not be shared.
*None: Friends will see when the user is online, but will not see what they are doing.

=== Multiplayer ===
[[File:Invite_to_world_toast.png|thumb|width=225x225|Receiving invite to friend's world toast]]
Players that are in-game friends can join each other's online [[Minecraft:multiplayer]] worlds. Friends that are online can be invited to join to a world through the "Invite to game" button displayed next to their profile in the "Friends" tab. Friends can accept or deny the invite.

The player can also request to join a friend's online world. The friend can accept or deny the request in the "Friends" tab.<gallery mode="packed">
File:Friends List Invite Screen.png|link=|The Friends tab showing an option to invite a friend to the world
File:Friends List Join Screen.png|link=|The Friends tab showing an option to send request to join a friend's world
</gallery>

=== Notifications ===
Changes in the friends list while the game is open will be notified via a [[Minecraft:toast notification]]:

* Friend request sent
* Friend request received
* Another player accepted the friend request sent by the player
* Received invite to join a friend’s world
* Received request to join a world
* Invite to a world sent

The toast notification will also display the face of the other player's skin if it is available.

In-game invite notifications from friends can be enabled or disabled using the "In-game Notifications" setting. When disabled, the toasts appear only when the friends list is opened.

== History ==
{{HistoryTable
|{{HistoryLine||The Story of Mojang|link={{ytl|xdoH3kzg938|t=2m23s}}|A roadmap is shown which depicts a friends list as a planned feature. Notch later acknowledges this.<ref>{{tweet|notch|77555436370407424|yes, eventually!|June 5, 2011}}</ref>}}
|{{HistoryLine||June 27, 2011|link=https://web.archive.org/web/20210507222745/https://notch.tumblr.com/post/6969771554/back-in-the-office-and-some-words-on-17-and-18|[[Minecraft:Notch]] mentions that a friends list system will be implemented at some point following Beta 1.8.}}
|{{HistoryLine||MINECON 2012|link={{ytl|YG9RNyRhIow}}|[[Minecraft:Jeb]] states that a friends list could be used across all of Mojang's games, not just ''Minecraft''.}}
|{{HistoryLine||June 11, 2013|link=https://web.archive.org/web/20221118212842/https://twitter.com/kristoffer/status/344448279569915904|Kristoffer mentions that a friends list is being developed for ''[[Minecraft:Scrolls]]'', and that other Mojang games will be able to use this system at a later date.}}
|{{HistoryLine|java upcoming}}
|{{HistoryLine||26.2|dev=snap7|Added the friends list.}}
}}

== Gallery ==
<gallery>
File:Empty Friends List.png|Empty friends list
File:Empty Friend Requests List.png|Empty friend requests list
File:Friends_List_Accept_Deny_Screen.png|Options to accept or deny a friend's request to join your world
File:Friends_List_Waiting_Screen.png|Waiting for a friend to accept or deny an invite
File:Friends_List_Friend_Request_Sent_Screen.png|Option to cancel a sent friend request
File:Friends List Microsoft Account Settings prompt.png|Prompt when clicking "Microsoft Account" button to change settings
Invite_To_World_Sent_Toast.png|Invite to a world sent toast
Friend_Request_Received_Toast.png|Receiving a friend request
File:Request to join world toast.png|Receiving request to join a world toast
</gallery>

== Notes ==
{{notelist}}

== References ==
{{reflist}}

== Navigation ==
{{Navbox new content|other}}
{{Navbox gameplay}}

[[Minecraft:es:Lista de amigos]]
[[Minecraft:pt:Lista de amigos]]
[[Minecraft:zh:好友列表]]