Getting Started

This guide explains how to set up LunaticChat.

Spigot / BungeeCord is not supported

LunaticChat only supports Paper / Folia servers. It does not work on Spigot or BungeeCord, 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.1 or later
Java	25 or later
Server	Paper, Folia, or Velocity

Download

You can download the plugin JAR from either of the following:

• GitHub Releases
• Modrinth

Use LunaticChat-<version>.jar for Paper / Folia servers and LunaticChat-<version>-velocity.jar for Velocity proxies.

Installation

Paper / Folia

1. Place the downloaded LunaticChat-<version>.jar into the server's plugins/ directory
2. Start (or restart) the server
3. plugins/LunaticChat/config.yml will be generated automatically
4. Modify the configuration as needed and restart the server

Velocity

1. Place the downloaded LunaticChat-<version>-velocity.jar into the Velocity plugins/ directory
2. Start (or restart) the Velocity proxy
3. Set features.velocityIntegration.enabled to true in the Paper-side config.yml
4. See Velocity Integration for details

Next Steps

• Configuration - Review all settings in config.yml
• Direct Message - How to use the DM feature
• Channel Chat - How to use the channel feature
• Command Reference - Reference for all commands