PCMNF

🛡️ PCMNF (Premium Chat Moderation Notification Filter)

---

✨ Overview

PCMNF is a lightweight, optional addon for the PCM (Premium Chat Moderation) plugin. It utilizes ProtocolLib to seamlessly intercept incoming server packets at the protocol level, allowing server owners to provide their players with an unparalleled level of chat and UI customization.

Tired of players complaining about crate key broadcast spam, server announcements, or intrusive bossbars and titles? PCMNF solves this by allowing players to individually toggle the visibility of specific, server-defined regex strings via the /notification command.

---

🚧 Development & Support

PCMNF is currently in active development! Many more features, flexible layouts, and extended customization options are planned for future updates.

If you need support, want to report an issue, or have a great idea for a new feature you'd like to see added, please join our Discord Server! We would love to hear your feedback and suggestions.

---

🚀 Key Features

• 🚫 Deep Packet Interception: Uses ProtocolLib to intercept and filter packets before they even reach the player's client.
• 📡 Multi-Format Filtering: It doesn't filter standard chat messages! But does scans of:
  • CLIENTBOUND_SYSTEM_CHAT (System messages, Actionbars)
  • SET_TITLE_TEXT (On-screen Titles)
  • SET_SUBTITLE_TEXT (On-screen Subtitles)
  • BOSS_BAR (Bossbar names/titles)
• ⚙️ Fully Regex Powered: Server owners can define incredibly precise, or very broad, regex patterns in the main PCM config.yml to target exactly what they want to allow players to toggle.
• 👤 Per-Player Toggles: Players control their own experience. Filtering an announcement for one player does not affect anyone else.
• 💾 Persistent Storage: Player toggle preferences are saved safely across server restarts natively within PCM's backend ecosystem.

---

🛠️ Commands (via PCM)

PCMNF integrates directly into PCM's command structure, meaning there are no new command aliases to learn.

Command	Description	Permission
/notification	📋 Lists all available notification channels you can toggle and their current status.	None (Default)
/notification <channel> [true/false]	🔕 Toggle visibility of a specific broadcast channel entirely for yourself.	None (Default)

---

⚙️ Configuration Example (in PCM's config.yml)

notification-filter:
  enabled: true
  channels:
    crate_announcements:
      pattern: "(?i).*crate.*"
      default-enabled: true # Players see this by default until they toggle it off
    server_broadcasts:
      pattern: "(?i).*broadcast.*"
      default-enabled: true

---

📥 Installation & Requirements

Because PCMNF intercepts raw Minecraft packets, it requires both the core PCM plugin and ProtocolLib to function.

1. Download Dependencies:
   • ProtocolLib (Required for packet manipulation)
   • PCM (The core plugin)
2. Download PCMNF: Get the PCMNF-X.X.jar.
3. Install: Place ProtocolLib.jar, PCM-X.X.jar, and PCMNF-X.X.jar into your server's plugins folder.
4. Restart: Restart your server.
5. Enable: Open PCM's config.yml, locate the notification-filter section, and set enabled: true. Follow the regex guide in the config to define your custom channels!

---

💎 Credits

• 👨‍💻 Development: Obsyron
• 🌐 Core function: ProtocolLib