🎮 GuildChat Shortener

Fabric mod to shorten and customize Discord bridge and Normal messages in Hypixel guilds

Proudly made in France

English | Français

---

📖 Description

GuildChat Shortener is a Fabric client-side mod that transforms long Discord bridge messages and regular guild messages in your Hypixel guild into short and elegant messages. No more cluttered chat - customize the display with colors and aliases to your liking!

✨ Key Features

• 🤖 Automatic Detection - The mod automatically detects Discord bridge messages
• 🌍 Multilingual Support - Full support for English and French languages
• 🎨 Color Customization - Change the colors of the bridge alias and player names
• 🏷️ Custom Aliases - Replace the bot name with a short alias (e.g., "Discord", "Bridge", "DC")
• ⚙️ Flexible Configuration - Intuitive in-game commands to adjust settings
• 🔄 Smart Detection - Automatically recognizes Discord bridge messages
• 💾 Automatic Saving - Your configuration persists between sessions
• 🌐 Global Mode - Enable formatting for all guild messages
• 🆕 Update Checker - Automatic version detection and manual update check with /bridge update
• 🎲 Random Colors - Optional random color assignment for Discord player names

---

📥 Installation

Requirements:

• Minecraft 1.21+
• Fabric Loader 0.18.0+
• Fabric API (required)
• ModMenu (optional - for graphical config)
• Cloth Config (optional - for graphical config)

Setup:

1. Download from Releases
2. Place in your mods/ folder
3. Launch Minecraft with Fabric profile

---

🎯 Usage

The mod automatically detects Discord bridge messages! Configuration is optional but can be customized with commands or ModMenu. You can also change the settings from ModMenu (Cloth Config required for the config screen).

⚙️ ModMenu Config: Open Mods → GuildChat Shortener → Config (requires Cloth Config).

Essential Commands

/bridge help              # Show help
/bridge update            # Check for mod updates
/bridgename <alias>       # Change alias (ex: /bridgename DC)
/bridgecolor <color>      # Change alias color (ex: /bridgecolor red)
/bridgeplayercolor <color> # Change player name color
/bridgelanguage <lang>    # Change language (english/french)
/bridge random            # Toggle random colors for Discord names

Examples:

/bridgename Bridge        # Set alias to "Bridge"
/bridgecolor yellow       # Make alias yellow
/bridgelanguage french    # Switch to French
/bridge update            # Check for updates manually
/bridge random on         # Enable random colors

---

🎨 Available Colors

Use color names in commands: black, dark_blue, dark_green, dark_aqua, dark_red, dark_purple, gold, gray, dark_gray, blue, green, aqua, red, light_purple, yellow, white

Examples: /bc red, /bpc green, /bridgecolor aqua

---

🛠️ Development

Build the project

gradlew.bat build

The compiled JAR file can be found in build/libs/GuildChatShortener-1.0.0.jar.

Project Structure

src/main/
├── java/com/guildchat/formatter/
│   ├── GuildChatMod.java          # Main entry point
│   ├── BridgeConfig.java          # Configuration management
│   └── mixin/
│       └── ChatHudMixin.java      # Injection to format messages
└── resources/
    ├── fabric.mod.json            # Mod metadata
    └── guildchat-formatter.mixins.json

---

📝 Changelog

See CHANGELOG.md for version history.

---

🤝 Contributing

Contributions are welcome! Feel free to:

• 🐛 Report bugs
• 💡 Suggest new features
• 🔧 Submit pull requests

---

📜 License

This project is licensed under the MIT License. See the LICENSE file for details.

---

👤 Author

Developed with ❤️ by Tjiba (MeteoFrance in-game)

---

⭐ If this mod is useful to you, feel free to give it a star!

Download • Report a Bug • Request a Feature