BL Improved Private Messages

A modern, Discord-style private messaging interface for Minecraft multiplayer — fully client-side, no server plugin required.

---

💬 What Is This?

Tired of squinting at /msg PlayerName hello buried in your chat box? BL Improved Private Messages transforms Minecraft's clunky whisper system into a clean, app-like messaging experience. Open a dedicated DM window, browse your conversations, and send messages — all without typing a single command. Under the hood, the mod still uses vanilla /msg, so it works on virtually any server.

---

✨ Features

• Discord-style UI — Conversations displayed with player avatars, sender names, timestamps, and proper message grouping, just like a real messaging app
• 3-Tab Sidebar — Instantly filter contacts by Online, Friends, and Offline
• Player Head Avatars — Real skin textures pulled from the server tab-list or Mojang, with a fallback initial for unloaded skins
• Online/Offline Indicators — A green or grey dot on every avatar so you always know who's around
• Star System — Star any contact to pin them to the top of their tab
• Friend List — Client-side friend tagging with a ♥ indicator; friends get their own dedicated tab
• Right-Click Context Menu — Star, friend, or delete any conversation with a right-click
• Unread Badges — Red notification dots on conversations and per-tab counts so nothing slips through
• Message History — Up to 500 messages per conversation saved locally and persisted across sessions
• Per-Server Storage — Conversations, friends, and settings are fully isolated per server address
• Word Wrap — Long messages wrap cleanly at word boundaries; hard-breaks only when no space is available
• Enter to Send — Hit Enter in the message box to send instantly
• Mouse Wheel Scrolling — Smooth scroll through message history
• Search — Filter your conversation list in real time

---

🕹️ How To Use

1. Join any multiplayer server
2. Press M to open the Messages screen (rebindable in Controls)
3. Click + New Chat, type a player name, and press Go or Enter
4. Type your message and hit Send or Enter
5. Incoming whispers are automatically captured and appear in the correct conversation

Note: The player must be online when starting a new conversation. Messages you receive while the GUI is closed are still captured and show up with an unread badge when you open it.

---

⚙️ Technical Details

• 100% client-side — No server plugin, mod, or configuration needed on the server
• Works on cracked and online-mode servers alike
• Uses Fabric's ClientReceiveMessageEvents API to intercept whispers — no brittle mixins on chat internals
• Whispers are detected by pattern matching against common server whisper formats (vanilla, Essentials, CMI, etc.)
• Message data stored as JSON under .minecraft/blipm/<server_address>/
• Skin textures fetched from the live tab-list first (instant), then from Mojang asynchronously as a fallback

---

🗺️ Roadmap

• [     ] Notification sound on incoming whisper
• [✔️] Support for more MC versions

---

Made by BattryLeaf — because vanilla chat deserved better.

Credits <3

• BattryLeaf [me, Mod Developer]
• Humanthecub [Play Testers]
• PTATA_77 [Play Testers]
• New_Shard [Play Testers]
• Claude.ai [help with code and description]

---