Package net.minecraft.network

Interface ChatDecorator

Functional Interface:
This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.
@FunctionalInterface public interface ChatDecorator
Chat decorator decorates the chat server-side. Currently, only one chat decorator can exist at a time. The chat decorator that is currently used can be obtained by MinecraftServer.getChatDecorator().

For the chat decorator to produce a signed message, both the server and the sender's client need to have chat previews enabled, Otherwise, the decorated content is considered unsigned, and if the clients require chat messages to be signed via the "Only Show Signed Chat" option, they will see the undecorated message. Therefore, chat decorator is not recommended for censoring messages.

It is very important that the decorator return the same text when previewed and sent. If this is not followed correctly, the server detects that the client sent a forged text and discards the message. For example, a decorator that appends the time the decoration was applied would be likely to fail, since there is usually a delay between the previewing and the submission. One way to solve this issue is to make it cache the result on preview, so that when the sent message needs decorating, the cached value can be used.

Mappings:
Namespace Name
official rf
intermediary net/minecraft/class_7492
named net/minecraft/network/ChatDecorator

  • Field Details

    • NOOP

      static final ChatDecorator NOOP
      An empty chat decorator that does not decorate anything.
      Mappings:
      Namespace Name Mixin selector
      official a Lrf;a:Lrf;
      intermediary field_39384 Lnet/minecraft/class_7492;field_39384:Lnet/minecraft/class_7492;
      named NOOP Lnet/minecraft/network/ChatDecorator;NOOP:Lnet/minecraft/network/ChatDecorator;

  • Method Details

    • testRainbowChat

      @Deprecated static ChatDecorator testRainbowChat()
      Deprecated.

    • decorate

      Text decorate(@Nullable @Nullable ServerPlayerEntity sender, Text message)
      Returns the decorated message.
      Returns:
      the decorated message
      Mappings:
      Namespace Name Mixin selector
      official decorate Lrf;decorate(Lafm;Lrl;)Lrl;
      intermediary decorate Lnet/minecraft/class_7492;decorate(Lnet/minecraft/class_3222;Lnet/minecraft/class_2561;)Lnet/minecraft/class_2561;
      named decorate Lnet/minecraft/network/ChatDecorator;decorate(Lnet/minecraft/server/network/ServerPlayerEntity;Lnet/minecraft/text/Text;)Lnet/minecraft/text/Text;

    • decorate

      default SignedChatMessage decorate(@Nullable @Nullable ServerPlayerEntity sender, Text message, ChatMessageSignature signature, boolean previewed)
      Returns the decorated signed chat message from undecorated message.

      If previewed is false, the returned message will have the original content as signed and the decorated content as unsigned. This means that if the received player requires signed chat message, they will see the original content.

      Parameters:
      previewed - whether the decoration was previewed by the sender's client
      Returns:
      the decorated signed chat message from undecorated message
      Mappings:
      Namespace Name Mixin selector
      official decorate Lrf;decorate(Lafm;Lrl;Lrq;Z)Lrt;
      intermediary decorate Lnet/minecraft/class_7492;decorate(Lnet/minecraft/class_3222;Lnet/minecraft/class_2561;Lnet/minecraft/class_7469;Z)Lnet/minecraft/class_7471;
      named decorate Lnet/minecraft/network/ChatDecorator;decorate(Lnet/minecraft/server/network/ServerPlayerEntity;Lnet/minecraft/text/Text;Lnet/minecraft/network/encryption/ChatMessageSignature;Z)Lnet/minecraft/network/encryption/SignedChatMessage;

    • decorate

      default SignedChatMessage decorate(@Nullable @Nullable ServerPlayerEntity sender, SignedChatMessage message)
      Returns the signed chat message with unsigned content set as decorated message.
      Returns:
      the signed chat message with unsigned content set as decorated message
      API Note:
      This is used by various commands that send messages, such as MeCommand.

      If the received player requires signed chat message, they will see the original content.

      Mappings:
      Namespace Name Mixin selector
      official decorate Lrf;decorate(Lafm;Lrt;)Lrt;
      intermediary decorate Lnet/minecraft/class_7492;decorate(Lnet/minecraft/class_3222;Lnet/minecraft/class_7471;)Lnet/minecraft/class_7471;
      named decorate Lnet/minecraft/network/ChatDecorator;decorate(Lnet/minecraft/server/network/ServerPlayerEntity;Lnet/minecraft/network/encryption/SignedChatMessage;)Lnet/minecraft/network/encryption/SignedChatMessage;