Skip to content

Instantly share code, notes, and snippets.

@kennytv
Last active May 8, 2024 06:32
Show Gist options
  • Save kennytv/ed783dd244ca0321bbd882c347892874 to your computer and use it in GitHub Desktop.
Save kennytv/ed783dd244ca0321bbd882c347892874 to your computer and use it in GitHub Desktop.
Signed Chat and Chat Types

Signed chat

This gist intends on clearing up some of the misinformation surrounding signed chat/the reporting feature Mojang has added to Minecraft 1.19.1. Here you can find both technical information as well as a general explanation of how these work.

Profile keys

After joining a server, clients now send a profile key used for verifying a message's authenticity. This key and thus the whole signing process is optional, but by default, servers enforce secure profiles for clients to send chat messages. Whenever the player sends a chat message and has a key associated, the message will be signed using their own private key, which the server then verifies using the public key sent after join. Assuming signature, timestamp, and message contents line up, the message goes through.

On the other end, clients can also require all broadcasted player messages to be signed, disregarding the ones without sender verified signatures.

Message signatures

Every signed message's signature include the sender's UUID matching the profile key's identity, a randomly initialized session UUID, a timestamp (though that cannot be fully verified with untrusted clients/servers), the signed message, and a random salt.

A message's signature also includes a message index that the client increments with each message. With the index being verified by both server and other clients, you cannot reorder messages or leave them out without knowing something happened between two messages (although you cannot determine when, to whom, or whether it was commands and/or messages inbetween).

Another important part of the signature is the list last seen messages. The signatures of the last 20 messages the client has seen will be cached and be packed into chat messages and their signature. This is used to verify that, up to a certain point to guarantee faithful context, no messages of other players have been omitted in a report and that no messages have been added to the given context after the fact either.

Hiding or retroactively removing messages

With signed messages, Mojang finally introduced a packet servers can use to retroactively remove already sent out messages. So if you want to clear chat or remove individual messages without having to spam empty messages that only move up the previous messages, you can properly remove them now using the ClientboundDeleteChatPacket packet - the only requirement for this is that the message to be removed is a properly signed player message. Since 1.19.3, messages will be displayed for at least 3 seconds before being removed, and a removal still leaves a stub behind (saying that a chat message has been removed where the message previously was).

Since 1.19.3, you can freely cancel signed chat messages or send them to a limited number of players without breaking the chat chain. Players will instead use the signed index to make sure messages are send and included incrementally.

Modifying chat messages through chat previews

... You don't anymore; chat previews have been removed entirely in 1.19.3. With this, changed messages look a lot less scary (as opposed to unsigned messages) and you can still see the original message's content.

Signed command arguments

Since commands such as /say, as well as custom commands to broadcast messages or send them to a certain group of people also result in "player messages" that you would want to have verified, text arguments in commands will also be signed by the client. With the given signature, you can then distribute the message yourself and still have it show up as a signed player message.

In the wild, you can see this being used in Vanilla's say, me, msg, teammsg, ban, banip, and kick commands.

Signed/unsigned player chat and system chat

There are two different kinds of chat messages now; player chat and system chat. Player chat is accompanied by the message signature, system chat has no special format or signature attached.

You can optionally attach an unsigned component to any player chat message, which will give the message a light gray indicator on the left with a hover over the message reveiling the original message's content. If only styling changed on the message and the actual plain text is still the same, the message will appear without the indicator.

You can also apply filter masks to messages without making them appear as unsigned messages, where bad words are replaced with a string of # characters.

If you go as far as sending a player chat message with an invalid signature, it will look like this: invalid signature

System chat messages also have a gray indicator.

Custom formats using chat types

While the message always needs to be verified by the player that sent it, player display name, team name, and surrounding format can be freely defined by the server.

One of the default chat types looks like this when serialized:

         {
            "name":"minecraft:team_msg_command",
            "id":3,
            "element":{
               "chat":{
                  "translation_key":"chat.type.team.text",
                  "parameters":[
                     "team_name",
                     "sender",
                     "content"
                  ]
               },
               "narration":{
                  "translation_key":"chat.type.text.narrate",
                  "parameters":[
                     "sender",
                     "content"
                  ]
               }
            }
         },

The decoration format for the chat display here resolves as %s <%s> %s, then using the 3 parameters team_name, sender, and content. Even though the decoration element only takes a translatable argument, you can simply enter a plain string as the key that will be displayed; you can try this out by using the following command: /tellraw @s {"translate":"Hello [%s]", "with":["world"]}

Chat type formats can be easily made custom, e.g. turning the translatable into plain text like: 🚩 Broadcast by %s: %s 🚩 and only taking the sender and content parameters, to give just one example. In addition to the text display, you can also define the message to be narrated (also using a different number of arguments and a different surrounding format) and/or displayed in the actionbar as "game info". In the style field you can also apply custom formatting (color, font, italics, hover/click events, etc.) to the entire message/until the sender or content component changes the format again.

Custom chat types can be added using datapacks or by modifying the chat_type registry in the server (which modded servers such as Paper will need to add API for in the future). Custom chat types will then be sent to each player once when they join. With this, you can in theory also send the same message using different formats to different players, only the actual content is always fixed as part of the signed message.

You can find a full list of the Vanilla chat types here.

FAQ (Frequently Asked Questions)

Before we part ways again, here are answers to some of the more common questions. Mojang's FAQ has been updated to answer more of the pressing questions, so it's definitely worth taking a look at.

Can Microsoft/Mojang see all of my messages?

No, only reported messages are sent away for processing.

What about the currently known exploits?

Mostly non-issues: guardian always leaves a trace when you're reported, gaslightv2 usually leaves a trace or just becomes silly when you report someone else, and gaslightv3 falls into the same category, where "yes" or "I hate them" are nothing that will reasonably be acted upon (also see below for more info). Basically, this Tweet.

Additionally, since 1.19.3, messages can only be removed 3 seconds after first appearing, and will leave a stub instead of fully removing the line.

Am I going to be banned for joking with my friends or writing in all caps?

No, Mojang have made clear they only intend on hunting down the worst of the worst (suicide threats, racial slurs, doxing, etc.). All reports will be handled in human review (aside from them most likely pre-filtering malicious reports before the final decision is made). See here for a detailed list of punishment reasons. You can still dick around with your friends.

What if someone spam reports me?

Then they get temporarily or permanently banned; the number of reports does not matter.

Can't someone impersonate me and get me banned?

No, they need the private key only you and Mojang have to sign messages as coming from your account. You cannot be impersonated unless you download a stupidly malicious client/mod, and even then you can still appeal.

What if my messages are taken out of context?

Reports require and automatically send a handful of messages around the selected ones to be included as context. You cannot omit or add messages from/to reports without making it look fishy. There are yet to be given examples of messing with context that would realistically get you banned, even just temporarily.

Bedrock's text filtering is horrible, is that also going to come to Java?

That's simply not going to happen considering how different the underlying tech of filtering vs. reporting/chat signing is and the general nature of 3rd party servers.

Are all bans permanent?

No, and if you think you were banned without reason, you can make an appeal.

Can servers disable the reporting feature?

Yes, very easily. However, considering this comes at the cost of effectively taking power away from your users, making them more vulnerable to repeated bullying, it'd not be as merciful of a move as you might think it is.

Players may also opt-in to only display signed (and thus reportable) messages.

What if their moderation team is terrible?

A lot of people have voiced concerns regarding Mojang possibly outsourcing message moderation and thus having a poor quality of report processing. While it is a somewhat reasonable fear, this is still based on extremely high amounts of speculation. Looking at the facts, Microsoft already has a well working chat moderation at xbox live, where no such drama of false bans or being banned because you spoke out negatively about Microsoft has occurred - the rules regarding Minecraft chat are also a lot more lenient compared to that.

With this in mind, such speculation does not make for a good argument and I implore you to wait and see what actually happens. If your worst fears do end up coming true and false bans occur with an additional lack of appeal processing, I myself will be sure to join the riot as well and provide easy to use means to disable reporting.

Why can I be banned when playing on a private server I own?

You're using Mojang's client, Mojang's server, and Mojang's services on a massive social platform they still have the responsibility to moderate; they're very much in their right to do that. You won't be banned if either your friends don't feel attacked by your messages or you just disable reporting with a plugin or mod.

Howvever, opinion time: Everything you do or say has consequences, even towards friends, and even if you don't realize they exist. You're not going to be banned for a playful and harmless insult, but considering the large number of children and young adults playing the game, such a reporting feature was long overdue.

Someone who is toxic on one server is likely to behave the same on other servers as well. You might be capable of handling simple disputes and insults, but Mojang is better equipped to properly deal with people putting out personal threats, child predators and the alike than you are. This also includes the smaller or even private servers.

Proper moderation takes time, and a lot of servers aren't able to provide that or willfully neglect it. Nevertheless, you can still easily lever out reporting on your server if you wish to do so.

I still have issues with this, what can I do about it?

Whatever you do, don't join the angry mob; instead, provide constructive and useful feedback either on Minecraft's feedback site or open a ticket on their bug tracker - and remember to keep it civil.

... what if I just want an opt-out

You already have one. Ignoring the technical side of it, just imagine what Mojang would look like if they gave bad people the option to disable industry-standard player safety features.

@ZerefSoul
Copy link

You said now it's possible to remove specific chat messages with ClientboundDeleteChatPacket.
I'm working on a plugin and I could use it, but I don't find any documentation (It is present here, but without instructions or method usage: https://nekoyue.github.io/ForgeJavaDocs-NG/javadoc/1.19.3/net/minecraft/network/protocol/game/ClientboundDeleteChatPacket.html#handle(net.minecraft.network.protocol.game.ClientGamePacketListener ).
Could you give me an example of using ClientboundDeleteChatPacket to delete an already sent message (for a specific Player)?

@kennytv
Copy link
Author

kennytv commented May 4, 2023

You said now it's possible to remove specific chat messages with ClientboundDeleteChatPacket. I'm working on a plugin and I could use it, but I don't find any documentation (It is present here, but without instructions or method usage: https://nekoyue.github.io/ForgeJavaDocs-NG/javadoc/1.19.3/net/minecraft/network/protocol/game/ClientboundDeleteChatPacket.html#handle(net.minecraft.network.protocol.game.ClientGamePacketListener ). Could you give me an example of using ClientboundDeleteChatPacket to delete an already sent message (for a specific Player)?

Sure - in it's raw form, you would need to take the signature sent in a ClientboundPlayerChatPacket and throw that into new MessageSignature.Packed(signature) to use in the deletion packet. I believe some modding platforms already have higher-level API for it, otherwise you can for example get a couple of signatures of previously sent messages in LastSeenMessagesTracker, or track them yourself.

@Magicrafter13
Copy link

Magicrafter13 commented Jun 23, 2023

You're using Mojang's client, Mojang's server, and Mojang's services

All three of these statements are false. I don't use the official launcher, it's my server not their's so don't even try going there, and therefore none of their services.

I assume COMPLETE ownership and rights over my server - I haven't even agreed to their EULA.

I also do not care what someone has done on another server, all that matters to me is their conduct on mine. If they're banned from another that should not affect their ability to play on mine.

@bluebear94
Copy link

All three of these statements are false. I don't use the official launcher, it's my server not their's so don't even try going there, and therefore none of their services.

Nope, your statement is false. What launcher you use is immaterial; you’re still using the official Minecraft client jar. In addition, all servers that are not on offline mode use Mojang’s authentication services to verify incoming users.

(When KennyTV mentions “Mojang’s server”, I assume he means the servers running the authentication services, not any of the servers you play on.)

I assume COMPLETE ownership and rights over my server - I haven't even agreed to their EULA.

Yes, you have, unless you’re using custom server software that doesn’t use any code from the official server software. The Minecraft server software requires explicitly acknowledging this by editing the eula.txt file.

@Magicrafter13
Copy link

I just modified the server jar to bypass the eula check.

@bluebear94
Copy link

I just modified the server jar to bypass the eula check.

That’s on you.

@GreatWyrm
Copy link

Just wanted to pop into say that yes, you have agreed to their EULA.
Quote from the EULA page.

If you buy, download, use or play our Game, you are agreeing to stick to the rules of these end user license agreement ("EULA") terms. If you don't want to or can't agree to these rules, then you must not buy, download, use or play our Game.

And saying that you assume complete ownership rights over your server is a bit strange, as unless you've written it from scratch, it's still (mostly) Mojang's code that's running the server.

@Magicrafter13
Copy link

That's the EULA for their client (which also was not required to buy the game activation code, but that's a long time ago), not their server software which is a free direct download.

This is just another of the common proprietary software L's. It's all quite unethical.

@bluebear94
Copy link

That's the EULA for their client (which also was not required to buy the game activation code, but that's a long time ago), not their server software which is a free direct download.

Clearly you haven’t read the EULA:

And so that we are crystal clear, "the Game" or "what we have made" includes, but is not limited to, the client or the server software for our Game and includes Minecraft and Minecraft: Java Edition on all platforms.

This is just another of the common proprietary software L's. It's all quite unethical.

I’m not trying to argue about the ethics of this; I’m just correcting incorrect information.

@oxodao
Copy link

oxodao commented Nov 21, 2023

That's the EULA for their client (which also was not required to buy the game activation code, but that's a long time ago), not their server software which is a free direct download.

This is just another of the common proprietary software L's. It's all quite unethical.

The EULA for the server is the same. When you run the server software jar, it generates a eula.txt that you have to agree to run the software:

#By changing the setting below to TRUE you are indicating your agreement to our EULA (https://aka.ms/MinecraftEULA).
#Fri Nov 17 23:59:33 CET 2023
eula=false

The link redirects to the main and only EULA. If you really don't like proprietary software, you can always use one of the multiple open source implementations. But AFAIK you still have to rely on the official client as the only opensource one I know is Truecraft which development was halted a long time ago

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment