Better Forge Chat Reforged Reworked

# 💬 Better Forge Chat Reborn Reworked (BFCRR) — **Plugin‑Like Server Management for Forge** A **server-side Forge mod** for **Minecraft 1.20.1** that brings a *plugin-style* chat + staff toolkit to your Forge server — **without** running hybrid servers (no Bukkit/Magma/Arclight/dual-stack required). ✅ **Forge:** 1.20.1 (Forge) ✅ **Mod Version:** 1.0 ✅ **Mod ID:** `bfcrrmod` ✅ **Main Command:** `/bfcrr` --- ## ⭐ Why BFCRR? (The pitch) If you want the **utility and admin power** of plugins — announcements, filters, staff chat, help request pipelines, item enforcement, MOTD tools — but you run a **Forge** server and don’t want to deal with hybrid server stacks… this is for you. BFCRR is a **fully configurable server utility suite** centered around chat, identity, moderation and staff workflow: - 🎨 **Full chat formatting pipeline**: timestamps, player name formatting, configurable message formats - 🌈 **HEX colors + gradients** support (permission controlled) for modern looking chat - 🧩 **LuckPerms** prefixes/suffixes + **FTB Essentials** nicknames integration (optional) - 💌 **Private messaging** with `/msg` + `/r` + **toggle private chat mode** - 🧷 **Click-to-reply** to any message with `/ans` + **chat logging** - 📣 **Announcements engine**: text announcements, command announcements, and title announcements - 🧼 **Word filter**: replace or remove words/phrases - 🧑‍⚖️ **HelpOp** (player → staff) + 🔐 **Admin Chat** (private staff channel) - 📌 **Op Bulletin** (operator notes board) - 🚫 **Banned Items enforcement** (auto scanning/removal + block placement prevention) - 🧾 **MOTD system** (edit/activate/preview/apply from in-game) --- # 🌈 HEX Colors (Emphasis: YES) BFCRR supports: - 🎨 Classic `&` color codes - ✨ **HEX colors** via `&#RRGGBB` (example: `&#FF5500Hello World`) - 🌈 **Gradients** (when enabled via permissions) ### 🔐 Permission‑based control (server friendly) You can control who can use: - Basic colors: `bfcrrmod.chat.colors` - Styles: `bfcrrmod.chat.styles` - Markdown styling: `bfcrrmod.chat.styles.md` - ✨ **HEX + gradients**: `bfcrrmod.chat.colors.hex` - Individual `&` colors: `bfcrrmod.chat.colors.0-f` This means you can give: - ✅ Regular players: limited colors - ✅ Donors: more colors + styles - ✅ Staff: full HEX/gradient privileges --- # 🧩 Optional Integrations These are optional. BFCRR works without them, but becomes even stronger with them. ## 🏷️ LuckPerms - Prefixes/suffixes shown in chat + (optional) tab list - Plays perfectly with permission-based formatting policies ## 🧑‍🎤 FTB Essentials - Nickname integration support --- # ⚙️ Configuration (quick but useful) Main config: `config/bfcrrmod-common.toml` ### 🧱 Core formatting keys - `playerNameFormat` (default: `$prefix$name$suffix`) - `chatMessageFormat` (default: `$time | $name: $msg`) - `chatMessageColor` - `timestampFormat` - `metaJoinSeparator` ### 🧩 Module toggles (turn systems on/off) - `enableAnnouncements` - `enableFilterSystem` - `enableMessagingSystem` - `enableChatReplies` + `replySummaryLength` - `enableHelpOp` - `enableAdminChat` - `enableBannedItems` - `enableMotdSystem` + `applyMotdOnStartup` --- # 🧠 Systems & Utilities (Detailed) ## 🎨 1) Chat Formatting + Timestamps + Markdown Make chat look professional and consistent. ✅ Features: - 🕒 Timestamps (`enableTimestamp`, `timestampFormat`) - 🎨 Color/style formatting (`&` codes) - ✍️ Markdown formatting (`markdownEnabled`) - 🧩 Placeholders everywhere **Message example format (default idea):** - `"$time | $name: $msg"` --- ## 🧍 2) Identity: Prefix/Suffix + Nicknames + Tab List BFCRR builds a “player identity layer” (like plugins do): - 🏷️ Prefixes/suffixes (LuckPerms metadata) - 🧑‍🎤 Nicknames (FTB Essentials, or integrated nicknames if enabled) - 📋 Tab list metadata + nicknames (config toggles) --- ## 💌 3) Private Messaging System (Plugin‑style DMs) ### Commands - `/msg <player> <message>` (aliases: `/m`, `/tell`, `/w`, `/pm`) - `/r <message>` ### 🔁 Toggle DM Mode (super useful for staff & trading) - `/msg <player>` → all your chat goes ONLY to that player - `/msg` or `/r` (no args) → exit DM mode, back to public chat ✅ Extras: - 🖱️ Click messages to quick-reply - 🧲 Hover text configurable (`clickToMessageHover`) - 🔊 Sound notification (`enableMsgSound`) --- ## 🧷 4) Click‑to‑Reply System (`/ans`) + Chat Logs A plugin-like “reply to that exact message” workflow. ### Command - `/ans <messageId> <message>` ### How it works 1. Chat lines (and announcements) become clickable 2. Hover shows “click to reply” (configurable: `clickToReplyHover`) 3. Clicking auto-fills `/ans <id>` for you 4. Type reply and send ### 🗃️ Logging - Saved to: `logs/chat/chat_YYYY-MM-DD_HH-mm-ss.log` - Great for moderation and context tracking ### 🔔 Sound notifications - Reply sound toggle: `enableReplySound` - Permission for notification: `bfcrrmod.ans.notify` --- ## 📣 5) Announcement Engine (Text + Commands + Titles) This is a full “plugin