hChat
hChat is a modern and complete chat system for Paper 1.20+ servers. It includes chat channels, direct messages, mentions, moderation tools, filters, AFK, mail, chat replay, PlaceholderAPI integration, and more.Install hChat
Download, install, and verify hChat on your Paper server.
Configuration
Learn every option in config.yml with examples.
Commands & Permissions
Full command and permission reference.
Developer API
Integrate hChat into your own plugins.
Features
Direct messages
Customizable format with hover tooltips and click-to-reply.
@Mentions
Configurable sound, highlight color, and personal notification.
Spy mode
Monitor private messages with a dedicated permission.
Ignore system
Persistent per-player block list that survives reloads.
Multi-language
YAML localization with per-player language selection.
PlaceholderAPI
%hchat_spy_enabled%, %hchat_ignored%, DND, last seen, and more.MiniMessage + hex
MiniMessage tags,
&#RRGGBB hex, and classic & codes.Hover & click
Tooltips and clickable actions on every chat line.
Broadcasts
Manual
/bc plus auto-broadcast scheduler.Moderation
Slowmode, chat lock, and staff chat (
/sc).Filter chain
Word filter, anti-caps, anti-unicode, anti-ad, and anti-spam.
Chat logger
Rotating daily logs with configurable retention.
Chat channels
Per-world, per-permission, aliases, cooldowns.
Offline messages with
/hchat mail read\|clear\|send.AFK
Automatic inactivity detection plus
/afk [message].Mass mentions
@everyone / @here with cooldown and sound.Ping & seen
/ping [player] and /seen <player>.Chat replay
/hchat replay [player] on a ring buffer.Requirements
Paper 1.20+
A Paper server.
Java 21+
Required runtime.
PlaceholderAPI 2.11+
Required for placeholders.
Quick links
GitHub repository
View source code.
Latest release
Download the latest JAR.
Modrinth page
View on Modrinth.