> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hauch.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# hChat Overview

> A modern and complete chat system for Paper 1.20+ servers.

# hChat

**hChat** is a modern and complete chat system for [Paper](https://papermc.io) 1.20+ servers. It includes chat channels, direct messages, mentions, moderation tools, filters, AFK, mail, chat replay, PlaceholderAPI integration, and more.

> **[Install hChat](https://docs.hauch.dev/en/hChat/installation.md)**
>
> Download, install, and verify hChat on your Paper server.

> **[Configuration](https://docs.hauch.dev/en/hChat/configuration.md)**
>
> Learn every option in config.yml with examples.

> **[Commands & Permissions](https://docs.hauch.dev/en/hChat/commands.md)**
>
> Full command and permission reference.

> **[Developer API](https://docs.hauch.dev/en/hChat/api.md)**
>
> 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.

> **Mail**
>
> 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](https://github.com/hauchdev/hChat)**
>
> View source code.

> **[Latest release](https://github.com/hauchdev/hChat/releases/latest)**
>
> Download the latest JAR.

> **[Modrinth page](https://modrinth.com/plugin/hchat)**
>
> View on Modrinth.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.