ChatReplacer – Dynamic Chat Replacements for Paper Minecraft

Version: 1.0.0
Supported Minecraft Versions: 1.20.x – 1.21.x (Paper)
Authors: VelocityStudios

Overview

ChatReplacer is a lightweight, powerful plugin for Paper servers that lets you dynamically replace text and emojis in player chat messages. 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 within a single message.
Fully configurable via config.yml.
Works server-wide or per permission group.

Replacement Options

Replace text with Unicode characters, symbols, or custom messages.
MiniMessage support, 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: Hello 😊

Player types: gg → Output: 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