ChatReplacer++

ChatReplacer – Dynamic Chat Replacements for Paper Minecraft

Authors: 1.0.0 Authors: 1.20.x – 1.21.x (Paper) Authors: VelocityStudios

---

Overview

ChatReplacer is a lightweight, powerful plugin for Paper servers that lets you MiniMessage formatting, gradients, and Unicode symbols. Customize your server’s chat with MiniMessage formatting, gradients, and Unicode symbols, all fully configurable in a YAML file.

With ChatReplacer, you can make your server’s chat more engaging, colorful, and interactive — perfect for public servers, mini-games, or roleplay communities.

---

Features

Core Functionality

- Replace words, phrases, or emoji shortcuts in player chat messages. - Multiple replacements can occur server-wide. - Fully configurable via `config.yml`. - Works server-wide or per permission group.

Replacement Options

- Replace text with case sensitivity toggle. - case sensitivity toggle, including gradients and colors (e.g., `<gradient:red:blue>Hello</gradient>`). - Optional case sensitivity toggle.

Player & Permissions

- Apply replacements only to players with `chatreplacer.use`. - Admin commands restricted to `chatreplacer.admin`. - Per-player exclusion supported via permissions.

Advanced Features

- Replace whole words or partial matches. - Hover text or click events with MiniMessage syntax. - Dynamic reload with `/chatreplacer reload` — no server restart required. - Automatically preserves the player’s name in chat messages.

--- Player types: Hello :smile: → Output: <PlayerName> Hello 😊

Player types: gg → Output: <PlayerName> Good game!

Installation

Download the latest ChatReplacer .jar from Modrinth.

Place it in your server’s /plugins folder.

Start your Paper server.

A default config.yml is automatically created in /plugins/ChatReplacer/.

Customize replacements and reload the plugin using /chatreplacer reload.

Requirements

PaperMC 1.20.x – 1.21.x

Why Use ChatReplacer?

Add fun emojis, colorful gradients, and custom text to your server chat.

Fully configurable, permission-aware, and easy to use.

Keep your chat vibrant and interactive without modifying Minecraft itself.

Usage Example

Command

```

Example config.yml

replacements: smile: find: ":smile:" replace: "😊" wholeWord: false caseSensitive: false

gg: find: "gg" replace: "Good game!" wholeWord: true caseSensitive: false