LunaticChat
A next-generation chat plugin for Paper, Folia and Velocity.
Supports Minecraft 26.2 | Requires Java 25+ and Gradle 9+
Features
- Channel Chat: Create and manage channels for group conversations between specific players. Includes private channels and moderation features.
- Direct Messages: Send 1-on-1 chats with
/tell or /msg commands. Quickly reply to the last sender with /reply.
- Romaji Conversion: Automatically convert romaji input into Japanese. Fast performance powered by caching.
- Velocity Cross-Server Chat: Relay global chat across multiple servers via a Velocity proxy. Join conversations from any server.
- Flexible Configuration: Toggle features on/off with a YAML-based config file. Customize to fit your server's needs.
- Latest Version Support: Minimal external plugin dependencies, always supporting the latest Minecraft versions.
Installation
[!WARNING]
LunaticChat only supports Paper / Folia servers. Spigot and BungeeCord are not supported, and there are no plans to support them in the future. For Spigot environments, we recommend using a fork of LunaChat.
Requirements
| Item | Requirement |
|---|
| Minecraft | 26.2 or later |
| Java | 25 or later |
| Server | Paper, Folia, or Velocity |
Download
Grab the plugin JAR from either of the following:
Paper and Folia use LunaticChat-<version>.jar; Velocity proxies use LunaticChat-<version>-velocity.jar. The two are versioned independently.
Paper / Folia
- Place
LunaticChat-<version>.jar into the server's plugins/ directory
- Start (or restart) the server
plugins/LunaticChat/config.yml is generated automatically- Adjust the configuration as needed, then run
/lc reload or restart the server
Velocity
- Place
LunaticChat-<version>-velocity.jar into the Velocity plugins/ directory
- Start (or restart) the proxy
- Set
features.velocityIntegration.enabled to true in the config.yml of every backend server
- Restart the backend servers, then check the connection with
/lcv status — the handshake is sent once a player joins, so an empty server reports DISCONNECTED
For more detail, see Getting Started.
Configuration
Server-wide settings live in plugins/LunaticChat/config.yml, generated on first startup. Most features are disabled by default, so enable the ones you want:
language: "en" # Plugin language (en / ja)
features:
quickReplies:
enabled: true # /reply command
japaneseConversion:
enabled: false # Romaji to Japanese conversion
channelChat:
enabled: false # Channel chat
velocityIntegration:
enabled: false # Velocity proxy integration
/lc reload re-reads config.yml and applies the messageFormat settings without a restart. Every other setting is fixed when the server starts, so the command reports which of your changes still need a restart. A file it cannot read in full is refused outright and the running configuration is kept.
Chat output is customizable through messageFormat with placeholders such as {sender}, {message}, {channel} and {server}:
messageFormat:
channelMessageFormat: "§7[§b#{channel}§7] §e{sender}: §f{message}"
Players control their own preferences with /lc settings (direct message notifications, channel notifications, and romaji conversion). These are stored per UUID in player-settings.yaml.
Every key, its type, and its default are listed in the Configuration reference. See also the Player Settings reference and the default config.yml.
Velocity Integration
LunaticChat can relay global chat across multiple Paper / Folia servers behind a Velocity proxy, and optionally deliver direct messages across servers. Install the plugin on both the Velocity proxy and each backend server.
Paper–Velocity compatibility is determined solely by an internal protocol version, not by the plugin version. Builds with incompatible protocol versions will refuse to relay chat, so keep both sides updated together.
For supported combinations and setup details, see Paper / Velocity Compatibility and Velocity Integration.
Building from Source
git clone [email protected]:m1sk9/LunaticChat.git
cd LunaticChat
./gradlew shadowJar
The JARs are written to platform-paper/build/libs/ and platform-velocity/build/libs/. See CONTRIBUTING for the development workflow, and the Developer Guide for the design overview.
License
LunaticChat is published under GNU General Public License v3.0.
