Difference between revisions of "Chat"

From wiki.vg
Jump to navigation Jump to search
(the character list missed an "ß")
 
 
(93 intermediate revisions by 23 users not shown)
Line 1: Line 1:
Chat strings are subject to myriad limitations imposed by defects in the Notchian server and client, and also have special meanings for certain characters.
+
{{Hatnote|This page previously contained documentation on text formatting features, which can now be found at [[Text formatting]].}}
  
== Character Set ==
+
This article details various aspects of Minecraft's chat system. The packets themselves are documented in [[Protocol]].
  
The following list of characters are known to be supported by the Notchian server:
+
== Client chat mode ==
<blockquote>
 
<code>
 
" !\"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_abcdefghijklmnopqrstuvwxyz{|}~⌂ÇüéâäàåçêëèïîìÄÅÉæÆôöòûùÿÖÜø£Ø׃áíóúñÑߪº¿®¬½¼¡«»"
 
</code>
 
</blockquote>
 
  
Characters not in this list will cause Notchian servers to kick clients, and Notchian clients to choke and die horribly.
+
The client may use the Chat Mode field of the [[Protocol#Client Information (configuration)|Client Information]] packet to indicate that it only wants to receive some types of chat messages.
  
== Colors ==
+
It is the server's responsibility to not send packets if the client has the given type disabled.  However, it is the client's responsibility to not send incorrect chat packets.
  
The Notchian client has support for colorized text. To select a color, a color escape code, similar to an ANSI color escape code, is inserted to change the color of the following characters.
+
Here's a matrix comparing what packets the server should send to clients based on their chat settings:
  
[[File:Colors.png|thumb|Hex digit to color mapping]]
+
{| class="wikitable"
 +
!rowspan="2" | Clientbound packet
 +
!colspan="3" | Client setting
 +
!rowspan="2" | Usage
 +
|-
 +
! Full
 +
! Commands only
 +
! Hidden
 +
|-
 +
| [[Protocol#Player Chat Message|Player Chat Message]]
 +
| {{yes|✔}}
 +
| {{no|✘}}
 +
| {{no|✘}}
 +
| Player-initiated chat messages, including the commands <code>/say</code>, <code>/me</code>, <code>/msg</code>, <code>/tell</code>, <code>/w</code> and <code>/teammsg</code>.
 +
|-
 +
| [[Protocol#Disguised Chat Message|Disguised Chat Message]]
 +
| {{yes|✔}}
 +
| {{no|✘}}
 +
| {{no|✘}}
 +
| Messages sent by non-players using the commands <code>/say</code>, <code>/me</code>, <code>/msg</code>, <code>/tell</code>, <code>/w</code> and <code>/teammsg</code>.
 +
|-
 +
| [[Protocol#System Chat Message|System Chat Message]]
 +
| {{yes|✔}}
 +
| {{yes|✔}}
 +
| {{no|✘}}
 +
| Feedback from running a command, such as "Your game mode has been updated to creative."
 +
|-
 +
| [[Protocol#System Chat Message|System Chat Message]] (overlay)
 +
| {{yes|✔}}
 +
| {{yes|✔}}
 +
| {{yes|✔}}
 +
| Game state information that is displayed above the hot bar, such as "You may not rest now, the bed is too far away".
 +
|}
  
{| class="wikitable" style="text-align:center;" border="1" cellpadding="5"
+
Here's a matrix comparing what the client may send based on its chat setting:
|-
 
! colspan="1"  width="8px"| Sample
 
! colspan="1" | Code
 
! colspan="1" | Common Name
 
! colspan="3" | Foreground Color
 
! colspan="3" | Background Color
 
! colspan="1" | Hexadecimal
 
|-
 
| || ||
 
|width="30px"|R
 
|width="30px"|G
 
|width="30px"|B
 
|width="30px"|R
 
|width="30px"|G
 
|width="30px"|B
 
||
 
|-
 
| bgcolor="black" |
 
| 0 || Black || 0 || 0 || 0 || 0 || 0 || 0 || #000000
 
|-
 
| bgcolor=#0000aa |
 
| 1 || Dark blue || 0 || 0 || 170 || 0 || 0 || 42 || #0000aa
 
|-
 
| bgcolor=#00aa00 |
 
| 2 || Dark green || 0 || 170 || 0 || 0 || 42 || 0 || #00aa00
 
|-
 
| bgcolor=#00aaaa |
 
| 3 || Dark cyan || 0  || 170 || 170 || 0 || 42 || 42 || #00aaaa
 
|-
 
| bgcolor=#aa0000 |
 
| 4 || Dark red || 170 || 0 || 0 || 42 || 0 || 0 || #aa0000
 
|-
 
| bgcolor=#aa00aa |
 
| 5 || Purple || 170 || 0 || 170 || 42 || 0 || 42 || #aa00aa
 
|-
 
| bgcolor=#ffaa00 |
 
| 6 || Gold || 255 || 170 || 0 || 42 || 42 || 0 || #ffaa00
 
|-
 
| bgcolor=#aaaaaa |
 
| 7 || Gray || 170 || 170 || 170 || 42 || 42 || 42 || #aaaaaa
 
|-
 
| bgcolor=#555555 |
 
| 8 || Dark gray || 85 || 85 || 85 || 21 || 21 || 21 || #555555
 
|-
 
| bgcolor=#5555ff |
 
| 9 || Blue || 85 || 85 || 255 || 21 || 21 || 63 || #5555ff
 
|-
 
| bgcolor=#55ff55 |
 
| a || Bright green || 85 || 255 || 85 || 21 || 63 || 21 || #55ff55
 
|-
 
| bgcolor=#55FFFF |
 
| b || Cyan || 85 || 255 || 255 || 21 || 63 || 63 || #55ffff
 
|-
 
| bgcolor=#FF5555 |
 
| c || Red || 255 || 85 || 85 || 63 || 21 || 21 || #ff5555
 
|-
 
| bgcolor=#FF55FF |
 
| d || Pink || 255 || 85 || 255 || 63 || 21 || 63 || #ff55ff
 
|-
 
| bgcolor=#FFFF55 |
 
| e || Yellow || 255 || 255 || 85 || 63 || 63 || 21 || #ffff55
 
|-
 
| bgcolor=#FFFFFF |
 
| f || White || 255 || 255 || 255 || 63 || 63 || 63 || #ffffff
 
|}
 
  
These correspond very roughly to the colors available in ANSI terminals.
+
{| class="wikitable"
 +
!rowspan="2" | Serverbound packet
 +
!colspan="3" | Client setting
 +
|-
 +
! Full
 +
! Commands only
 +
! Hidden
 +
|-
 +
| [[Protocol#Chat Message|Chat Message]]
 +
| {{yes|✔}}
 +
| {{maybe|✘<ref group="note">This behavior varies.  The Notchian server <em>previously</em> rejected chat messages, but now allows them to go through (sending them to all players, but they're invisible on the sender's side).  CraftBukkit and derivatives continue to reject this.  See [https://bugs.mojang.com/browse/MC-116824 MC-116824] for more information.</ref>}}
 +
| {{no|✘}}
 +
|-
 +
| [[Protocol#Chat Command|Chat Command]]
 +
| {{yes|✔}}
 +
| {{yes|✔}}
 +
| {{no|✘}}
 +
|}
  
A color escape code is created by combining the control character § (U+00A7) for Minecraft, or & for Minecraft Classic, with the character specifying the color; thus, "§4" in Minecraft selects dark red as the color for the following text, and "&4" does the same for classic.
+
If the client attempts to send a chat message and the server rejects it, the Notchian server will send that client a [[Protocol#System Chat Message|System Chat Message]] (non-overlay) with a red <code>chat.disabled.options</code> translation component (which becomes "Chat disabled in client options.").
  
== Styles==
+
== Social Interactions (blocking) ==
  
Minecraft 1.2.4 added several new font style escape codes. Like the color codes above, style escape codes are created by combining § (U+00A7) with one of the following characters. Style codes can be combined (except for "r") to enable multiple effects at once. Using any color codes will reset the current style back to plain (unknown if this is a bug or intended behavior). The "r" plain style code will also reset the current chat color back to white (may also be a bug). The "k" random style code already existed before 1.2.4, and it is used for the "§kFUNKY LOL" message in /title/splashes.txt inside minecraft.jar.
+
1.16 added a ''social interactions screen'' that lets players block chat from other players. Blocking takes place clientside by detecting whether a message is from a blocked player.
  
{| class="wikitable" style="text-align:center;" border="1" cellpadding="5"
+
[[Protocol#Player Chat Message|Player Chat Message]] packets are blocked based on the included sender UUID.
|-
 
! colspan="1" | Sample
 
! colspan="1" | Code
 
! colspan="1" | Style
 
|-
 
| [[File:random_chat.gif]] || k || Random
 
|-
 
| [[File:bold_chat.png]] || l || Bold
 
|-
 
| [[File:strikethrough_chat.png]] || m || Strikethrough
 
|-
 
| [[File:underlined_chat.png]] || n || Underlined
 
|-
 
| [[File:italic_chat.png]] || o || Italic
 
|-
 
| [[File:plain_chat.png]] || r || Plain White
 
|}
 
  
=== Bugs ===
+
[[Protocol#Disguised Chat Message|Disguised Chat Message]] packets are never blocked.
  
The Notchian client expects that a color escape code in a chat message will be followed by at least one character, and will otherwise crash with a StringIndexOutOfBoundsException. The workaround for servers is to never end a message with a color control character.
+
[[Protocol#System Chat Message|System Chat Message]] packets (regardless of the Overlay field!) are blocked based on the first occurrence of <code><''playername''></code> anywhere in the message, including split across multiple text components, where ''playername'' may be any text, including the empty string or whitespace. If ''playername'' is the name of a blocked player (matched case-sensitively), the message is blocked. This only occurs if Hide Matched Names is enabled in Chat Settings (the default).
 +
 
 +
== Notes ==
 +
 
 +
<references group="note" />
  
 
[[Category:Protocol Details]]
 
[[Category:Protocol Details]]
[[Category:Minecraft Beta]]
+
[[Category:Minecraft Modern]]

Latest revision as of 23:22, 13 March 2024

This page previously contained documentation on text formatting features, which can now be found at Text formatting.

This article details various aspects of Minecraft's chat system. The packets themselves are documented in Protocol.

Client chat mode

The client may use the Chat Mode field of the Client Information packet to indicate that it only wants to receive some types of chat messages.

It is the server's responsibility to not send packets if the client has the given type disabled. However, it is the client's responsibility to not send incorrect chat packets.

Here's a matrix comparing what packets the server should send to clients based on their chat settings:

Clientbound packet Client setting Usage
Full Commands only Hidden
Player Chat Message Player-initiated chat messages, including the commands /say, /me, /msg, /tell, /w and /teammsg.
Disguised Chat Message Messages sent by non-players using the commands /say, /me, /msg, /tell, /w and /teammsg.
System Chat Message Feedback from running a command, such as "Your game mode has been updated to creative."
System Chat Message (overlay) Game state information that is displayed above the hot bar, such as "You may not rest now, the bed is too far away".

Here's a matrix comparing what the client may send based on its chat setting:

Serverbound packet Client setting
Full Commands only Hidden
Chat Message [note 1]
Chat Command

If the client attempts to send a chat message and the server rejects it, the Notchian server will send that client a System Chat Message (non-overlay) with a red chat.disabled.options translation component (which becomes "Chat disabled in client options.").

Social Interactions (blocking)

1.16 added a social interactions screen that lets players block chat from other players. Blocking takes place clientside by detecting whether a message is from a blocked player.

Player Chat Message packets are blocked based on the included sender UUID.

Disguised Chat Message packets are never blocked.

System Chat Message packets (regardless of the Overlay field!) are blocked based on the first occurrence of <playername> anywhere in the message, including split across multiple text components, where playername may be any text, including the empty string or whitespace. If playername is the name of a blocked player (matched case-sensitively), the message is blocked. This only occurs if Hide Matched Names is enabled in Chat Settings (the default).

Notes

  1. This behavior varies. The Notchian server previously rejected chat messages, but now allows them to go through (sending them to all players, but they're invisible on the sender's side). CraftBukkit and derivatives continue to reject this. See MC-116824 for more information.