KKS Chat

Custom chat for Minecraft with player avatars, settings, spam protection, and multi-language UI.

---

Main Features

Beautiful Interface

Chat shows player avatars next to messages. Each line is drawn in its own block with adjustable background transparency. You can move the whole chat to different corners or keep it centered (see Positioning).

Positioning

In Options → Chat Settings, cycle Position to place the chat on screen. Modes:

• Center (bottom) — default, above the hotbar area
• Center (top)
• Left top / Left bottom
• Right top / Right bottom

Message blocks align to the chosen side or stay centered.

Anti-Spam System

When enabled, only fully identical consecutive messages are merged and shown with a repeat counter (e.g. x3). You can turn anti-spam off in settings; history regroups or splits accordingly.

Whisper

Private messages are shown with dedicated formatting (sender / receiver).

Animations

Messages animate in and out of the screen. Choose a separate style for appearance and disappearance in the config:

• Fade — smooth opacity transition (default)
• Slide — slides in/out from left, right, top, or bottom
• Bounce — elastic spring effect on entry
• None — instant appear and disappear

---

Settings

Settings are in Minecraft → Options → Chat Settings (KKS Chat section). Values are saved to config/kks-chat.json and restored after restart.

KKS Chat On / Off

Toggle between KKS Chat and the vanilla chat interface without restarting the game.

Background Transparency

0%–100% opacity for message backgrounds.

Display Time

How long overlay messages stay visible: 1–60 seconds.

Maximum Messages (history)

Stored history size: 50–500 messages (older lines are dropped).

Other Options

• Styling — turn custom message formatting on or off
• Anti-spam — enable or disable identical-message merging
• Position — see Positioning above

---

Supported Languages

The mod ships with 12 language files (assets/kks-chat/lang/). UI strings follow the game language when a matching file exists; otherwise English is used as fallback.

• 🇬🇧 English (en_us)
• 🇷🇺 Русский (ru_ru)
• 🇩🇪 Deutsch (de_de)
• 🇪🇸 Español (es_es)
• 🇵🇹 Português (Brasil) (pt_br)
• 🇵🇹 Português (Portugal) (pt_pt)
• 🇮🇹 Italiano (it_it)
• 🇵🇱 Polski (pl_pl)
• 🇹🇷 Türkçe (tr_tr)
• 🇰🇷 한국어 (ko_kr)
• 🇯🇵 日本語 (ja_jp)
• 🇸🇦 العربية (ar_sa)

---

Message History

Press T to open chat: full history with scrolling. Grouped repeats can be expanded to show each line.

---

Configuration

The config file is created automatically at config/kks-chat.json on first launch. All settings are documented with comments inside the file — open it in any text editor.

Icons

Each message type (system, error, whisper, join/leave, etc.) has its own icon. You can change any icon to any valid Minecraft item ID:

"iconSystem":    "minecraft:stick",
"iconWhisper":   "minecraft:paper",
"iconJoinLeave": "minecraft:oak_door"

Background Colors

Set a custom background color per message type:

"bgColors": {
  "SYSTEM":      "#000000",
  "ERROR":       "#1A0000",
  "ACHIEVEMENT": "#001A04",
  "CHALLENGE":   "#1A0028"
}

Animations

Configure appearance and disappearance animations independently:

"animationIn":  "BOUNCE",
"animationOut": "SLIDE_LEFT"

Available values: FADE, SLIDE_LEFT, SLIDE_RIGHT, SLIDE_UP, SLIDE_DOWN, BOUNCE, NONE

---

Rules

Rules let you automatically transform messages based on conditions — change icons, colors, text, display time, or hide messages entirely. Rules are defined in kks-chat.json under "rules".

Each rule has an "if" block (conditions) and a "then" block (actions):

{ "if": { "type": "COMMAND_BLOCK" }, "then": { "hide": true } }

Conditions

Field	Description
type	Message type: PLAYER_CHAT WHISPER SYSTEM ERROR SLEEP ACHIEVEMENT CHALLENGE COMMAND_BLOCK JOIN_LEAVE SCREENSHOT
contains	Text contains this string
startsWith	Text starts with this string
endsWith	Text ends with this string
regex	Java regex — first capture group becomes {matched}
matchType	"ALL" (AND, default) or "ANY" (OR)

Actions

Field	Description
hide	Remove the message entirely
color	Tint the full message text — "#RRGGBB"
colorMatch	Tint only the matched fragment
icon	Override the icon (Minecraft item ID)
displayTime	Override display time in seconds
replaceText	Replace the entire message text
replaceMatch	Replace only the matched fragment
stopAfter	Stop — do not evaluate further rules

Variables

Use {variable} placeholders inside replaceText and replaceMatch:

Variable	Value
{my_name}	Your in-game name
{sender}	Sender's name
{text}	Full original message
{matched}	Fragment matched by contains or regex
{type}	Message type name
{time}	Current time — HH:mm
{time_s}	Current time — HH:mm:ss
{repeat}	Repeat counter

Example

"rules": [
  { "if": { "type": "COMMAND_BLOCK" }, "then": { "hide": true } },
  {
    "if":   { "contains": "[VIP]" },
    "then": { "icon": "minecraft:gold_ingot", "colorMatch": "#FFD700", "displayTime": 8 }
  },
  {
    "if":   { "type": "JOIN_LEAVE", "contains": "joined" },
    "then": { "replaceText": "→ {sender} joined [{time_s}]", "color": "#55FF55" }
  }
]

---

Support

Questions or suggestions: ddev14 on Discord.