NexusChatFilter ?️
NexusChatFilter 是一款轻量级、高度优化且可自定义的聊天保护插件,专为 Spigot 和 Bukkit 服务器(1.16.5 - 1.21.x)设计。它原生支持现代 MiniMessage(RGB/渐变)文本格式,无需依赖 Paper API!
由 mustafa8907 开发 | GitHub | Website
⚡ 功能特性
- 无 Paper 依赖: 在标准 Spigot/Bukkit 上完美运行,利用内嵌(shaded)的 Kyori Adventure 库。
- 完整的 MiniMessage 支持: 在配置文件中可以使用标准的
<red>、<bold>,甚至是 <gradient:#ff4e50:#f9d423>Text</gradient> 格式。
- 高级防大写系统: 根据可配置的百分比阈值检测玩家是否在聊天中“大喊大叫”。它可以自动警告玩家并将他们的文本转为小写,或者执行禁言/封禁操作。
- 基于层级的词过滤: 为被捕获的词汇配置不同的严重程度:
Tier 1:严重脏话(执行严格命令,如 Ban)。
Tier 2:广告和普通脏话(执行中等命令,如 Mute)。
Tier 3:轻微冒犯性词汇(发送内置的可自定义警告消息)。
- 智能动作: 你可以配置层级来运行控制台命令,或者简单地使用
"warn" 关键字向玩家发送一个轻量级的内部插件消息。
- 角色绕过: 平滑地豁免特定角色(如管理员或版主)免受过滤器影响。
- 极其轻量: 使用高效的
HashSet 内存结构来处理聊天事件,耗时纳秒级,防止聊天卡顿。
?️ 安装方法
- 从 Modrinth 页面下载最新的
NexusChatFilter.jar。
- 将文件放入服务器的
plugins 文件夹中。
- 重启或重载服务器。
- 自定义位于
plugins/NexusChatFilter/ 中的配置文件。
- 使用
/nexusfilter reload 实时应用更改。
⚙️ 配置文件
NexusChatFilter 使用 3 个主要配置文件以保持组织有序:
config.yml - 包含核心逻辑、大写阈值、绕过角色以及每个层级执行的命令/动作。
messages.yml - 包含插件前缀、无权限警报以及使用 MiniMessage 格式化的内部警告消息。
Blocked-Words.yml - 按层级分类的被屏蔽词汇词典。
? 命令与权限
| 命令 |
描述 |
权限节点 |
/nexusfilter reload |
重载所有配置文件 |
nexuschatfilter.admin |
| 绕过过滤器 |
允许玩家绕过过滤器 |
nexuschatfilter.bypass.<role> |
(注意:绕过角色必须与 config.yml 下 bypass-roles 中定义的角色匹配。例如:nexuschatfilter.bypass.admin)
? 从源码构建
本项目使用 Maven 和 GitHub Actions 进行持续集成。
- 克隆仓库:
git clone https://github.com/mustafa8907-png/NexusChatFilter.git
- 进入目录:
cd NexusChatFilter
- 构建项目:
mvn clean package
- 在
target/ 目录中找到编译好的 jar 包。
由 NexusSetups Team 使用 mustafa8907 创建。
NexusChatFilter ?️
NexusChatFilter is a lightweight, highly optimized, and customizable chat protection plugin designed for Spigot and Bukkit servers (1.16.5 - 1.21.x). It natively supports modern MiniMessage (RGB/Gradients) text formatting without relying on the Paper API!
Developed by mustafa8907 | GitHub | Website
⚡ Features
- No Paper Dependency: Runs perfectly on standard Spigot/Bukkit utilizing an embedded (shaded) Kyori Adventure library.
- Full MiniMessage Support: Use standard
<red>, <bold>, or even <gradient:#ff4e50:#f9d423>Text</gradient> in your configurations.
- Advanced AntiCaps System: Detects if a player is screaming in the chat based on a customizable percentage threshold. It can automatically warn them and lowercase their text, or issue a mute/ban.
- Tier-Based Word Filtering: Configure different severities for caught words:
Tier 1: Heavy profanity (Executes strict commands like Ban).
Tier 2: Advertising and regular swears (Executes medium commands like Mute).
Tier 3: Minor offensive words (Sends a built-in, customizable warning message).
- Smart Actions: You can configure tiers to run console commands or simply use the
"warn" keyword to send a lightweight, internal plugin message to the player.
- Role Bypasses: Exempt specific roles (like admins or moderators) from the filter smoothly.
- Extremely Lightweight: Uses an efficient
HashSet memory structure to process chat events in nanoseconds, preventing chat lag.
?️ Installation
- Download the latest
NexusChatFilter.jar from the modrinth page.
- Drop the file into your server's
plugins folder.
- Restart or reload the server.
- Customize the configurations located in
plugins/NexusChatFilter/.
- Use
/nexusfilter reload to apply your changes in real-time.
⚙️ Configuration Files
NexusChatFilter uses 3 main configuration files to keep everything organized:
config.yml - Contains core logic, caps threshold, bypass roles, and the commands/actions executed per tier.
messages.yml - Contains plugin prefix, no-permission alerts, and internal warning messages formatted in MiniMessage.
Blocked-Words.yml - Your dictionary of blocked words categorized by tiers.
? Commands & Permissions
| Command |
Description |
Permission Node |
/nexusfilter reload |
Reloads all configuration files |
nexuschatfilter.admin |
| Bypass Filter |
Allows a player to bypass the filter |
nexuschatfilter.bypass.<role> |
(Note: The bypass role must match the ones defined under bypass-roles in config.yml. Example: nexuschatfilter.bypass.admin)
? Building from Source
This project uses Maven and GitHub Actions for continuous integration.
- Clone the repository:
git clone https://github.com/mustafa8907-png/NexusChatFilter.git
- Navigate to the directory:
cd NexusChatFilter
- Build the project:
mvn clean package
- Find the compiled jar in the
target/ directory.
Created with mustafa8907 by the NexusSetups Team.
评论 0
登录后参与评分
还没有评论,来抢沙发吧