KKS 聊天

KKS 聊天

自定义聊天,包含玩家头像、私聊和防垃圾信息功能。位置完全可自定义。

社交

KKS Chat

为 Minecraft 打造的自定义聊天模组,支持玩家头像、设置、防刷屏保护以及多语言界面。


主要特性

美观的界面

聊天会在消息旁显示玩家头像。每一行都绘制在各自的区块中,背景透明度可调。你可以将整个聊天移动到不同角落,或保持居中(参见 定位)。

Hi!

定位

在 选项 → 聊天设置 中,循环切换 位置 即可将聊天放置在屏幕上的不同位置。模式:

  • 居中(底部) — 默认,位于快捷栏区域上方
  • 居中(顶部)
  • 左上 / 左下
  • 右上 / 右下

消息区块会对齐到所选的一侧,或保持居中。

防刷屏系统

启用后,仅完全相同的连续消息会被合并,并显示重复计数器(例如 x3)。你可以在设置中关闭防刷屏;历史记录会相应地重新分组或拆分。

antispam

私聊

私密消息会以专门的格式显示(发送者 / 接收者)。

whisper

动画

消息会以动画形式进入和离开屏幕。你可以在配置中为出现和消失分别选择不同的样式:

  • Fade — 平滑的透明度过渡(默认)
  • Slide — 从左侧、右侧、顶部或底部滑入/滑出
  • Bounce — 进入时带有弹性弹簧效果
  • None — 瞬间出现和消失

设置

设置位于 Minecraft → 选项 → 聊天设置(KKS Chat 部分)。数值会 保存 到 config/kks-chat.json,并在重启后恢复。

KKS Chat 开 / 关

无需重启游戏,即可在 KKS Chat 和原版聊天界面之间切换。

背景透明度

消息背景的不透明度,范围 0%–100%。

显示时间

悬浮消息保持可见的时长:1–60 秒。

最大消息数(历史记录)

存储的历史记录大小:50–500 条消息(更早的行会被丢弃)。

其他选项

  • 样式 — 开启或关闭自定义消息格式
  • 防刷屏 — 启用或禁用相同消息合并
  • 位置 — 参见上文的定位

Settings


支持的语言

本模组自带 12 个语言文件(assets/kks-chat/lang/)。当存在匹配的文件时,界面文本会跟随游戏语言;否则回退使用 英语。

  • 🇬🇧 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)

消息历史

按 T 打开聊天:可滚动的完整历史记录。合并的重复消息可以展开以显示每一行。

Chat history


配置

首次启动时会在 config/kks-chat.json 自动创建配置文件。 文件内的所有设置均带有注释说明 — 可用任意文本编辑器打开。

图标

每种消息类型(系统、错误、私聊、加入/离开等)都有各自的图标。 你可以将任意图标更改为任何有效的 Minecraft 物品 ID:

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

背景颜色

为每种消息类型设置自定义背景颜色:

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

动画

分别独立配置出现和消失动画:

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

可用值:FADE、SLIDE_LEFT、SLIDE_RIGHT、SLIDE_UP、SLIDE_DOWN、BOUNCE、NONE


规则

规则让你可以根据条件自动转换消息 — 更改图标、颜色、文本、显示时间,或完全隐藏消息。规则在 kks-chat.json 的 "rules" 下定义。

每条规则都有一个 "if" 块(条件)和一个 "then" 块(操作):

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

条件

字段 描述
type 消息类型:PLAYER_CHAT WHISPER SYSTEM ERROR SLEEP ACHIEVEMENT CHALLENGE COMMAND_BLOCK JOIN_LEAVE SCREENSHOT
contains 文本包含此字符串
startsWith 文本以此字符串开头
endsWith 文本以此字符串结尾
regex Java 正则表达式 — 第一个捕获组会成为 {matched}
matchType "ALL"(与,默认)或 "ANY"(或)

操作

字段 描述
hide 完全移除该消息
color 为整条消息文本着色 — "#RRGGBB"
colorMatch 仅为匹配的片段着色
icon 覆盖图标(Minecraft 物品 ID)
displayTime 覆盖显示时间(秒)
replaceText 替换整条消息文本
replaceMatch 仅替换匹配的片段
stopAfter 停止 — 不再评估后续规则

变量

在 replaceText 和 replaceMatch 中使用 {variable} 占位符:

变量 值
{my_name} 你的游戏内名称
{sender} 发送者的名称
{text} 完整的原始消息
{matched} 由 contains 或 regex 匹配到的片段
{type} 消息类型名称
{time} 当前时间 — HH:mm
{time_s} 当前时间 — HH:mm:ss
{repeat} 重复计数器

示例

"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" }
  }
]

支持

问题或建议:在 Discord 上联系 ddev14。