Pterohost docs

Форматирование чата и префиксы на сервере Minecraft

Настройка чата в Minecraft 2026: VentureChat, EssentialsChat, префиксы из LuckPerms, PlaceholderAPI, hex-цвета, каналы и антиспам. Пошаговые конфиги.

Кратко: Для красивого чата с префиксами на Paper/Spigot установите VentureChat или EssentialsChat, подключите PlaceholderAPI с расширением LuckPerms и задайте формат строки с переменными %luckperms_prefix%, %player_name%, %luckperms_suffix%. Hex-цвета работают с Minecraft 1.16+. Антиспам и каналы настраиваются в config.yml выбранного плагина.

Форматирование чата и префиксы на сервере Minecraft

Чат - первое, что видит каждый игрок, зашедший на сервер. Красивый формат с цветными префиксами группы, ником и каналами создаёт профессиональное впечатление и помогает модераторам быстро различать роли. В 2026 году стек инструментов устоялся: LuckPerms хранит префиксы/суффиксы, PlaceholderAPI пробрасывает их в любой плагин, а VentureChat или EssentialsChat рендерят финальную строку сообщения. Дополнительно можно включить hex-цвета, разделить чат на каналы и поставить фильтрацию спама.

Pterohost - игровой Minecraft-хостинг с NVMe-дисками, DDoS-защитой L7 и поддержкой 24/7. Промокод 4START даёт -20% на первый заказ. Заказать Minecraft хостинг

Необходимые плагины и зависимости

Прежде чем настраивать форматирование, убедитесь, что на сервере стоят все нужные компоненты.

ПлагинДля чегоСсылка
LuckPerms 5.xГруппы, префиксы, суффиксыluckperms.net
PlaceholderAPI 2.11+Переменные между плагинамиhangar.papermc.io
VentureChat 3.x или EssentialsXРендер чатаhangar.papermc.io
Vault (опц.)Bridge для старых плагинов правhangar.papermc.io

Все четыре JAR кладутся в папку plugins/ рядом со своими зависимостями. После установки перезапустите сервер и проверьте отсутствие ошибок в консоли.

После запуска загрузите расширение LuckPerms для PlaceholderAPI:

/papi ecloud download LuckPerms
/papi reload

Убедитесь, что команда вернула “Successfully downloaded extension LuckPerms”. Без этого шага переменные %luckperms_prefix% и %luckperms_suffix% не будут подставляться.

Настройка префиксов и суффиксов в LuckPerms

Префиксы задаются через meta-команды. Каждый prefix/suffix имеет вес (priority) - чем больше число, тем выше приоритет при конфликте нескольких групп.

Назначение префикса группе

/lp group default meta setprefix 1 "&7[Игрок] "
/lp group vip meta setprefix 10 "&6[VIP] "
/lp group moderator meta setprefix 50 "&c[Модератор] "
/lp group admin meta setprefix 100 "&4[Админ] "

Символ & - стандартный цветовой код Bukkit. Цифра после него задаёт цвет:

КодЦветКодЦвет
&0Чёрный&8Тёмно-серый
&1Тёмно-синий&9Синий
&aЗелёный&cКрасный
&eЖёлтый&6Золотой
&fБелый&4Тёмно-красный
&lЖирный&oКурсив
&nПодчёркнутый&mЗачёркнутый

Назначение суффикса

/lp group vip meta setsuffix 10 " &6★"

Суффикс отображается после имени игрока, обычно используется для иконок или коротких статусов.

Назначение префикса конкретному игроку

Если нужно дать уникальный префикс одному игроку без создания новой группы:

/lp user Steve meta setprefix 200 "&5[Легенда] "

Вес 200 гарантирует, что личный префикс перебьёт групповой.

Проверка мета-данных

/lp user Steve meta info
/lp group vip meta info

VentureChat: установка и базовый конфиг

VentureChat - наиболее функциональный плагин чата для Paper/Spigot в 2026 году. Поддерживает каналы, PlaceholderAPI, hex-цвета, локальный чат по радиусу и интеграцию с BungeeCord.

После установки JAR и перезапуска откройте plugins/VentureChat/config.yml.

Формат строки чата

# plugins/VentureChat/config.yml
channels:
  global:
    color: "&f"
    symbol: "G"
    default: true
    radius: 0          # 0 = без ограничения дальности
    bungeecord: false
    format: "&8[&aG&8] %luckperms_prefix%&f%player_name%%luckperms_suffix%&7: &f%message%"
    cooldown: 1000     # мс между сообщениями
    rateLimit: 5       # макс. сообщений за cooldown-период

Разбор формата:

  • %luckperms_prefix% - префикс из LuckPerms через PAPI
  • %player_name% - ник игрока (без цвета)
  • %luckperms_suffix% - суффикс из LuckPerms
  • %message% - текст сообщения

Любую переменную из PlaceholderAPI можно вставить в формат: %player_health%, %vault_eco_balance_formatted%, %essentials_afk% и т.д.

Локальный канал с радиусом

  local:
    color: "&7"
    symbol: "L"
    default: false
    radius: 100        # блоков
    format: "&8[&7Локальный&8] %luckperms_prefix%&f%player_name%&7: &f%message%"

Игроки вне радиуса 100 блоков не получат сообщение. Переключение: /ch local.

Канал для персонала

  staff:
    color: "&c"
    symbol: "S"
    default: false
    radius: 0
    permission: "venturechat.channel.staff"
    format: "&8[&cSTAFF&8] &c%player_name%&7: &f%message%"

Видеть и писать в канал могут только игроки с пермишеном venturechat.channel.staff. Удобно для общения модераторов без /msg.

EssentialsChat: настройка формата

Если сервер уже использует EssentialsX, отдельный плагин чата можно не ставить. EssentialsX включает модуль EssentialsChat в основном JAR с версии 2.20.

Откройте plugins/Essentials/config.yml и найдите секцию chat:

# plugins/Essentials/config.yml

chat:
  # Формат чата. {PREFIX} и {SUFFIX} берутся из Vault/LuckPerms.
  # {DISPLAYNAME} - ник с цветом (если задан через /nick), {USERNAME} - чистый ник.
  format: "{PREFIX}&f{DISPLAYNAME}{SUFFIX}&7: &f{MESSAGE}"

  # Альтернативный формат через PlaceholderAPI:
  # format: "%luckperms_prefix%&f%player_name%%luckperms_suffix%&7: &f{MESSAGE}"

  radius: 0             # 0 - глобальный чат
  admin-spy: true       # /msg и /r видят администраторы

  # Права на цвет в сообщениях:
  # essentials.chat.color        - &a, &b и т.д.
  # essentials.chat.format       - &l, &o, &n, &m, &k
  # essentials.chat.url          - кликабельные ссылки
  # essentials.chat.color.hex    - hex-цвета &#RRGGBB

Важно: если используется EssentialsChat, то Vault обязателен - именно через него плагин получает prefix/suffix из LuckPerms. Убедитесь, что Vault.jar лежит в plugins/ и в консоли нет ошибки “Vault not found”.

Дополнительные опции EssentialsChat:

  # Запрет URL-адресов в чате для игроков без пермишена essentials.chat.url
  url-filtering:
    enabled: true
    regex: "(https?|ftp)://[^\\s/$.?#].[^\\s]*"
    replacement: "[ссылка удалена]"

  # Изменение цвета ника через /nick (требует пермишен essentials.nick.color)
  nick-prefix: "~"

Пермишены EssentialsChat, которые стоит распределить по группам:

ПермишенЧто даёт
essentials.chat.colorЦветные &a-&f коды в тексте сообщения
essentials.chat.formatЖирный &l, курсив &o, подчёркнутый &n
essentials.chat.color.hexHex-цвета &#RRGGBB
essentials.chat.urlКликабельные ссылки
essentials.chat.shoutГлобальный чат через ! перед сообщением

Hex-цвета и MiniMessage

Начиная с Minecraft 1.16 клиент поддерживает 16 миллионов цветов вместо 16 стандартных.

Формат &#RRGGBB (BungeeCord/Legacy)

Используется в большинстве плагинов, совместимых с Bukkit API:

format: "&#FF5500%player_name%&7: &f%message%"

&#FF5500 - оранжевый. Для градиентов плагины вроде CMI или ChatColor+ поддерживают синтаксис {#FF5500>text<#FFCC00}.

MiniMessage (Adventure API)

Paper 1.18+ поддерживает MiniMessage нативно. В VentureChat 3.x и некоторых других плагинах можно использовать:

format: "<#FF5500>%player_name%</color><gray>: </gray><white>%message%</white>"

Градиент через MiniMessage:

prefix: "<gradient:#FF0000:#0000FF>[Admin]</gradient>"

Пермишены на цвет

В VentureChat права на цвет в сообщениях задаются в config.yml:

permissions:
  venturechat.color: "&a, &b, &c ..."    # стандартные цвета
  venturechat.hex: "true"                # hex-цвета
  venturechat.format: "true"             # форматирование &l, &o

Выдайте пермишен vc.hex (или эквивалент по документации версии) нужным группам:

/lp group vip permission set vc.hex true

Антиспам и фильтрация капса

Встроенные инструменты VentureChat

В config.yml VentureChat есть секция chatfilters:

chatfilters:
  anti-caps:
    enabled: true
    max-caps-percentage: 50      # % заглавных от длины сообщения
    min-message-length: 6        # сообщения короче не проверяются
    action: lowercase            # lowercase или block
    bypass-permission: "vc.bypass.caps"

  anti-spam:
    enabled: true
    cooldown: 1500               # мс минимум между сообщениями
    duplicate-threshold: 3       # блок после N одинаковых сообщений подряд
    bypass-permission: "vc.bypass.spam"

  word-filter:
    enabled: true
    replace-char: "*"
    words:
      - "плохоеслово1"
      - "плохоеслово2"

Игроки с пермишеном vc.bypass.spam (например, группа admin) не подпадают под ограничения.

Антиспам в EssentialsX

# plugins/Essentials/config.yml
spam-command-cooldowns:
  - /msg 500          # мс между /msg
  - /r 500

chat-spam-commands:
  - /msg
  - /mail
  - /tell

# Минимальная длина сообщения (защита от флуда пробелами):
minimum-chat-message-length: 1

ChatControl Red (расширенная фильтрация)

Если базовых инструментов мало, ChatControl Red - наиболее функциональный платный плагин фильтрации на рынке. Он добавляет: детектор рекламы (IP-адреса, домены), нейросетевой определитель языка, капча для новых игроков, правила regex с action (warn/kick/ban/mute), счётчик нарушений.

Бесплатный аналог с ограниченным набором функций - ChatRegulator (open-source, Velocity/Paper).

Пример правила regex-фильтра в ChatControl Red для блокировки рекламы:

# plugins/ChatControl/rules/chat.rs
match ".*(discord\.gg|vk\.com/.*serv|t\.me).*"
then warn &cРеклама запрещена!
then deny
strip-accents true
ignore-string samp

Такой подход позволяет гибко описывать паттерны запрещённого контента без хардкода слов, что удобно для регулярно обновляемых правил сервера.

Формат с дополнительными PAPI-переменными

PlaceholderAPI даёт сотни переменных для формата чата. Несколько полезных расширений:

/papi ecloud download Essentials
/papi ecloud download Vault
/papi ecloud download Player
/papi reload

Пример расширенного формата с иконкой AFK и балансом:

format: "%essentials_afk_symbol%%luckperms_prefix%&f%player_name%%luckperms_suffix% &8[&e%vault_eco_balance_formatted%&8]&7: &f%message%"

Где %essentials_afk_symbol% возвращает [AFK] если игрок неактивен, иначе пустую строку.

Проверить любую переменную прямо в игре можно командой:

/papi parse Steve %luckperms_prefix%

Если переменная возвращает пустую строку или буквально %luckperms_prefix% - расширение не загружено или у игрока не установлен prefix. Полный список доступных расширений:

/papi ecloud list all

Расширения хранятся в plugins/PlaceholderAPI/expansions/. Их можно скачивать вручную с GitHub и класть в эту папку, если сервер без доступа в интернет.

BungeeCord и глобальный чат в сети серверов

Если сервер работает в связке BungeeCord/Velocity, форматирование чата требует отдельного подхода.

Вариант 1 - VentureChat с BungeeCord-режимом. В config.yml устанавливается bungeecord: true для глобального канала, а плагин ставится на каждый субсервер и проксирует сообщения через plugin messaging channel.

channels:
  global:
    bungeecord: true
    format: "&8[&bNetwork&8] %luckperms_prefix%&f%player_name%&7: &f%message%"

Вариант 2 - DiscordSRV. Плагин поддерживает трансляцию сообщений как между субсерверами, так и в Discord-канал. Формат чата задаётся в config.yml секции DiscordToMinecraftChatMessageFormat и MinecraftToDiscordChatMessageFormat.

Вариант 3 - LimboChat (Velocity). Легковесный плагин для Velocity, который перехватывает пакеты чата и форматирует их на уровне прокси. Поддерживает MiniMessage и PAPI через Bridge.

Частые ошибки и их решение

Префикс не отображается - пустая строка вместо него

  1. Проверьте, загружено ли расширение: /papi list - в списке должен быть “luckperms”
  2. Перезагрузите PAPI: /papi reload
  3. Убедитесь, что у группы действительно задан prefix: /lp group vip meta info
  4. Проверьте, что формат в config.yml плагина чата использует %luckperms_prefix% (точные символы %)

Цветовые коды отображаются как текст (&a, &6)

Плагин чата не обрабатывает цветовые коды в пользовательских сообщениях без соответствующего пермишена. Выдайте:

/lp group default permission set essentials.chat.color true

или для VentureChat:

/lp group default permission set vc.color true

Hex-цвета не работают в 1.16+

Убедитесь, что сервер реально запущен на Paper 1.16+, а не Spigot. Adventure API (необходимый для MiniMessage и hex) включён только в Paper-форке. Spigot поддерживает только legacy-формат &#RRGGBB через BungeeCord char codes.

Дубли сообщений в BungeeCord-сети

При использовании VentureChat в BungeeCord-режиме отключите vanilla-чат на субсерверах в spigot.yml:

# spigot.yml
settings:
  bungeecord: true

И убедитесь, что bungeecord: true выставлен в paper-global.yml (Paper 1.19+):

proxies:
  bungeecord:
    online-mode-overrides: true

Связанные материалы

Форматирование чата - часть более широкой системы управления сервером. Базовую настройку прав и групп читайте в статье LuckPerms: настройка прав, групп и наследования. Если после установки новых плагинов сервер начал тормозить - загляните в Устранение лагов на сервере Minecraft. Для защиты территорий и зон с отдельными правилами чата используйте WorldGuard: регионы и защита территорий.

Заключение

Красивый чат с цветными префиксами строится на трёх компонентах: LuckPerms задаёт мета-данные группы, PlaceholderAPI пробрасывает их переменными, VentureChat или EssentialsChat собирает финальную строку. Hex-цвета и MiniMessage-градиенты доступны с Paper 1.16+. Каналы чата (локальный, глобальный, staff) помогают структурировать общение на крупных серверах, а встроенный антиспам убирает флуд без дополнительных плагинов. Главное - после каждого изменения конфига выполнять /papi reload и перезапускать плагин чата, иначе изменения не применятся.

Pterohost - хостинг Minecraft с автоматическим резервным копированием, NVMe-дисками и защитой от DDoS-атак уровня L3-L7. Промокод 4START снижает стоимость первого заказа на 20%. Заказать Minecraft хостинг