SparkWord 通过自动监控聊天、命令、书籍、告示牌和玩家输入,实时检测垃圾信息、滥用行为或违禁内容。它提供高级词过滤、反垃圾保护、管理工具、日志记录和玩家静音功能。
? REQUIREMENTS(要求)
- Java-21
- Paper/Purpur-1.21.x
? FEATURES(特性)
- 支持通过外部基于文本的词典配置单词屏蔽与过滤,并支持热重载。
- 内置持久化层,默认使用 SQLite,可选 MySQL 或 MariaDB 后端以支持可扩展环境。
- 高级反垃圾系统,涵盖基于 IP 的检查、域名检测、消息洪水、过度大写、数字滥用、字符重复及重复单词模式。
- 注入防护层,旨在减轻格式错误或恶意输入对易受攻击插件的影响。
- 检测并清理危险的 Unicode 序列,包括 Zalgo 文字和不可见字符滥用。
- 对可书写书籍应用内容限制与验证,以防止漏洞利用和滥用。
- 限制命令输入写入量,以减少通过命令执行产生的垃圾信息、注入向量和滥用行为。
- 自动化静音机制:当违反多个检测系统的阈值时,触发可配置的静音操作。
- 全面的管理日志,记录静音、警告及员工命令使用情况,用于审计目的。
- 建议与纠正系统,引导玩家采用可接受的消息格式。
- 预防性员工通知:在采取升级行动前,提供上下文信息。
- 统一在所有玩家输入源(如聊天、告示牌、铁砧、书籍等)上实施过滤和反垃圾策略。
? USAGE(用法)
- 单词过滤: 该插件不依赖传统的基于正则表达式的过滤(为避免性能问题和服务器卡顿而有意避免)。相反,它使用针对高吞吐量文本分析优化的 Aho–Corasick 模式匹配引擎。过滤由纯文本词表驱动,按用途分类(Normal、Strong、WriteCommand),每类提供不同级别的执行力度。
- Normal(普通):执行部分单词屏蔽,匹配独立或上下文相关的术语(例如,屏蔽 "cat" 但不影响 "category" 或 "education")。
- Strong(强力):应用激进匹配,无论术语是否作为子串出现在更大的单词中,均予以屏蔽。
- WriteCommand(写命令):旨在防止在 /rename、/tag、/nickname 等可写命令中使用管理员或员工名称。
- 反垃圾: 此模块完全可通过 moderation.yml 进行配置,允许对阈值、冷却时间和执行行为进行精细控制。
- 建议: 建议命令
sw-sg 允许玩家提交单词建议、反馈或员工报告。所有条目均持久存储,可使用 sw list sg 查看。默认情况下,建议日志每 3 天自动清除一次;此间隔可在 config.yml 的 suggestion.purge-hours 下配置。
- commands.yml: 提供集中式控制,用于重新定义或别名化暴露给助手或普通用户的管理命令,实现基于权限的命令抽象。
- 通知: 员工通知使用悬停消息发送,以最小化聊天杂乱并保持高人口服务器的可读性。
Commands
Arguments:
- ID: 每个建议或条目均由唯一 ID 标识。
- Preset: 预定义的警告或管理预设,以便快速应用。
- Word: 要添加、移除或建议的单词。
- List:
- n: Normal 列表
- s: Strong 列表
- wc: WriteCommand 列表
- sg: Suggestions 列表
- Logs:
- all: 所有可用日志
- b: 被屏蔽的单词(仅在过滤模式禁用时可用)
- m: 已应用的静音
- w: 已应用的警告
命令 | 参数 | 权限 | 用法
/sw info | 无 | sparkword.info | 显示可用命令及其基于分配权限的用法。
/sw list | 列表 | sparkword.list | 查看词库或待处理的建议。
/sw accept | ID/列表 | sparkword.accept | 将建议的词添加到目标列表中。
/sw deny | ID/列表 | sparkword.deny | 拒绝或驳回建议的词。
/sw add | 列表/词 | sparkword.add | 向特定的过滤列表中添加词汇。
/sw remove | 列表/词 | sparkword.remove | 从特定的过滤列表中移除词汇。
/sw logs | 日志 | sparkword.logs | 显示由员工或控制台捕获的管理日志。
/sw audit | 员工名称 | sparkword.audit | 显示特定员工或所有员工的命令执行日志。
/sw purge | 日志/建议 | sparkword.purge.* | 手动清理日志或建议列表。
/sw reload | 无 | sparkword.reload | 热重载插件配置。
/sw-debug | 无 | sparkword.debug | 启用调试模式以在控制台中追踪问题。
/sw-mute | 玩家/预设 | sparkword.mute | 对玩家应用永久聊天禁言。
/sw-permute | 玩家/预设 | sparkword.permute | 应用永久全局禁言,阻止所有可写输入(聊天、告示牌、铁砧、书籍及相关命令)。
/sw-tempmute | 玩家/时间/预设 | sparkword.tempmute | 对玩家应用临时禁言。
/sw-unmute | 玩家 | sparkword.unmute | 移除玩家的活跃禁言状态。
/sw-warn | 玩家/预设 | sparkword.warn | 向玩家发出警告。
/sw-scan | 玩家 | sparkword.scan | 检查玩家累积的所有禁言和警告。
/sw-checkmute | 玩家 | sparkword.checkmute | 验证玩家的禁言状态及剩余持续时间。
/sw-sg | 词/原因 | sparkword.suggest | 提交词汇建议、举报或与员工相关的问题。
权限
# 玩家权限
sparkword.suggest # 允许使用 'sw-sg' 命令或其任何别名来提交建议、报告或工作人员请求;默认对所有玩家启用。
# 管理权限
sparkword.reload # 授予访问 'sw reload' 命令的权限,以热重载配置和内部模块。
sparkword.add # 允许执行 'sw add <list> <word>' 将术语注册到过滤列表中。
sparkword.remove # 允许执行 'sw remove <list> <word>' 移除先前注册的术语。
sparkword.notify.icon # 启用使用附加在原消息上的悬停组件来可视化被审查的消息。
sparkword.debug # 授予访问 'sw debug' 命令或其别名的权限,以启用调试模式并在控制台中追踪事件。
# 管理权限
sparkword.info # 允许访问 'sw info <page>' 命令以查看内部文档和命令用法。
sparkword.list # 启用 'sw list <list>' 命令以检查词表、建议或活动配置。
sparkword.accept # 允许使用 'sw accept <ID/Suggest> <list>' 接受建议并将其合并到目标列表中。
sparkword.deny # 允许通过 'sw deny <ID/Suggest>' 拒绝建议。
sparkword.mute # 授权使用 'sw-mute <player> <reason>' 命令或其别名以应用永久聊天静音。
sparkword.permute # 授权使用 'sw-permute <player> <reason>' 命令或其别名以在所有可写入输入中应用永久全局静音。
sparkword.unmute # 允许使用 'sw-unmute <player> <reason>' 移除活动的静音状态。
sparkword.tempmute # 允许通过 'sw-tempmute <player> <time> <reason>' 应用临时静音。
sparkword.checkmute # 允许使用 'sw-checkmute <player>' 检查玩家的当前静音状态。
sparkword.scan # 允许使用 'sw-scan <player> <page>' 检查玩家累积的静音和警告记录。
sparkword.warn # 授权使用 'sw-warn <player> <reason>' 命令或其别名发出正式警告。
sparkword.notify # 允许工作人员通过聊天接收玩家违规行为的实时通知。
sparkword.audit # 允许使用 'sw audit <staff-name/page> <page>' 查询工作人员操作审计记录。
sparkword.logs # 允许访问 'sw logs <logs/page> <page>' 以审查管理和执行记录。
清除权限
sparkword.purge.logs # 允许完全删除审核日志。
sparkword.purge.suggest # 允许完全删除已存储的建议。
sparkword.purge.warning # 允许删除所有记录的警告。
sparkword.purge.mute # 允许删除所有应用的静音处罚。
sparkword.purge.audit # 允许删除所有员工审计记录。
绕过权限
sparkword.bypass.chat # 允许绕过应用于聊天内容的过滤器。
sparkword.bypass.sign # 允许绕过应用于告示牌内容的过滤器。
sparkword.bypass.books # 允许绕过应用于可书写书籍内容的过滤器。
sparkword.bypass.anvils # 允许绕过应用于铁砧内容的过滤器。
sparkword.bypass.spam # 允许绕过反刷屏、防重复、防大写、数字限制及字符垃圾信息检测。
sparkword.bypass.writecommands # 允许绕过与 WriteCommand 列表相关的过滤器。
sparkword.bypass.injection # 允许绕过注入防护系统。
sparkword.bypass.symbol.all # 允许无限制使用危险的 Unicode 符号,包括 Zalgo 和不可见字符。
sparkword.bypass.ip # 允许绕过 IP 和域名过滤。
sparkword.bypass.ip.split # 允许绕过 IP 分段检测。
sparkword.bypass.cooldown # 允许绕过建议系统的冷却时间。
</details>
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
Arguments:
- ID: Each suggestion or entry is identified by a unique ID.
- Preset: Predefined warning or moderation presets for quick application.
- Word: The word to be added, removed, or suggested.
- List:
- n: Normal list
- s: Strong list
- wc: WriteCommand list
- sg: Suggestions list
- Logs:
- all: All available logs
- b: Blocked words (only available when filter mode is disabled)
- m: Applied mutes
- w: Applied warnings
Command | Arguments | Permission | Usage
/sw info | none | sparkword.info | Display available commands and their usage based on assigned permissions.
/sw list | List | sparkword.list | View word lists or pending suggestions.
/sw accept | ID/List | sparkword.accept | Accept suggested words into a target list.
/sw deny | ID/List | sparkword.deny | Deny or reject suggested words.
/sw add | List/Word | sparkword.add | Add words to a specific filtering list.
/sw remove | List/Word | sparkword.remove | Remove words from a specific filtering list.
/sw logs | Logs | sparkword.logs | Display moderation logs captured by staff or console.
/sw audit | Staff-Name | sparkword.audit | Show command execution logs for a specific staff member or all.
/sw purge | Logs/Suggest | sparkword.purge.* | Manually purge logs or the suggestions list.
/sw reload | none | sparkword.reload | Hot-reload the plugin configuration.
/sw-debug | none | sparkword.debug | Enable debugging mode to trace issues in the console.
/sw-mute | player/preset | sparkword.mute | Apply a permanent chat mute to a player.
/sw-permute | player/preset | sparkword.permute | Apply a permanent global mute blocking all writable inputs (chat, signs, anvils, books, and write-related commands).
/sw-tempmute | player/time/preset | sparkword.tempmute | Apply a temporary mute to a player.
/sw-unmute | player | sparkword.unmute | Remove an active mute from a player.
/sw-warn | player/preset | sparkword.warn | Issue a warning to a player.
/sw-scan | player | sparkword.scan | Inspect all mutes and warnings accumulated by a player.
/sw-checkmute | player | sparkword.checkmute | Verify a players mute status and remaining duration.
/sw-sg | Word/Reason | sparkword.suggest | Submit a word suggestion, report, or staff-related issue.
Permissions
# 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 <list> <word>' to regist er terms into filtering lists.
sparkword.remove # Allows execution of 'sw remove <list> <word>' 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 <page>' command to view internal documentation and command usage.
sparkword.list # Enables the 'sw list <list>' command to inspect word lists, suggestions, or active configurations.
sparkword.accept # Allows accepting suggestions using 'sw accept <ID/Suggest> <list>' and merging them into the target list.
sparkword.deny # Allows rejecting suggestions via 'sw deny <ID/Suggest>'.
sparkword.mute # Authorizes the use of the 'sw-mute <player> <reason>' command or alias to apply a permanent chat mute.
sparkword.permute # Authorizes the use of the 'sw-permute <player> <reason>' command or alias to apply a permanent global mute across all writable inputs.
sparkword.unmute # Allows removing an active mute using 'sw-unmute <player> <reason>'.
sparkword.tempmute # Allows applying temporary mutes via 'sw-tempmute <player> <time> <reason>'.
sparkword.checkmute # Allows checking a player's current mute status using 'sw-checkmute <player>'.
sparkword.scan # Allows inspecting a player's accumulated mutes and warnings using 'sw-scan <player> <page>'.
sparkword.warn # Authorizes the use of the 'sw-warn <player> <reason>' 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 <staff-name/page> <page>'.
sparkword.logs # Enables access to 'sw logs <logs/page> <page>' 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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧