1.0
release
PCMNF
A addon to the PCM plugin to make the notification filter work
14
PCMNF
🛡️ PCMNF (Premium Chat Moderation Notification Filter)
---
✨ Overview
PCM (Premium Chat Moderation) 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
* 🚫 Persistent Storage: Uses ProtocolLib to intercept and filter packets *before* they even reach the player's client. * 📡 Persistent Storage: 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) * ⚙️ Persistent Storage: 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. * 👤 Persistent Storage: 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)
```yaml 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. Enable: * Enable (Required for packet manipulation) * %%MD1%% (The core plugin) 2. Enable: Get the `PCMNF-X.X.jar`. 3. Enable: Place `ProtocolLib.jar`, `PCM-X.X.jar`, and `PCMNF-X.X.jar` into your server's `plugins` folder. 4. Enable: 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
* 👨💻 Core function: Core function * 🌐 Core function: %%MD1%%