# \ud83d\udc51 PCM (Premium Chat Moderation Plugin)<\/p>\n
\n
\n<\/p>\n
—<\/p>\n
### \u2728 Overview
\nThe **ultimate** chat moderation solution for Minecraft servers. This premium plugin combines **ultra-fast** profanity detection with a robust punishment system, offering dual-API support, database storage, and automated moderation actions.<\/p>\n
—<\/p>\n
## \ud83d\udea7 Development & Support<\/p>\n
**PCM is currently in active development!** Many more features, flexible layouts, and extended customization options are planned for future updates.<\/p>\n
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.<\/p>\n
—<\/p>\n
## \ud83d\ude80 Speed & Performance<\/p>\n
* \ud83d\udeab **No AI Implementation**: We prioritize raw speed. This plugin does **not** rely on slow AI models.
\n* \u26a1 **Instant Processing**: Messages are checked and filtered in milliseconds.
\n* \ud83c\udf0d **Dual API Support**: Powered by **ProfanityAPI v2** (Main) and **v1** (Fallback) for 99.9% uptime and extreme accuracy.<\/p>\n
—<\/p>\n
## \ud83c\udf1f Features<\/p>\n
* \ud83d\udee1\ufe0f **Dual Moderation Modes**:
\n * **BLOCK**: Completely prevents the message from being sent if it contains profanity.
\n * **CENSOR**: (Requires v2) Replaces profane words with `****` while keeping the rest of the message intact.
\n* \ufffd **Native V1\/V2 Support**: Built to use ProfanityAPI V2 for lightning-fast parsing, seamlessly falling back to V1 if V2 goes offline.
\n* \ud83c\udfce\ufe0f **Ultra-Fast Caching System**: Temporarily caches API responses to prevent server lag and reduce network load on recurring spam.
\n* \ufffd\ud83d\udcca **Intelligent Scoring System**:
\n * Assigns a “profanity score” (0.0 – 1.0) to players based on their behavior.
\n * Scores accumulate over time, triggering stricter punishments for repeat offenders at custom thresholds (e.g., 10=Mute 1h, 50=Ban 7d).
\n* \ud83d\udcc9 **Decay System**: Slowly reduces player scores over time to allow for redemption.
\n* \u2696\ufe0f **Auto-Punishments**:
\n * \ud83d\udd07 **Mute**: Temporarily silence toxicity with custom durations.
\n * \ud83d\udeab **Ban**: Automatically ban players who exceed safety thresholds.
\n* \ud83d\udd14 **Admin Alerts**: Real-time notifications for staff via Chat or Actionbar when a player’s message flags the API.
\n* \ud83d\udcbe **Database Support**: SQLite storage ensures player data (scores, punishments, infractions) is saved permanently.
\n* \ud83d\udd75\ufe0f **Social Spy**: Monitor private messages between players (`\/msg`, `\/r`, `\/w`, etc.) in real-time, with self-spy support to test formats.
\n* \ud83d\udce3 **Broadcast & Announcements**: Create rotating text announcements or execute console commands automatically on an interval (Random or Sequential).
\n* \ud83d\udcac **Discord Webhooks**: Log flagged chat messages, specific command usages (`\/op`, `\/stop`), and receive admin mentions straight in Discord!
\n* \ud83d\udee1\ufe0f **Notification Filters (PCMNF Addon)**: Allows players to individually toggle off annoying plugin broadcasts or titles via regex patterns! Download Here: PCMNF and install ProtocolLib for it to work.
\n* \u26a0\ufe0f **Command & Chat Warnings**: Automatically detect certain words or commands and alert your staff team (both in-game and on Discord).
\n* \ud83d\udee0\ufe0f **Full Command Suite**: Manually punish users, check status, toggle alerts, or manage your personal notifications.<\/p>\n
—<\/p>\n
## Commands<\/p>\n
All commands require `pcm.admin` permission unless otherwise noted.<\/p>\n
| Command | Description | —<\/p>\n ## \ud83d\udd10 Permissions<\/p>\n | Permission | Description | Default | —<\/p>\n ## \u2699\ufe0f Configuration<\/p>\n Full control over every aspect of the plugin via `config.yml`.<\/p>\n “`yaml # Moderation Mode # Profanity API Settings # Cache settings to reduce API calls # Social Spy Settings # Logging # Allow Self-Spy (See your own spy messages?) # Discord Webhooks # Warnings & Discord Logging # Command Warnings # Announcements #- commands: # Notification Filters # Score System # Admin Alert Format # Punishment Thresholds (Accumulated Score -> Action) # Score Decay # Messages # Broadcasts (Visible to players with pcm.admin or pcm.listen) # Admin alert format is in score-system.admin-listen.format<\/p>\n # Punishments # Commands # Listen Toggle # Social Spy # Notification Filter # Database (SQLite) # Update Checker “`<\/p>\n —<\/p>\n ## \ud83d\udce5 Installation<\/p>\n 1. **Download** the `PCM-X.X.jar` file. —<\/p>\n ## \ud83d\udc8e Credits<\/p>\n * \ud83d\udc68\u200d\ud83d\udcbb **Development**: Obsyron The ultimate chat moderation solution for Minecraft servers.<\/p>\n","protected":false},"featured_media":124716,"template":"","meta":{"_minecraft_slug":"premiumchatmoderator","_minecraft_project_id":"uK69wmhs","_minecraft_author":"obsyrixx","_minecraft_license":"MIT","_minecraft_downloads":40,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"premiumchatmoderator.zip","_minecraft_size_bytes":13107403,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T21:34:17.084983Z","_minecraft_date_created":"2026-02-15T06:41:28.435532Z","_minecraft_date_modified":"2026-02-20T00:03:03.585202Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/premiumchatmoderator","_minecraft_icon_attachment_id":124716,"_minecraft_imported_at":"2026-06-07T07:55:14+00:00","_minecraft_import_hash":"76e72ebb23f84cfb6dc415ce9e0acaca","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,867,92],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-124715","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_category-social","mod_category-utility","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n| :— | :— |
\n| `\/pcm reload` | \ud83d\udd04 Reloads all configuration files and database connections. |
\n| `\/pcm mute
\n| `\/pcm unmute
\n| `\/pcm ban
\n| `\/pcm unban
\n| `\/pcm tempban
\n| `\/pcm status` | \ud83d\udce1 Displays plugin version, API health, and system status across all modules. |
\n| `\/pcm listen` | \ud83d\udc42 Toggles admin alerts for the executor (Requires `pcm.listen`). |
\n| `\/pcm spy` | \ud83d\udd75\ufe0f Toggles social spy for private messages (Requires `pcm.socialspy`). |
\n| `\/pcm warnings` | \u26a0\ufe0f Toggles in-game command warnings for the executor (Requires `pcm.warnings`). |
\n| `\/notification
\n| `\/notification` | \ud83d\udccb List all available notification channels and their current status |<\/p>\n
\n| :— | :— | :— |
\n| `pcm.admin` | \ud83d\udd11 Access to all administration commands including reload, ban, mute, etc. | OP |
\n| `pcm.bypass` | \ud83d\uded1 Bypasses all chat moderation filters and score accumulation | False |
\n| `pcm.listen` | \ud83d\udce2 Allows receiving profanity score alerts | OP |
\n| `pcm.socialspy` | \ud83d\udd75\ufe0f Allows using social spy and receiving spy messages | OP |
\n| `pcm.warnings` | \u26a0\ufe0f Allows receiving in-game command warnings | OP |<\/p>\n
\n# PCM Configuration<\/p>\n
\n# Options:
\n# BLOCK – Cancel the message entirely.
\n# CENSOR – Replace the message with the cleaned version (only works with v2 API).
\n# If v1 fallback is used in CENSOR mode, it will block or use a placeholder depending on availability.
\nmoderation-mode: CENSOR<\/p>\n
\nprofanity-api:
\n # Enable\/Disable the Profanity Filter entirely
\n enabled: true
\n v2-url: “https:\/\/profanity-api.xeven.workers.dev”
\n v1-url: “https:\/\/vector.profanity.dev”
\n timeout-seconds: 5<\/p>\n
\n cache:
\n enabled: true
\n duration-minutes: 10<\/p>\n
\nsocial-spy:
\n enabled: true
\n format: “&8[&cSpy&8] &7%player% &8-> &7%target%: &f%message%”
\n commands:
\n – msg
\n – tell
\n – r
\n – reply
\n – w
\n – whisper<\/p>\n
\n logging:
\n enabled: true<\/p>\n
\n allow-self-spy: true<\/p>\n
\ndiscord-webhooks:
\n enabled: true
\n url: “ReplaceWithWebhookUrl”
\n username: “PCM”
\n avatar-url: “https:\/\/cdn-icons-png.flaticon.com\/512\/4712\/4712109.png”<\/p>\n
\nwarnings:
\n # Chat Warnings \/ Logging
\n chat:
\n enabled: true
\n log-to-discord: true
\n # Format sent to Discord
\n # Placeholders: %player%, %message%, %discord-ping%
\n discord-format: “%discord-ping% **%player%**: %message%”
\n # Key = Word\/Regex, Value = Discord Role\/User ID to ping (e.g. <@&123456789>) or “” for no ping
\n alerts:
\n “help”: “<@&123456789>”
\n “admin”: “<@123456789>”
\n “badword”: “” <\/p>\n
\n command:
\n enabled: true
\n log-to-discord: true
\n # key: command, value: Role ID to ping (e.g. <@&123456789>) or “” for no ping
\n watched:
\n “\/op”: “<@&123456789>”
\n “\/deop”: “”
\n “\/stop”: “<@&987654321>”
\n “\/reload”: “”
\n # Format sent to admins in-game
\n format: “&8[&cAlert&8] &e%player% &7executed: &f%command%”
\n # Format sent to Discord
\n # Placeholders: %player%, %command%, %discord-ping%
\n discord-format: “%discord-ping% :warning: **COMMAND WARNING** :warning:n**Player:** %player%n**Command:** `%command%`”<\/p>\n
\n# Announcements
\nannouncements:
\n settings:
\n enabled: true
\n interval: 300 # seconds
\n order: SEQUENTIAL # SEQUENTIAL or RANDOM
\n list:
\n # You can specify ‘lines’ (text message) AND\/OR ‘commands’ (executed by console).
\n – lines:
\n – “&8[&bAnnounce&8] &eCheck out our website!”
\n – “&7www.link.com”
\n commands:
\n – “say This is a console command”
\n – “save-all”<\/p>\n
\n # – “weather clear”<\/p>\n
\n# Filter specific system messages\/titles\/bossbars using Regex.
\n# Players can toggle these filters via \/notification
\n# Note: For this feature to work, the optional ‘PCMNF’ (ProtocolLib) addon must be installed.
\n#
\n# REGEX GUIDE:
\n# Regex (Regular Expression) is a pattern used to match text.
\n# – (?i) : Makes the match Case-Insensitive (ignores upper\/lowercase).
\n# – . : Matches ANY single character.
\n# – * : Matches the previous character 0 or more times.
\n# – .* : Matches ANY sequence of characters (e.g. everything).
\n#
\n# EXAMPLES:
\n# 1. Match any message containing “Crate”:
\n# pattern: “(?i).*crate.*”
\n#
\n# 2. Match a specific phrase “Server Restarting”:
\n# pattern: “(?i).*Server Restarting.*”
\n#
\n# 3. Match messages starting with “Alert:”:
\n# pattern: “^Alert:.*”
\n#
\n# 4. Match messages ending with “Won!”:
\n# pattern: “.*Won!$”
\n#
\nnotification-filter:
\n enabled: false
\n # Define channels and their regex patterns
\n channels:
\n crate_announcements:
\n pattern: “(?i).*crate.*”
\n default-enabled: true # Do players see this by default?
\n server_broadcasts:
\n pattern: “(?i).*broadcast.*”
\n default-enabled: true<\/p>\n
\n# Scores are accumulated 0.0 – 1.0 (probability of profanity).
\n# When a player reaches a score threshold, punishments are applied.
\n# Scores are stored in scores.yml.
\nscore-system:
\n enabled: true
\n min-score-to-flag: 0.9<\/p>\n
\n # %score% displays the TOTAL ACCUMULATED SCORE of the player.
\n admin-listen:
\n type: CHAT # CHAT or ACTIONBAR
\n format: “&c%player% &7score: &e%score% &8(&f%message%&8)”<\/p>\n
\n # Format: “SCORE: COMMAND”
\n # Use underscore notation (10_0 = 10.0) to avoid YAML path parsing issues.
\n thresholds:
\n “10_0”: “pcm mute %player% 1h Auto-Mute: Too much profanity”
\n “20_0”: “pcm mute %player% 24h Auto-Mute: Persistent profanity”
\n “50_0”: “pcm ban %player% 7d Auto-Ban: Excessive profanity”
\n “100_0”: “pcm ban %player% perm Auto-Ban: Permanent”<\/p>\n
\n # Automatically reduce player scores over time to allow redemption.
\n decay:
\n enabled: true
\n # How much score to remove per interval?
\n amount: 1.0
\n # How often to apply decay? (in hours)
\n # Checks are made when player joins.
\n interval-hours: 24<\/p>\n
\nmessages:
\n prefix: “&8[&bPCM&8] ”
\n blocked: “&cYour message contains profanity and was blocked.”
\n censored-notification: “&cYour message was censored.”<\/p>\n
\n mute-broadcast: “&8[&cPCM&8] &e%player% &7was muted by &e%punisher% &7for &e%duration%&7. Reason: &f%reason%”
\n ban-broadcast: “&8[&cPCM&8] &e%player% &7was banned by &e%punisher% &7for &e%duration%&7. Reason: &f%reason%”<\/p>\n
\n mute-reason: “&cYou are muted for %duration%. Reason: %reason%”
\n muted-error: “&cYou are muted! Expires in: %time%”
\n ban-message: “&cYou have been banned!n&7Reason: &f%reason%n&7Expires: &f%time%”<\/p>\n
\n no-permission: “&cNo permission.”
\n command-usage: “&cUsage: \/pcm
\n reload-success: “&aConfiguration reloaded.”
\n player-not-found: “&cPlayer not found.”
\n invalid-duration: “&cInvalid duration. Use ‘perm’ or time like 10m, 1h, 1d etc.”
\n cannot-mute-op: “&cYou cannot mute an Operator.”
\n cannot-mute-bypass: “&cYou cannot mute a player with bypass permissions.”
\n cannot-ban-op: “&cYou cannot ban an Operator.”
\n cannot-ban-bypass: “&cYou cannot ban a player with bypass permissions.”
\n mute-success: “&aMuted %player% for %duration%.”
\n unmute-success: “&aUnmuted %player%.”
\n ban-success: “&aBanned %player% for %duration%.”
\n unban-success: “&aUnbanned %player%.”<\/p>\n
\n listen-enabled: “&aYou are now listening to chat moderation alerts.”
\n listen-disabled: “&cYou are no longer listening to chat moderation alerts.”
\n listen-only-players: “&cThis command is only for players.”<\/p>\n
\n socialspy-enabled: “&aSocial Spy enabled.”
\n socialspy-disabled: “&cSocial Spy disabled.”
\n socialspy-only-players: “&cThis command is only for players.”<\/p>\n
\n notification-usage: “&cUsage: \/notification
\n notification-unknown-channel: “&cUnknown notification channel: &e%channel%”
\n notification-enabled: “&7Notification channel &e%channel% &7is now &aenabled&7.”
\n notification-disabled: “&7Notification channel &e%channel% &7is now &cdisabled&7.”
\n notification-list-header: “&8&m—&r &bNotification Filters &8&m—”
\n notification-list-item: “&e%channel%&8: %status%”
\n notification-list-footer: “&7Toggle with: \/notification
\n notification-no-filters: “&cNo filters configured.”
\n notification-on: “&aON”
\n notification-off: “&cOFF”<\/p>\n
\ndatabase:
\n filename: “database.db”<\/p>\n
\nupdate-checker: true<\/p>\n
\n2. **Upload** it to your server’s `plugins` folder.
\n3. **Restart** your server to generate the configuration files.
\n4. **Edit** `plugins\/PremiumPCM\/config.yml` to configure it how you would like it.
\n5. Type `\/pcm reload` or restart your server to apply changes.<\/p>\n
\n* \ud83c\udf10 **Core API**: ProfanityAPI
\n* \ud83d\ude80 **Advanced API**: ProfanityAPI V2<\/p>\n","protected":false},"excerpt":{"rendered":"