Difference between revisions of "Chat"

From wiki.vg
Jump to navigation Jump to search
m (→‎Character Set: removing duplicate "'")
 
(103 intermediate revisions by 25 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 is 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:
  
{| class="wikitable" style="text-align:center;" border="1" cellpadding="5"
+
{| class="wikitable"
|-
+
  !rowspan="2" | Clientbound packet
! colspan="1" width="8px"| Sample
+
!colspan="3" | Client setting
! colspan="1" | Code
+
!rowspan="2" | Usage
! colspan="1" | Common Name
+
|-
! colspan="3" | Foreground Color
+
! Full
! colspan="3" | Background Color
+
! Commands only
! colspan="1" | Hexadecimal
+
! Hidden
|-
+
|-
| || ||
+
| [[Protocol#Player Chat Message|Player Chat Message]]
|width="30px"|R
+
| {{yes|✔}}
|width="30px"|G
+
| {{no|✘}}
|width="30px"|B
+
| {{no|✘}}
|width="30px"|R
+
| 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>.
|width="30px"|G
+
  |-
|width="30px"|B
+
| [[Protocol#Disguised Chat Message|Disguised Chat Message]]
||
+
| {{yes|✔}}
|-
+
| {{no|✘}}
| bgcolor="black" |
+
| {{no|✘}}
| §0 || Black || 0 || 0 || 0 || 0 || 0 || 0 || #000000
+
| 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>.
|-
+
|-
| bgcolor=#0000aa |
+
| [[Protocol#System Chat Message|System Chat Message]]
| §1 || Dark blue || 0 || 0 || 170 || 0 || 0 || 42 || #0000aa
+
| {{yes|✔}}
|-
+
| {{yes|✔}}
| bgcolor=#00aa00 |
+
| {{no|✘}}
| §2 || Dark green || 0 || 170 || 0 || 0 || 42 || 0 || #00aa00
+
| Feedback from running a command, such as "Your game mode has been updated to creative."
|-
+
|-
| bgcolor=#00aaaa |
+
| [[Protocol#System Chat Message|System Chat Message]] (overlay)
| §3 || Dark cyan || 0 || 170 || 170 || 0 || 42 || 42 || #00aaaa
+
| {{yes|✔}}
|-
+
| {{yes|✔}}
| bgcolor=#aa0000 |
+
| {{yes|✔}}
| §4 || Dark red || 170 || 0 || 0 || 42 || 0 || 0 || #aa0000
+
| Game state information that is displayed above the hot bar, such as "You may not rest now, the bed is too far away".
|-
+
|}
| 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 || #ff5555
 
|-
 
| bgcolor=#FFFFFF |
 
| §f || White || 255 || 255 || 255 || 63 || 63 || 63 || #ffffff
 
|}
 
  
These correspond very roughly to the colors available in ANSI terminals.
+
Here's a matrix comparing what the client may send based on its chat setting:
  
A color escape code is created by combining the control character § (U+00A7) with the character specifying the color; thus, "§4" selects dark red as the color for the following text.
+
{| 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|✘}}
 +
|}
  
=== Bugs ===
+
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.").
  
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.
+
== 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.
 +
 
 +
[[Protocol#Player Chat Message|Player Chat Message]] packets are blocked based on the included sender UUID.
 +
 
 +
[[Protocol#Disguised Chat Message|Disguised Chat Message]] packets are never blocked.
 +
 
 +
[[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 Alpha]]
+
[[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.