FlectonePulse

FlectonePulse – Every Message Under Your Control!

What Is FlectonePulse?

FlectonePulse is a plugin and mod for Minecraft (and Hytale) servers that takes full control over chat, messages, and notifications. You decide what players see, when they see it, and how it looks. Clean defaults for beginners, deep configuration for everyone else

FlectonePulse was the subject of a university thesis and received top marks for its architecture, technical depth, and practical value. The full thesis, presentation, and plagiarism report are publicly available

• 📄 Thesis (PDF)
• 📊 Thesis Presentation (PPTX)
• ✅ Plagiarism Report (PDF)

Why FlectonePulse instead of other message plugins?

| Feature | FlectonePulse | Typical message plugin |
|——————————————————————————–|:————-:|:—————————–:|
| Fully async – no main thread impact | ✅ | ❌ |
| Supports 1.8.8 up to the latest Minecraft version | ✅ | ⚠️ (often limited) |
| Works on Bukkit, Spigot, Paper, Purpur, Folia, and Fabric | ✅ | ❌ (usually one platform) |
| Built‑in proxy support (BungeeCord, Velocity) | ✅ | ❌ (requires separate plugin) |
| Cross‑server message synchronization (via proxy or Redis) | ✅ | ❌ |
| Hytale support | ✅ | ❌ |
| Per‑player Minecraft client language detection | ✅ | ❌ |
| Textures in chat without resource pack (<texture:name>) | ✅ | ❌ |
| In‑line player heads and built‑in sprites (<player_head>, <sprite:name>) | ✅ | ❌ |
| Modular design – enable/disable any feature | ✅ | ⚠️ (rarely) |
| 40+ built‑in commands (chat, moderation, fun, polls, etc.) | ✅ | ❌ |
| Cross‑platform chat (Discord, Telegram, Twitch) | ✅ | ❌ |
| Legacy color codes + MiniMessage support in one system | ✅ | ⚠️ (usually one or the other) |
| Google Guice dependency injection for clean architecture | ✅ | ❌ |
| Open source & completely free | ✅ | ⚠️ (often freemium) |

Requirement

Java 21 or higher is required on every platform. Older Minecraft versions, such as 1.8.8, can also run on Java 21 (see PandaSpigot)

| Platform | Supported Versions |
|———————————————-|———————–|
| Bukkit / Spigot / Paper / Purpur / Folia | 1.8.8 – Latest |
| Fabric | 1.14.4 – Latest |
| BungeeCord / Waterfall | Latest |
| Velocity | Latest |
| Hytale | Latest Hytale version |
| NeoForge | 1.21.1 – Latest |
| Sponge | 1.21.10 – Latest |

Paper 1.16.5 and 1.17.x refuse to start on newer Java and print Unsupported Java detected (...). Only up to Java 16 is supported. To skip this check, add the -DPaper.IgnoreJavaVersion=true flag

java -DPaper.IgnoreJavaVersion=true -jar paper.jar nogui

Paper 1.18 and newer start on Java 21 without this flag

Configuration Files

| File | Purpose |
|———————–|———————————————-|
| config.yml | Database, language, proxy mode, cache |
| command.yml | Enable/disable and configure commands |
| message.yml | All message modules, conditions and behavior |
| integration.yml | Third-party plugins and external platforms |
| permission.yml | Permissions for every feature |
| localizations/*.yml | Per-language message text |

🎨 Color Formatting

FlectonePulse understands every color system and converts them all to MiniMessage internally. Mix legacy codes and modern tags in the same line, it works

| Input | Result |
|—————————————–|——————————————————|
| &0–&9, &a–&f | <black>, <dark_blue>, …, <white> |
| &l / &m / &n / &o / &k / &r | <b> / <st> / <u> / <i> / <obf> / <reset> |
| &#rrggbb, #rrggbb | <#rrggbb> |
| MiniMessage | <gradient>, <hover:...>, <click:...>, etc. |

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

🧱 Textures in Chat – No Resource Pack Needed

Embed custom images directly into chat messages and the server MOTD with <texture:name>

Player skin avatars with <player_head>, Minecraft built-in sprites with <sprite:name>

🌍 Per-Player Language Detection

Enable by_player: true and every message is delivered in the player’s own client language. If a translation is missing, the server default is used as fallback

💬 Multi-Channel Chat System

Multiple named chat channels with independent settings. Each channel has its own range, destination, cooldown, sound, trigger

Send any formatted message to any destination with admin command /emit. You can use destination CHAT ACTION_BAR BOSS_BAR TITLE SUBTITLE TOAST TAB_HEADER TAB_FOOTER BRAND

🌈 Per-Player Customization

Players open a full in-game menu /chatsetting to toggle messages, change colors, and disable whatever they don’t want

✨ Everything is a Message and is Configurable

FlectonePulse takes control of virtually every event that produces text

| Module | Description |
|——————————————————————————————————————————————————————————————————————|———————————————————————————|
| | Animated, multi-line server list status with custom textures |
| | Fully formatted with placeholders, sounds, and conditions |
| | Auto-mark and notify when players go idle |
| | Show messages visually above players’ heads |
| | Controlled text below player names |
| | Header, footer, player name format with ping, rank, world |
| | Animated scoreboard sidebar with custom content |
| | Vanilla bar formatting |
| | Custom formatted text (book, sign, anvil) |
| | Scheduled, repeating announcements |
| | Custom clickable links in the server menu |
| | Display custom text in the F3 debug screen |
| | Replace default Minecraft messages your way (death messages, advancement, etc.) |

Full list in documentation 🔗

🎮 40+ Built-In Commands

| Module | Description |
|———————————————————————————————————————|———————————————————————————————————|
| | /ball – magic 8-ball with customizable answers |
| | /tictactoe – play tic-tac-toe in chat |
| | /stream – announce you’re going live |
| | /try – random luck roll from 0% to 100% |
| | /sprite – browse and preview all Minecraft built-in sprites |
| | /poll – create in-chat polls with voting |
| | /ban – ban a player with a reason and optional duration |
| | /whitelist – manage server whitelist with reason and optional duration (add, remove, list, on, off) |

Already exist: /afk /anon /ban /banlist /broadcast /chatcolor /chatsetting /clearchat /clearmail /coin /deletemessage /dice /do /emit /geolocate /helper /ignore /ignorelist /kick /mail /maintenance /me /mute /mutelist /nickname /online /ping /reply /spy /tell /toponline /translateto /unban /unmute /unwarn /warn /warnlist /whitelist

Full list in documentation 🔗

🤝 Integration with Platforms

| Platform | What it adds |
|———————————————————————————————————————–|———————————————————————————————————————————|
| | Discord – bidirectional chat sync. Custom bot commands, channel info ticker, webhook support with embeds and avatar display |
| | Telegram – bidirectional chat sync. Custom bot commands and channel info ticker |
| | Twitch – bidirectional chat sync. Custom bot commands and live stream notifications |

🤝 Integration with Plugins

| Plugin | What it adds |
|—————————————————————————————————————————————————————————————————————————|——————————————————–|
| 🛡️ LuckPerms | Prefix, suffix, group display, TAB sorting by rank |
| 🧩 PlaceholderAPI / MiniPlaceholders | Any %placeholder% from other plugins |
| 🎙️ PlasmoVoice / SimpleVoice | Mute and ignore sync with voice chat |
| 🖼️ SkinsRestorer | Real player skins in chat and TAB |
| 👻 SuperVanish | Vanished players hidden automatically (even via proxy) |
| 💬 InteractiveChat | Enhanced interactive chat elements |
| 🔨 AdvancedBan / LibertyBans / LiteBans | Delegate ban commands to your existing system |
| 🌐 Vault | Permission compatibility |
| 🗣️ Floodgate / Geyser | Bedrock player support |
| 📦 ItemsAdder | Custom textures and items in messages |

Full list in documentation 🔗

🙏 Acknowledgments

FlectonePulse is built on these projects:

• 🏗️ Google Guice – dependency injection
• 📚 JDBI with HikariCP – database access
• 📦 Jackson – data serialization
• 🧙 PacketEvents – packet-level event handling
• 🎨 Adventure – text component formatting
• ⌨️ Cloud – commands with tab completion
• ⏱️ Universal Scheduler – cross-platform task scheduling
• 🔣 Symbol Chat – Unicode symbol picker
• 🌐 MiniTranslator – legacy to MiniMessage conversion
• 🌱 FlectoneChat – the predecessor

And thanks to the community! Every star on GitHub and review on platforms shows that FlectonePulse is genuinely useful ⭐

📊 Project Statistics