Что такое FlectonePulse и для чего он нужен?

FlectonePulse – это плагин для серверов Minecraft, который позволяет полностью настраивать сообщения, чат, команды и интеграции. Он предоставляет гибкую систему форматирования текста, автоматическое определение языка игроков и интеграции с Discord, Telegram и Twitch

Как установить FlectonePulse?

• Bukkit

• Fabric и NeoForge

Как настроить форматирование сообщений?

FlectonePulse обладает универсальной системой форматирования текста, поддерживающей различные цветовые форматы – от классических кодов до современных градиентов.

Для гибкости вы можете использовать & или § как взаимозаменяемые символы.

welcome-message: "<gradient:#FF0000:#00FF00>&lПривет</gradient> <rainbow><player></rainbow>!"

Можно ли отключить определённые функции плагина?

Да, FlectonePulse использует модульную систему. Любую функцию (команды, сообщения или интеграции) можно отключить в файлах command.yml, message.yml или integration.yml соответственно. После внесения изменений перезапустите плагин командой /flectonepulse reload.

Как работает автоматическое определение языка?

Если в config.yml включена опция by_player, плагин автоматически определяет язык Minecraft игрока и отображает сообщения из папки localizations/... на этом языке. Если локализация недоступна, используется язык по умолчанию из конфигурации. Подробности в документации по локализации.

Какие интеграции поддерживает FlectonePulse?

Плагин интегрируется с Discord, Telegram и Twitch, позволяя игрокам общаться через разные платформы. Также поддерживаются сторонние плагины Minecraft, например LuckPerms и Vault для прав и групп, PlaceholderAPI и MiniPlaceholders для плейсхолдеров, SkinsRestorer для скинов, PlasmoVoice и SimpleVoice для запрета говорить игрокам с мутом, LiteBans, LibertyBans, AdvancedBan и CMI для модерации. Настройка интеграций выполняется в файле integration.yml. Подробности в документации по интеграциям.

Почему команды или сообщения не работают у обычных игроков?

Скорее всего дело в правах. Все права находятся в permission.yml, у каждого есть name (название права) и type (кому оно доступно по умолчанию).

Чтобы выдать право конкретной группе, возьми name нужного права из permission.yml и выдай его, например /lp group default permission set flectonepulse.module.command.me true

Сообщение не появляется, что проверить?

Как отправлять сообщения из Minecraft в Discord или Telegram?

Впиши токен бота в integration.yml, включи интеграцию и добавь нужный тип сообщения в message_channel, где значением является ID канала

message_channel:
  MESSAGE_CHAT_GLOBAL:
    - "123456"
  COMMAND_BAN:
    - "123456"

Названия типов сообщений совпадают с названиями модулей, например COMMAND_BAN или MESSAGE_CHAT_GLOBAL. Для своего чата с названием admin это будет MESSAGE_CHAT_ADMIN

Почему в чате не отображаются головы, иконки и текстуры?

Модуль object работает только для игроков, которые играют на версии 1.21.9 и выше. Все остальные вместо головы или иконки увидят обычный символ из default_symbol

Почему сообщения в чате дублируются?

Чаще всего это другой плагин, который тоже отправляет сообщение. Проверь cancel у чата в message.yml – с cancel: false FlectonePulse не отменяет ивент, поэтому сообщение может отправить и сервер, и другой плагин.

Также дублирование бывает с плагинами, которые изменяют пакеты чата (например InteractiveChat) или с DiscordSRV, если у него включены свои Webhook сообщения. Подробности в чате

Как перенести все настройки на другой сервер?

Для этого есть готовые команды

Подробности в документации команды

Можно ли настраивать конфиги не в файлах?

Да, для этого есть веб-редактор. Впиши host и port в command.yml, а затем напиши /flectonepulse editor и открой полученную ссылку

Что происходит с конфигами при обновлении плагина?

FlectonePulse сам добавляет новые настройки и переносит старые значения, поэтому конфиги удалять не нужно. Перед этим создаётся копия старых файлов и базы данных в папке FlectonePulse/backups/старая_версия

Поддерживает ли FlectonePulse PlaceholderAPI?

Да, FlectonePulse полностью совместим с PlaceholderAPI и MiniPlaceholders. Используйте плейсхолдеры в сообщениях.

FlectonePulse добавляет и свои плейсхолдеры, например %flectonepulse_ping% или %flectonepulse_online_total_formatted%. Полный список есть в документации PlaceholderAPI и MiniPlaceholders

Как использовать команду /chatsetting?

Введите в чат команду /chatsetting, чтобы настроить чат и связанные функции (например, цвет, стиль, уведомления).

Как использовать команду /symbol?

Введите в чат команду /symbol, чтобы искать и использовать Unicode-эмодзи.

Есть ли поддержка мини-игр в чате?

Да, игроки могут использовать встроенные мини-игры, такие как крестики-нолики или камень-ножницы-бумага.

Чем FlectonePulse отличается от FlectoneChat?

FlectonePulse – это новый проект, а не улучшенная версия FlectoneChat. FlectoneChat был экспериментом, а FlectonePulse создан с учётом прошлых ошибок, предлагая больше возможностей и кастомизации.

Как включить ототображение имени над игроком?

Включите настройку name_visible в файле message.yml:

scoreboard:
  enable: true
  name_visible: false
  name_distance: -1.0
  hide_name_when_sneaking: false
  color: "<white>"
  ticker:
    enable: false

После изменения выполните команду /flectonepulse reload. Подробности в документации по настройке.

Как настроить отображение имени игрока?

Настройка имени игрока (display) выполняется в файле localizations/...:

names:
  constant: []
  display:
  - "<click:suggest_command:\"/msg <player> \"><hover:show_text:\"<fcolor:2>Написать <white><player_head_or:''></white><nickname>\"><white><player_head_or:''></white><prefix><stream><fcolor:2><nickname><afk><suffix><reset>"
  entity: "<fcolor:2><hover:show_text:\"<fcolor:2><name> <br><fcolor:1>Тип <fcolor:2><lang:'<type>'> <br><fcolor:1>Айди <fcolor:2><uuid>\"><sprite_or:'':gui:icon/accessibility><name></hover>"
  unknown: "<fcolor:2><name>"
  console: "<white><player_head_or:'':Console></white><click:suggest_command:\"/msg <name> \"><hover:show_text:\"<fcolor:2>Написать в <white><player_head_or:'':Console></white>Консоль\"><fcolor:2>Консоль"
  invisible: "<fcolor:2>👻 Невидимка"

После изменений выполните /flectonepulse reload. Подробности в документации по локализации.

Как настроить цвета в сообщениях и интерфейсе?

Настройка цветов выполняется в файле message.yml с помощью модуля fcolor:

fcolor:
  enable: true
  default_colors:
    1: "<gradient:#A6D8FF:#8CC8FF>"
    2: "<gradient:#6BB6FF:#4DA6FF>"
    3: "#A9A9A9"
    4: "#FFFAFA"

Здесь задаются цвета по умолчанию, если игрок не выбрал свои в /chatsetting или /chatcolor. Можно запретить изменение цветов в соответствующих командах. Подробности в руководстве по форматированию.

Как настроить ТАБ (список игроков)?

Для включения/отключения модулей ТАБа настройте файл message.yml:

tab:
  enable: true
  header:
    enable: true
  footer:
    enable: true
  playerlistname:
    enable: true

Для изменения сообщений отредактируйте файл локализации localizations/...:

tab:
  header:
    lists:
    - - " "
      - "<fcolor:1>👾"
      - " "
    - - " "
      - "<fcolor:1>❤"
      - " "
  footer:
    lists:
    - - " "
      - "<fcolor:1>Привет <fcolor:2><nickname><fcolor:1>!"
      - " "
    - - " "
      - "<fcolor:1>ТПС <replacement:tps>, Онлайн <replacement:online>"
      - " "
  playerlistname:
    format: "<!shadow><white><player_head></white></!shadow><world>▋ <reset><prefix><stream><fcolor:2><nickname><afk><mute><suffix>"

После изменений выполните /flectonepulse reload. Подробности в документации по ТАБ.

Что делать, если возникают ошибки?

Как связаться с разработчиками?

Присоединяйтесь к Discord-сообществу для поддержки и предложений. Оставьте звезду на GitHub или отзыв на SpigotMC.

Когда выйдет новая версия FlectonePulse с поддержкой последней версии Minecraft?

Скорее всего, FlectonePulse уже поддерживает новейшую версию Minecraft. Экспериментальные версии доступны для скачивания на GitHub или в Discord-канале для тестеров. Если версия Minecraft уже вышла, а обновление FlectonePulse отсутствует, это связано с ожиданием релиза PacketEvents – основной библиотеки, используемой FlectonePulse для взаимодействия с сервером. Как только PacketEvents выйдет в релиз, FlectonePulse будет обновлён.

Работает ли FlectonePulse с прокси и как его настроить?

FlectonePulse поддерживает прокси-серверы, включая BungeeCord и Velocity. Для работы плагина необходимо установить один и тот же файл плагина как на прокси, так и на сервер. На прокси файлы конфигурации не создаются – оно выступает в роли моста. Все настройки выполняются в файлах на серверах. Для корректной работы обязательно нужна серверная база данных (MySQL, MariaDB или PostgreSQL), которая должна быть настроена в файле config.yml на серверах. Также нужно включить один из режимов velocity или bungeecord, подробности в документации по конфигурации.

Поддерживает ли FlectonePulse ядра, работающие одновременно с модами и плагинами, такие как Arclight или Mohist?

FlectonePulse не тестировался на ядрах, поддерживающих одновременно моды и плагины (например, Arclight или Mohist), и их поддержка не предполагается, но это может работать. Основная проблема заключается в библиотеке PacketEvents, как и на Fabirc/NeoForge, некоторые моды могут создавать собственные протоколы или изменять существующие, что может приводить к вылетам игроков

Отдельные версии для Fabric и NeoForge работают только на самой последней версии Майнкрафта из-за сложности поддержки мульти-версий

Твой плагин, использующий чат, и FlectonePulse несовместимы?

По умолчанию FlectonePulse имеет настройку mode: "BUKKIT" для чатов, с ней сообщения чата видят и другие плагины

Если плагин всё равно конфликтует, попробуй изменить priority у чата, например на HIGHEST, чтобы FlectonePulse изменял сообщение самым последним