KKS Chat

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.