KKS Chat

KKS Chat

Кастомный чат для Minecraft с аватарами игроков, настройками, защитой от спама и многоязычным интерфейсом.

Основные возможности

Красивый интерфейс

Чат показывает аватары игроков рядом с сообщениями. Каждая строка отрисовывается в отдельном блоке с настраиваемой прозрачностью фона. Можно переместить весь чат в разные углы или оставить по центру (см. Позиционирование).

Позиционирование

В Настройки → Настройки чата переключай Position, чтобы разместить чат на экране. Режимы:

• Center (bottom) — по умолчанию, над хотбаром
• Center (top)
• Left top / Left bottom
• Right top / Right bottom

Блоки сообщений выравниваются по выбранной стороне или остаются по центру.

Анти-спам система

Когда включена, только полностью одинаковые подряд идущие сообщения объединяются и показываются со счётчиком повторов (например, x3). Анти-спам можно отключить в настройках; история перегруппируется или разобьётся соответственно.

Шёпот

Личные сообщения показываются с отдельным форматированием (отправитель / получатель).

Анимации

Сообщения появляются и исчезают с экрана с анимацией. В конфиге можно выбрать отдельный стиль для появления и исчезновения:

• Fade — плавное изменение прозрачности (по умолчанию)
• Slide — выезд слева, справа, сверху или снизу
• Bounce — упругий пружинный эффект при появлении
• None — мгновенное появление и исчезновение

Настройки

Настройки находятся в Minecraft → Настройки → Настройки чата (раздел KKS Chat). Значения сохраняются в config/kks-chat.json и восстанавливаются после перезапуска.

KKS Chat вкл / выкл

Переключение между KKS Chat и ванильным интерфейсом чата без перезапуска игры.

Прозрачность фона

Прозрачность фона сообщений от 0% до 100%.

Время отображения

Как долго оверлейные сообщения остаются видимыми: 1–60 секунд.

Максимум сообщений (история)

Размер хранимой истории: 50–500 сообщений (старые строки удаляются).

Другие опции

• Styling — включить или отключить кастомное форматирование сообщений
• Anti-spam — включить или отключить объединение одинаковых сообщений
• Position — см. Позиционирование выше

Поддерживаемые языки

Мод включает 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, чтобы открыть чат: полная история с прокруткой. Сгруппированные повторы можно развернуть, чтобы показать каждую строку.

Конфигурация

Файл конфига создаётся автоматически в config/kks-chat.json при первом запуске. Все настройки задокументированы комментариями внутри файла — открой его в любом текстовом редакторе.

Иконки

У каждого типа сообщений (системные, ошибки, шёпот, вход/выход и т.д.) своя иконка. Любую иконку можно заменить на любой валидный ID предмета Minecraft:

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

### Цвета фона

Задайте свой цвет фона для каждого типа сообщений:

```json
"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 } }

Условия

Действия

Переменные

Используйте плейсхолдеры {variable} внутри replaceText и replaceMatch:

Пример

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

Поддержка

Вопросы и предложения: ddev14 в Discord.