# ChatReplacer \u2013 Dynamic Chat Replacements for Paper Minecraft<\/p>\n
**Version:** 1.0.0
\n**Supported Minecraft Versions:** 1.20.x \u2013 1.21.x (Paper)
\n**Authors:** VelocityStudios <\/p>\n
—<\/p>\n
## Overview<\/p>\n
ChatReplacer is a lightweight, powerful plugin for Paper servers that lets you **dynamically replace text and emojis in player chat messages**. Customize your server\u2019s chat with **MiniMessage formatting, gradients, and Unicode symbols**, all fully configurable in a YAML file. <\/p>\n
With ChatReplacer, you can make your server\u2019s chat more engaging, colorful, and interactive \u2014 perfect for public servers, mini-games, or roleplay communities.<\/p>\n
—<\/p>\n
## Features<\/p>\n
### Core Functionality
\n– Replace words, phrases, or emoji shortcuts in player chat messages.
\n– Multiple replacements can occur **within a single message**.
\n– Fully configurable via `config.yml`.
\n– Works **server-wide** or per permission group.<\/p>\n
### Replacement Options ### Player & Permissions ### Advanced Features — Player types: gg \u2192 Output: ## Installation<\/p>\n ### Download the latest ChatReplacer .jar from Modrinth.<\/p>\n Place it in your server\u2019s \/plugins folder.<\/p>\n Start your Paper server.<\/p>\n A default config.yml is automatically created in \/plugins\/ChatReplacer\/.<\/p>\n Customize replacements and reload the plugin using \/chatreplacer reload.<\/p>\n ### Requirements<\/p>\n PaperMC 1.20.x \u2013 1.21.x<\/p>\n Why Use ChatReplacer?<\/p>\n Add fun emojis, colorful gradients, and custom text to your server chat.<\/p>\n Fully configurable, permission-aware, and easy to use.<\/p>\n Keep your chat vibrant and interactive without modifying Minecraft itself.<\/p>\n ## Usage Example<\/p>\n ### Command ### Example config.yml gg: A simple plugin that replaces configured text for you<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"chatreplacer++","_minecraft_project_id":"J5NyFmXq","_minecraft_author":"seavitash","_minecraft_license":"MIT","_minecraft_downloads":57,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"chatreplacer++.zip","_minecraft_size_bytes":5617,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T20:52:38.978703Z","_minecraft_date_created":"2025-11-01T07:40:21.429463Z","_minecraft_date_modified":"2025-10-29T13:02:43.657590Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/chatreplacer++","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-01T20:19:20+00:00","_minecraft_import_hash":"7e26c267ba03a052a709b82da262f5a0","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,867,92],"mod_loader":[132],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-38917","mod","type-mod","status-publish","hentry","mod_category-management","mod_category-paper","mod_category-social","mod_category-utility","mod_loader-paper","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– Replace text with **Unicode characters, symbols, or custom messages**.
\n– **MiniMessage support**, including gradients and colors (e.g., `
\n– Optional **case sensitivity toggle**. <\/p>\n
\n– Apply replacements only to players with `chatreplacer.use`.
\n– Admin commands restricted to `chatreplacer.admin`.
\n– Per-player exclusion supported via permissions.<\/p>\n
\n– Replace **whole words** or partial matches.
\n– Hover text or click events with MiniMessage syntax.
\n– Dynamic reload with `\/chatreplacer reload` \u2014 no server restart required.
\n– Automatically preserves the player\u2019s name in chat messages.<\/p>\n
\nPlayer types: Hello \ud83d\ude42 \u2192 Output:
\n“`<\/p>\n
\nreplacements:
\n smile:
\n find: “:smile:”
\n replace: “\ud83d\ude0a”
\n wholeWord: false
\n caseSensitive: false<\/p>\n
\n find: “gg”
\n replace: “Good game!”
\n wholeWord: true
\n caseSensitive: false<\/p>\n","protected":false},"excerpt":{"rendered":"