**MiniMessageBridge**
\nGlobal Legacy-to-MiniMessage Translation Layer<\/p>\n
<\/p>\n
Transform every plugin’s colors without touching a single config file<\/p>\n
**What is MiniMessageBridge?**<\/p>\n
MiniMessageBridge is a **high-performance packet interceptor** that globally translates legacy Minecraft color codes (\u00a7 and &) into modern **MiniMessage format** in real-time.<\/p>\n
**The Problem:**
\nOld plugins use ugly \u00a7c&l formatting that looks terrible on modern servers. You want vibrant hex colors, gradients, and hover effects, but those plugins don’t support MiniMessage.<\/p>\n
**The Solution:**
\nMiniMessageBridge sits between your plugins and your players. It intercepts every outgoing chat packet, detects legacy formatting, and instantly translates it to your custom MiniMessage definitions.<\/p>\n
“`
\nPlugin sends: \u00a7c\u00a7lHello World
\nPlayer sees: Hello World
\n (Hot pink bold text)
\n“`<\/p>\n
**Features**<\/p>\n
– **Zero Configuration Required** – Works out of the box with sensible defaults
\n– **Packet-Level Interception** – Modifies output at the protocol level, affects ALL plugins
\n– **Universal Compatibility** – Works with hardcoded messages from any plugin
\n– **High Performance** – Caffeine caching with 5000 entry LRU cache
\n– **Runtime Configurable** – Reload configs without restart
\n– **Modern Paper Support** – Fully compatible with Paper 1.20+ Adventure API
\n– **Advanced MiniMessage** – Support for gradients, rainbows, hover events, click events
\n– **Selective Interception** – Choose which packet types to modify
\n– **Debug Mode** – Detailed logging for troubleshooting
\n– **bStats Integration** – Anonymous usage statistics<\/p>\n
**How It Works**<\/p>\n
<\/p>\n
**1. Detection**
\nPlugin sends a message using legacy codes:
\n“`
\n\u00a7cError: Invalid command
\n“`<\/p>\n
**2. Interception**
\nProtocolLib catches the outgoing SYSTEM_CHAT packet before it reaches the player<\/p>\n
**3. Serialization**
\nThe packet’s Adventure Component is converted back to legacy format to detect formatting codes<\/p>\n
**4. Translation**
\nLegacy codes are matched against your config mappings and converted to MiniMessage tags<\/p>\n
**5. Rendering**
\nMiniMessage deserializes the tags into a modern Adventure Component with hex colors<\/p>\n
**6. Delivery**
\nThe modified packet is sent to the player with beautiful modern formatting<\/p>\n
**Installation**<\/p>\n
**Requirements:**<\/p>\n
– Paper 1.20+ (or forks like Purpur, Pufferfish)
\n– ProtocolLib 5.1.0+
\n– Java 17+<\/p>\n
**Steps:**<\/p>\n
1. Download ProtocolLib and place it in your **plugins\/** folder
\n2. Download MiniMessageBridge and place it in your **plugins\/** folder
\n3. Start your server
\n4. Edit **plugins\/MiniMessageBridge\/config.yml** to customize your color scheme
\n5. Run **\/mmb reload** or restart to apply changes<\/p>\n
**Default Config Structure:**<\/p>\n
“`
\nlegacy-mappings:
\n “&c”: “<#ff3860>” # Map &c to hot pink
\n “&a”: “<#00ff41>” # Map &a to neon green
\n “\u00a7c”: “<#ff3860>” # Also map section symbol variant<\/p>\n
format-mappings: settings: packet-interception: **Advanced Example – Gradients:**<\/p>\n “` **Performance**<\/p>\n – Translation cache eliminates re-parsing of identical messages Legacy to MiniMessages<\/p>\n","protected":false},"featured_media":102817,"template":"","meta":{"_minecraft_slug":"minimessagebridge","_minecraft_project_id":"93X4mj73","_minecraft_author":"_GodlyCow","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":36,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"minimessagebridge.zip","_minecraft_size_bytes":921830,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T21:50:03.749160Z","_minecraft_date_created":"2026-02-16T22:50:40.289693Z","_minecraft_date_modified":"2026-02-15T19:12:20.723589Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/minimessagebridge","_minecraft_icon_attachment_id":102817,"_minecraft_imported_at":"2026-06-05T21:50:31+00:00","_minecraft_import_hash":"359c68161bf10c70660d9a5c8e0484b7","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,126,127,128,129,123,92],"mod_loader":[130,132,133,134],"minecraft_version":[59,36,60,93,94,101,102],"class_list":["post-102816","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","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"],"yoast_head":"\n
\n “&l”: “
\n “&r”: “
\n enable-cache: true # Enable translation caching
\n debug: false # Debug logging<\/p>\n
\n system-chat: true # Intercept server messages
\n action-bar: true # Intercept action bar
\n“`<\/p>\n
\nlegacy-mappings:
\n “&c”: “
\n “&a”: “
\n “&6”: “
\n“`<\/p>\n
\n– Concurrent data structures for thread safety
\n– Average overhead: <0.1ms per message\n- Memory usage: ~10MB for 5000 cached entries\n- Zero impact when processing modern MiniMessage plugins (bypass mode)\n\n\n\n**Support**\n\nGithub\nDiscord\n<\/p>\n","protected":false},"excerpt":{"rendered":"