What is FlectonePulse and what is it used for?

FlectonePulse is a plugin for Minecraft and Hytale servers that allows full customization of messages, chat, commands, and integrations. It provides a flexible text formatting system, automatic player language detection, and integrations with Discord, Telegram, and Twitch.

How to install FlectonePulse?

Download the plugin from CurseForge

Place the plugin file into your server's mods folder

Restart the server

Configure settings in the configuration files

File	Documentation link	Explanation
`config.yml`	Configuration	The main configuration of FlectonePulse, essential for proper operation. Here you set up the database, plugin language, proxy mode, etc.
`command.yml`	Commands	Configuration of all built-in commands
`integration.yml`	Integrations	Configuration of interactions with external plugins and services.
`message.yml`	Messages	Configuration of FlectonePulse messages (their trigger conditions and content). Not to be confused with message formatting, which is done in `/localizations/...` files.
`localizations/...`	Referenced in the documentation for each command and message section	This folder contains configuration files for each player language (see language). Here you configure the format of messages, i.e., the text.
`permission.yml`	Referenced in the documentation for each command, message, and integration	Permission configuration. By default, permissions are set so that most features are accessible to all players without additional setup.

How to configure message formatting?

FlectonePulse features a universal text formatting system that supports various color formats–from classic codes to modern gradients.

Input Color	Converts to
`&0`-`&9`, `&a`-`&f`	`<black>`, `<dark_blue>` ... `<white>`
`&l`/`&m`/`&n`/`&o`/`&k`/`&r`	`<b>` / `<st>` / `<u>` / `<i>` / `<obf>` / `<reset>`
`&#rrggbb`, `#rrggbb`, `&x&r&r&g&g&b&b`, `<##rrggbb>`	`<#rrggbb>`
MiniMessage Tags	`<color:#rrggbb>`, `<rainbow>`, `<click:...>`, `<font>`, etc.

For flexibility, you can use & or § interchangeably.

welcome_message: "<gradient:#FF0000:#00FF00>&lHello</gradient> <rainbow><player></rainbow>!"

welcome message

Can specific plugin features be disabled?

Yes, FlectonePulse uses a modular system. Any feature (commands, messages, or integrations) can be disabled in command.yml, message.yml, or integration.yml respectively. After making changes, restart the plugin with /flectonepulse reload.

How does automatic language detection work?

If the by_player option is enabled in config.yml, the plugin automatically detects the player's Hytale language and displays messages from the localizations/... folder in that language. If the localization is unavailable, the default language from the configuration is used. Details in the localization documentation.

What integrations does FlectonePulse support?

The plugin integrates with Discord, Telegram, and Twitch, allowing players to communicate across different platforms. Integration configuration is done in integration.yml. Details in the integration documentation.

Why do commands or messages not work for regular players?

Most likely it is about permissions. All permissions are in permission.yml, each one has a name (the permission itself) and a type (who has it by default). To give a permission to a group, take the name of the permission from permission.yml and grant it to the players

A message does not appear, what should I check?

Whether the module itself and its parent are enabled in message.yml or command.yml (enable: true)

Whether the player has the module's permission from permission.yml

Whether the range fits, for example with range: 100 only nearby players see the message

Whether the line in the localization file is not empty, because an empty message is not sent

Reload the plugin with /flectonepulse reload and look at the console

How to move all settings to another server?

On the first server write /flectonepulse export, this creates a .zip archive in the FlectonePulse folder

Move this archive to the FlectonePulse folder on the other server

Write /flectonepulse import archive_name, after which the plugin reloads with the new settings

Details in the command documentation

Can configs be edited outside of the files?

Yes, there is a web editor for that. Put host and port into command.yml, then write /flectonepulse editor and open the returned link

What happens to the configs when the plugin updates?

FlectonePulse adds new settings and carries over old values itself, so there is no need to delete the configs. Before that, a copy of the old files and of the database is created in the FlectonePulse/backups/old_version folder

Warning

Do not change version in config.yml manually, the plugin uses it to know which version to migrate the settings from

How is FlectonePulse different from FlectoneChat?

FlectonePulse is a new project, not an improved version of FlectoneChat. FlectoneChat was an experiment, while FlectonePulse is built from the ground up, learning from past mistakes and offering more features and customization.

How to enable player name display above players?

Enable the name_visible setting in message.yml:

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

After making changes, run /flectonepulse reload. Details in the configuration documentation.

How to configure player name display?

Player name display (display) configuration is done in localizations/... files:

names:
  constant: []
  display:
  - "<click:suggest_command:\"/msg <player> \"><hover:show_text:\"<fcolor:2>Написать <nickname>\"><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>\"><name></hover>"
  unknown: "<fcolor:2><name>"
  console: "<click:suggest_command:\"/msg <name> \"><hover:show_text:\"<fcolor:2>Написать в Консоль\">Консоль"
  invisible: "<fcolor:2>[Invisible]"

After changes, run /flectonepulse reload. Details in the localization documentation.

How to configure colors in messages and UI?

Color configuration is done in message.yml using the fcolor module:

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

This sets default colors if a player hasn't chosen their own via /chatsetting or /chatcolor. You can also disable color changes in the respective commands. Details in the formatting guide.

Note

It's easier to change 4 colors here than to replace <fcolor:...> in all plugin settings.

What to do if errors occur?

Check the server console for errors and share them in the Discord community for assistance.

Make sure you are using the latest version of the plugin.

Review the documentation or get personalized technical support for boosters on Boosty.

How to contact the developers?

Join the Discord community for support and suggestions. Leave a star on GitHub

When will the new version of FlectonePulse be released?

Experimental versions are available for download on GitHub or in the tester Discord channel