SparkWord works by automatically monitoring chat, commands, books, signs, and player input to detect spam, abuse, or banned content in real time. It offers advanced word filtering, anti-spam protection, moderation tools, logs, and player mutes.

# 🔵 **REQUERIMENTS** - Java-21 - Paper/Purpur-1.21.x --- # 🔵 **FEATURES** - Configurable word blocking and filtering via external text-based dictionaries with hot-reload support. - Built-in persistence layer using SQLite by default, with optional MySQL or MariaDB backends for scalable environments. - Advanced anti-spam system covering IP-based checks, domain detection, message flooding, excessive capitalization, numeric abuse, character repetition, and repeated word patterns. - Injection prevention layer designed to mitigate malformed or malicious input affecting vulnerable plugins. - Detection and sanitization of dangerous Unicode sequences, including Zalgo and invisible character abuse. - Content limitations and validation applied to writable books to prevent exploits and abuse. - Command input writing limits to reduce spam, injection vectors, and abuse through command execution. - Automated mute mechanisms triggered by configurable violation thresholds across multiple detection systems. - Comprehensive moderation logs tracking mutes, warnings, and staff command usage for auditing purposes. - Suggestion and correction system to guide players toward acceptable message formats. - Preventive staff notifications with contextual information before escalation actions occur. - Unified filtering and anti-spam enforcement across chat, signs, anvils, books, and other player-input sources. --- # 🔵 **USAGE** - **Word Filtering:** The plugin does not rely on traditional regex-based filtering, which was intentionally avoided due to performance issues and server lag. Instead, it uses an Aho–Corasick pattern-matching engine optimized for high-throughput text analysis. Filtering is driven by plain-text wordlists categorized by purpose (Normal, Strong, WriteCommand), each providing a distinct level of enforcement. - Normal: Performs partial word blocking, matching standalone or contextual terms (e.g., blocking "cat" without affecting "category" or "education"). - Strong: Applies aggressive matching, blocking terms regardless of whether they appear as substrings within larger words. - WriteCommand: Designed to prevent the use of administrator or staff names within writable commands such as /rename, /tag, /nickname, and similar features. - **Anti-Spam:** This module is fully configurable via moderation.yml, allowing fine-grained control over thresholds, cooldowns, and enforcement behavior. - **Suggestions:** The suggestion command `sw-sg` allows players to submit word suggestions, feedback, or staff reports. All entries are stored persistently and can be reviewed using `sw list sg`. By default, suggestion logs are automatically purged every 3 days; this interval is configurable via `config.yml` under `suggestion.purge-hours`. - **commands.yml:** Provides centralized control for redefining or aliasing moderation commands exposed to helpers or regular users, enabling permission-based command abstraction. - **Notifications:** Staff notifications are delivered using hover-based messages to minimize chat clutter and maintain readability on high-population servers. ---

Commands

Permissions

``````bash # Player permissions sparkword.suggest # Allows the use of the 'sw-sg' command or any of its aliases to submit suggestions, reports, or staff requests; enabled by default for all players. # Administrative permissions sparkword.reload # Grants access to the 'sw reload' command to hot-reload configurations and internal modules. sparkword.add # Allows execution of 'sw add ' to regist er terms into filtering lists. sparkword.remove # Allows execution of 'sw remove ' to remove previously registered terms. sparkword.notify.icon # Enables visualization of censored messages using hover components attached to the original message. sparkword.debug # Grants access to the 'sw debug' command or alias to enable debugging mode and trace events in the console. # Moderation permissions sparkword.info # Allows access to the 'sw info ' command to view internal documentation and command usage. sparkword.list # Enables the 'sw list ' command to inspect word lists, suggestions, or active configurations. sparkword.accept # Allows accepting suggestions using 'sw accept ' and merging them into the target list. sparkword.deny # Allows rejecting suggestions via 'sw deny '. sparkword.mute # Authorizes the use of the 'sw-mute ' command or alias to apply a permanent chat mute. sparkword.permute # Authorizes the use of the 'sw-permute ' command or alias to apply a permanent global mute across all writable inputs. sparkword.unmute # Allows removing an active mute using 'sw-unmute '. sparkword.tempmute # Allows applying temporary mutes via 'sw-tempmute '. sparkword.checkmute # Allows checking a player's current mute status using 'sw-checkmute '. sparkword.scan # Allows inspecting a player's accumulated mutes and warnings using 'sw-scan '. sparkword.warn # Authorizes the use of the 'sw-warn ' command or alias to issue formal warnings. sparkword.notify # Allows staff to receive real-time notifications of player violations via chat. sparkword.audit # Allows querying staff action audits using 'sw audit '. sparkword.logs # Enables access to 'sw logs ' to review moderation and enforcement records. # Purge permissions sparkword.purge.logs # Allows full deletion of moderation logs. sparkword.purge.suggest # Allows full deletion of stored suggestions. sparkword.purge.warning # Allows deletion of all recorded warnings. sparkword.purge.mute # Allows deletion of all applied mutes. sparkword.purge.audit # Allows deletion of all staff audit records. # Bypass permissions sparkword.bypass.chat # Allows bypassing content filters applied to chat. sparkword.bypass.sign # Allows bypassing content filters applied to signs. sparkword.bypass.books # Allows bypassing content filters applied to writable books. sparkword.bypass.anvils # Allows bypassing content filters applied to anvils. sparkword.bypass.spam # Allows bypassing anti-flood, anti-repeat, anti-caps, digit limits, and character spam checks. sparkword.bypass.writecommands # Allows bypassing filters associated with the WriteCommand list. sparkword.bypass.injection # Allows bypassing the injection prevention system. sparkword.bypass.symbol.all # Allows unrestricted usage of dangerous Unicode symbols, including Zalgo and invisible characters. sparkword.bypass.ip # Allows bypassing IP and domain filtering. sparkword.bypass.ip.split # Allows bypassing IP-split detection. sparkword.bypass.cooldown # Allows bypassing the suggestion system cooldown. ``````

SparkWord

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details