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 announcements” system inside Forge.

⏱️ Scheduling highlights

• Uses server clock scheduling
• Supports 1S, 30M, 1H, and combos like 1H30M15S
• Minimum interval: 1S
• Offset behavior helps reduce synchronized spam bursts

📝 Text Announcements

• /textannouncement add <id> <interval> <toggle|notoggle> "<message>" <target>
  • Fires immediately, then repeats
• /textannouncement ontime "<message>" [target]
• /textannouncement modify <id> <interval> <toggle|notoggle> "<message>" <target>
• /textannouncement remove <id>
• /textannouncement list [page]

✅ Multi-line support with <br>

⚙️ Command Announcements

• /commandannouncement add <id> <interval> <command>
• /commandannouncement remove <id>
• /commandannouncement list [page]

🏷️ Title Announcements

• /titleannouncement <targets> "<title>" ["<subtitle>"]

👤 Player preferences

• /toggle to list toggleable announcements
• /toggle <id> to enable/disable per-player

Permission controls:

• Manage announcements: bfcrrmod.announcements.manage
• Toggle announcements: bfcrrmod.announcements.toggle
• Bypass toggles: bfcrrmod.announcements.bypass
• Use title announcements: bfcrrmod.announcements.title

---

🧼 6) Word Filter System (replace/remove phrases)

Server-side filtering for moderation and quality control.

Commands

• /bfcrr filter add <id> <yes|no> "<word>" [replacement]
• /bfcrr filter remove <id>
• /bfcrr filter list [page]

✅ Use it for:

• profanity filters
• anti-spam phrases
• auto-replacements

Permissions:

• Manage: bfcrrmod.filter.manage
• Bypass: bfcrrmod.filter.bypass

---

🧑‍⚖️ 7) HelpOp (Player → Staff pipeline)

A clean “request help” workflow like you’d expect from plugins.

Commands

• /helpop <message>
• /helpopop <player> <message> (anonymous staff reply)

✅ Features:

• Click-to-reply for staff
• 🔊 configurable sounds (enableHelpOpSound)
• Staff recipients: OP Level 2+ or bfcrrmod.helpop.receive

---

🔐 8) Admin Chat (Private Staff Channel)

A private channel that stays private.

Commands

• /chat admin (toggle)
• /ac <message> (send once)

✅ Features:

• Keeps staff coordination out of public chat
• Designed to prevent “message leaking” behavior (especially important with Discord relays)

Permissions:

• Use: bfcrrmod.adminchat.use
• See: bfcrrmod.adminchat.see

---

📌 9) Op Bulletin (Operator Notes Board)

A lightweight in-game staff bulletin board.

Commands

• /opbulletin [page]
• /opbulletin add <text>
• /opbulletin remove <id>

✅ Features:

• Pagination (5 items per page)
• Click navigation + click to remove
• Formatting support

---

🚫 10) Banned Items System (auto-enforced item rules)

This is a server utility system that behaves like a plugin ban-list, but inside Forge.

Commands

• /banned [page] (everyone can view)
• /banned add <description> (ban held item)
• /banned remove <item_id>
• /banned clear
• /banned scan
• /banned scantime [set <ticks>]
• /banned scantimeblocks [set <ticks>]

✅ Enforcement:

• Scans player inventories at intervals
• Scans containers + cursor items
• Scans armor/offhand slots
• Scans Curios slots if installed
• Prevents placing banned blocks
• Optional placed-block scanning + removal:
  • enableBannedBlockScanning
  • bannedBlockScanRadius
  • bannedBlockScanInterval

---

🧾 11) MOTD System (Server List MOTD management)

Edit and manage server MOTDs directly in-game (plugin-style workflow).

Commands

• /bfcrr motd list [page]
• /bfcrr motd add <text>
• /bfcrr motd set <index> <text>
• /bfcrr motd remove <index>
• /bfcrr motd activate <index>
• /bfcrr motd apply
• /bfcrr motd preview <index>
• /bfcrr motd clear

✅ Supports:

• & color codes
• <br> line breaks
• Auto-apply on startup: applyMotdOnStartup

---

🗂️ Data Storage / Files

Server-wide config

config/bfcrr/

• common.toml
• motd.json

Per-world data

<world>/serverconfig/bfcrr/

• announcements.json
• announcement_prefs.json
• filters.json
• banned_items.json
• banned_config.json
• bulletin.json

Logs

logs/chat/

• chat_<timestamp>.log

---

✅ Commands (Quick Index)

• /bfcrr info|colors|test|reload
• /colors
• /msg, /r, /ans
• /helpop, /helpopop
• /chat admin, /ac
• /opbulletin
• /banned ...
• /bfcrr motd ...
• /textannouncement ...
• /commandannouncement ...
• /titleannouncement ...
• /toggle
• /bfcrr filter ...

---

🧪 Notes / Compatibility

• ✅ Built for Forge servers (works on client too, but features are server-focused)
• ⚠️ Other chat-overhaul mods may conflict (common for chat pipeline mods)
• ✅ Avoids hybrid server complexity: Forge utilities without Bukkit/Spigot stacks

---

© 2022-2026 EnVy