Chat

HUD widgetKeybinds

Applies repeated-message filtering and chat layout controls.

WhereMods › Chat
KindHUD widget
Versions1.8.9 and 1.21.11
The Chat panel in the Sour Client menu, at its default settings. Every row is explained below.
The Chat panel in the Sour Client menu, at its default settings. Every row is explained below.

Turning it on

  1. Sour Client menu, Chat topic (or search for it from All).
  2. Flip the switch on its row. Click the row itself to open its settings beside the list.
  3. Press your HUD Editor key (Right Shift unless you changed it) and drag the widget where you want it. Hover it for its settings, or to switch it off.
  4. It has keys: Chat Peek Key (Z), Copy Message Key (not set). Change them in this mod's settings or under Settings › Keybinds.

Every setting

In the order the game shows them. Indented rows only appear once the row above is set the way it says.

Text10 settings
Text ColourShows when Text Colour Override is onVisible when override is on. Single colour for all chat text (#AARRGGBB).#FFFFFF
Text StylingEnables global chat text style options.Off
Text Colour OverrideWhen on, all chat uses Text Colour; when off, server colour codes are preserved.Off
Bold TextShows when Text Styling is onApplies bold styling to incoming chat lines.Off
Italic TextShows when Text Styling is onApplies italic styling to incoming chat lines.Off
Underline TextShows when Text Styling is onApplies underline styling to incoming chat lines.Off
Text ShadowUses FontRenderer shadow when drawing chat lines.On
Sender / Message SplitWhen on, insert the separator and colour between sender and message (when the line supports it).Off
SeparatorShows when Sender / Message Split is onText between name and message (e.g. [Player] : hello). :
Separator ColourShows when Sender / Message Split is onColour of the sender/message separator (when split is on).#A2BBC7
Chat Peek3 settings
Chat PeekShows your recent chat, as if chat were open, while the peek key is used - without the text box, so you keep playing.On
Chat Peek KeyShows when Chat Peek is onKey that shows chat.Z
Chat Peek ActivationShows when Chat Peek is onHold shows chat while the key is down. Press turns it on and off.HoldHold, Press
Chat Box6 settings
Copy ButtonA copy icon beside the chat message under your mouse. Click it to copy the whole message.On
Delete ButtonA bin icon beside the chat message under your mouse. Click it to remove that message from your chat.On
Delete One LineShows when Delete Button is onWhen a message runs onto more than one line, the bin removes only the line under your mouse instead of the whole message.Off
Button PositionWhere the copy and delete buttons sit. After Message = right after the text. Chat Edge = one column at the chat's right edge, easiest for deleting many lines. Line Start = over the start of the line.After MessageAfter Message, Chat Edge, Line Start
Colour CodesMessages with & codes are shown in colour, like &5&lhello: &0-&f colours, &l bold, &o italic, &n underline, &m strikethrough, &k scrambled, &r reset. You send them as typed, so other Sour players see them in colour and everyone else sees the plain text.On
Keep Chat OpenChat stays open, with your half-typed message, when the server respawns you, moves you to another game or switches you to spectator.On
Time3 settings
TimePrefixes incoming chat with a time.Off
Time FormatShows when Time is onTimestamp format.HH:mmHH:mm, HH:mm:ss, hh:mm a
Time ColourShows when Time is onColour used for the time prefix.#A2BBC7
Filtering11 settings
Anti-Spam MergeMerges repeated messages into one line with a count suffix.On
Merge WindowShows when Anti-Spam Merge is onSeconds a repeat still merges into the last copy of that message, even with other chat in between. 0 merges only back-to-back repeats.300 to 60
Left BracketShows when Anti-Spam Merge is onLeft wrapper character for anti-spam count.[[, (, {, <
Right BracketShows when Anti-Spam Merge is onRight wrapper character for anti-spam count.]], ), }, >
X Prefix EnabledShows when Anti-Spam Merge is onShows x before the count (e.g. [x64]).On
Bracket ColourShows when Anti-Spam Merge is onARGB colour for count brackets.#FFFFFF
X Prefix ColourShows when X Prefix Enabled is onARGB colour for the x prefix in anti-spam suffix.#FFFFFF
Number ColourShows when Anti-Spam Merge is onARGB colour for the repeat count number in anti-spam suffix.#FFFFFF
Hide Join/QuitHides basic join and leave lines.Off
Hide EmptyHides empty or whitespace-only chat lines.On
Hide Game InfoHides action-bar style game info chat.Off
Commands11 settings
Command ShortcutsLets a short command stand in for a long one: type /pk and the server receives /p kickoffline.Off
Shortcut 1Shows when Command Shortcuts is onOne shortcut, written shortcut=full command. Example: pk=p kickoffline. Anything you type after the shortcut is kept and passed on. Leave blank to remove this one.Empty
Shortcut 2Shows when Command Shortcuts is onOne shortcut, written shortcut=full command. Example: pk=p kickoffline. Anything you type after the shortcut is kept and passed on. Leave blank to remove this one.Empty
Shortcut 3Shows when Command Shortcuts is onOne shortcut, written shortcut=full command. Example: pk=p kickoffline. Anything you type after the shortcut is kept and passed on. Leave blank to remove this one.Empty
Shortcut 4Shows when Command Shortcuts is onOne shortcut, written shortcut=full command. Example: pk=p kickoffline. Anything you type after the shortcut is kept and passed on. Leave blank to remove this one.Empty
Shortcut 5Shows when Command Shortcuts is onOne shortcut, written shortcut=full command. Example: pk=p kickoffline. Anything you type after the shortcut is kept and passed on. Leave blank to remove this one.Empty
Shortcut 6Shows when Command Shortcuts is onOne shortcut, written shortcut=full command. Example: pk=p kickoffline. Anything you type after the shortcut is kept and passed on. Leave blank to remove this one.Empty
Shortcut 7Shows when Command Shortcuts is onOne shortcut, written shortcut=full command. Example: pk=p kickoffline. Anything you type after the shortcut is kept and passed on. Leave blank to remove this one.Empty
Shortcut 8Shows when Command Shortcuts is onOne shortcut, written shortcut=full command. Example: pk=p kickoffline. Anything you type after the shortcut is kept and passed on. Leave blank to remove this one.Empty
Shortcut 9Shows when Command Shortcuts is onOne shortcut, written shortcut=full command. Example: pk=p kickoffline. Anything you type after the shortcut is kept and passed on. Leave blank to remove this one.Empty
Shortcut 10Shows when Command Shortcuts is onOne shortcut, written shortcut=full command. Example: pk=p kickoffline. Anything you type after the shortcut is kept and passed on. Leave blank to remove this one.Empty
Mentions7 settings
Highlight MentionsHighlights your own visible name in chat.On
Mention SoundPlays a ding when your name appears in chat.On
Mention Sound TypeShows when Mention Sound is onWhich ding plays when you are mentioned.OrbOrb, Pling
Mention ColourShows when Highlight Mentions is onColour used when your visible name appears in chat.#FF0000
Bold NameShows when Highlight Mentions is onBolds highlighted mention names.Off
Italic NameShows when Highlight Mentions is onItalicizes highlighted mention names.Off
Underline NameShows when Highlight Mentions is onUnderlines highlighted mention names.Off
Behavior6 settings
Smooth ChatNew messages slide up into place instead of the whole chat jumping a line. Only runs while chat is closed - while it is open, clicking a link has to line up with where the text actually is.Off
Smooth Chat SpeedShows when Smooth Chat is onHow long the slide takes, in milliseconds. Lower is snappier.15040 to 400
Smooth Typing CursorThe text cursor in chat slides between letters instead of jumping, the way a word processor does. Clicking elsewhere in the line still moves it instantly.Off
Smooth Cursor SpeedShows when Smooth Typing Cursor is onHow long the slide takes, in milliseconds. Lower is snappier.11040 to 400
Smooth Chat OpenOpening chat rolls the input bar up and unrolls the message history out of it, a row at a time; closing rolls both back in. Off is vanilla's instant snap.Off
Smooth Chat Open SpeedShows when Smooth Chat Open is onHow long the roll takes, in milliseconds. Lower is snappier. Most of it is the history unrolling up the screen, so this reads slower than the other two speeds at the same number.22040 to 400
Input3 settings
Extended Length On Hypixel (256)On Hypixel, raises the chat input and send limit from 100 to 256 characters. Other servers keep the 100 limit unless Extended Length Everywhere is on.On
Extended Length Everywhere (256)Raises the chat input and send limit from 100 to 256 characters on every server. Only for servers that accept long chat - a vanilla server may kick you for an over-length message.Off
Copy Message KeyWhile chat is open, hover a message and press this key to copy its text to the clipboard.Not set
Layout, look and text (17 settings every HUD widget shares) - show
Layout13 settings
HUD List ScaleScale of this module in the HUD list / editor only.10.5 to 2
BackgroundShows the Sour chat background panel (vanilla per-line quads are omitted).Off
Background ColourShows when Background is onPanel fill; use 8-char #AARRGGBB for transparency (6-char = full opacity).#161B22 at 78%
ScaleVisual chat scale (OpenGL in draw); also syncs to GameSettings up to 1.0 for line layout.10.5 to 2
Line FadeVanilla chat line visibility (0 = more transparent, 1 = full).10 to 1
Line PaddingExtra vertical pixels per line, added to the 9px base (line height = 9 + padding).00 to 11
WidthChat width (wraps lines when narrower). 1.0 is vanilla's widest; up to 3.0 goes past it, capped at the screen edge.10.3 to 3
Focused HeightChat height while focused.10.2 to 1
Closed Chat HeightHow many lines fit while chat is closed (not typing). It does not move chat - drag it in the HUD editor for that. Only recent messages show while closed, so the extra room fills when chat is busy.0.450.2 to 1
Closed Chat FadeSeconds a message stays on screen with chat closed before it fades. Vanilla is 10.102 to 120
Height LimitThe tallest chat can get, in pixels. Vanilla stops at 180; raise this and the two height sliders above stretch to the new limit, up to the top of the screen.180180 to 720
Unlimited HistoryKeep every message of the session instead of a fixed number. Costs memory, and makes resizing the window briefly stutter while chat is re-laid out, so the slider below is the gentler option.Off
Chat HistoryShows when Unlimited History is offHow many lines chat remembers before dropping the oldest. Vanilla keeps 100.2000100 to 20000
Style4 settings
BorderDraws a border around the in-game chat area when enabled.Off
Border ColourShows when Border is onIn-game chat border (#AARRGGBB).#4CAF50 at 80%
Rounded BoxUses rounded corners for the in-game chat HUD panel.On
Corner RadiusShows when Rounded Box is onPanel corner rounding when Rounded Box is on (pixels).60 to 14