ChatReplacer – Dynamic Chat Replacements for Paper Minecraft
Version: 1.0.0
Supported Minecraft Versions: 1.20.x – 1.21.x (Paper)
Authors: VelocityNodes



Overview:
ChatReplacer is a lightweight and powerful plugin for Paper servers that allows you to dynamically replace text and emojis in player chat messages. Customize your server’s chat with MiniMessage formatting, gradients, and Unicode symbols, all fully configurable via a YAML file.


It makes your server 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
• Supports MiniMessage formatting including gradients and colors
• 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 via MiniMessage
• Dynamic reload with /chatreplacer reload without restarting the server
• Automatically preserves the player’s name in chat messages

Example Usage:


Command:
/chatreplacer reload
Reloads the plugin configuration without restarting the server.


Example config.yml:
replacements:
smile:
find: ":smile:"
replace: " "
wholeWord: false
caseSensitive: false


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


Example Output:

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

Installation:

1. Download the latest ChatReplacer .jar from BuildByBit.
2. Place it in your server’s /plugins folder.
3. Start your Paper server.
4. A default config.yml is automatically created in /plugins/ChatReplacer/
5. Customize replacements and reload the plugin using /chatreplacer reload

Requirements:

• PaperMC 1.20.x – 1.21.x
• Java 17 or higher

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