Skip to content

Home

Jump to bottom
Florianpal1 edited this page Aug 6, 2026 · 8 revisions

FMessage

FMessage is a chat and private-messaging plugin for Minecraft networks. It relays chat between the backend servers of a BungeeCord/Velocity proxy and adds private messages, discussion groups, nicknames, an ignore list, a staff chat and a chat-spy for moderators.

Current version: 2.4.5

FMessage is a network plugin. The Bukkit module is a companion that forwards chat to the proxy — it does not work on its own. See Installation for the full picture.

Getting started
🚀 Installation Install on the proxy and on the backend servers
🗒️ Commands and Permissions Every command, alias and permission node
⚙️ Bukkit Configuration config.yml of the backend server plugin
🛰️ Proxy Configuration config.yml and database.yml of the BungeeCord/Velocity plugin
🌍 Languages Translate messages, add a locale
🗄️ Database Tables created by the plugin, schema reference
🏗️ Architecture Modules, plugin-message channels, message flow
🔨 Building from source Build the jars yourself
🩺 Troubleshooting Common problems and fixes

Features

  • Private messages — /msg, /m and /r across every server of the network
  • Discussion groups — create groups, add or kick members, toggle your chat into a group
  • Nicknames — /nick, stored network-wide, colour support gated by permission
  • Ignore list — /ignore and /unignore, applied to both private messages and public chat
  • Staff chat — /staffchat (/mc) broadcast to every server of the network
  • Chat spy — /chatspy shows staff every private message sent through the proxy
  • Anti-flood and anti-caps — repeated characters are blocked, shouted messages are lowercased
  • Cross-server chat relay — a message written on one backend server is displayed on all of them
  • MariaDB/MySQL persistence — groups, members, nicknames and ignores survive restarts
  • Customisable formats — chat, private-message, spy and staff formats are all configurable
  • PlaceholderAPI support — placeholders are resolved on the backend server before the relay

Requirements
Proxy BungeeCord (1.20+) or Velocity 3.x — one of the two, never both
Backend servers Bukkit / Spigot / Paper, API 1.16+ (tested against Paper 1.21.7)
Java 21
Database MariaDB or MySQL, reachable from the proxy
Backend dependency PlaceholderAPI — required on every backend server

Links

FMessage is distributed under the GPL-3.0 license.

FMessage

Configuration

Development

Help

Clone this wiki locally