AdvancedChat-AC

插件

· 作者 YourSenior

AdvancedChatv2 让每位玩家都能掌控自己在聊天框中看到的内容。他们可以屏蔽整个公共聊天、阻止特定玩家,查看已忽略的玩家列表,并且服务器会在广告消息到达任何人之前自动将其拦截。

0 本站下载 0 关注 更新于 4 个月前

最新 1.0.0 · 26.2 · Bukkit / Paper

一键开服(送7天)

AdvancedChat-AC

版本: 1.0.0  |  作者: Spy  |  API: Spigot / Paper 1.13 – 1.21+

logo

AdvancedChat-AC 让每位玩家都能掌控自己在聊天窗口中看到的内容。他们可以屏蔽整个公共聊天,阻止特定玩家的消息,查看已忽略的玩家列表,并且服务器会在消息送达任何人之前自动拦截广告信息——这一切都无需任何延迟、数据库或额外设置。


工作原理 — 快速概览

  • 聊天开关 — 玩家运行 /chattoggle,此后他们将完全看不到任何公共聊天消息。再次运行该命令即可恢复显示。此偏好设置会被保存并保留在重启后。
  • 忽略(Ignore) — 玩家运行 /ignore Steve,则 Steve 的消息将不再出现在他们的视野中。Steve 本人不受影响——他仍可正常聊天;只有执行忽略操作的玩家看不到他的消息。再次运行 /ignore Steve 即可取消忽略。
  • 忽略列表 — /ignorelist 会按字母顺序打印出该玩家已忽略的所有玩家名称。
  • 广告过滤 — 每条消息在送达任何人之前都会经过词库和域名后缀列表的检查。如果匹配到广告内容,发送者会收到警告,且该消息会被静默丢弃。OP(管理员)可以绕过此限制。

所有这些操作均在异步线程上完成——聊天事件期间绝不会占用主服务器线程。


安装

  1. 将 AdvancedChatv2.jar 放入服务器的 plugins/ 文件夹中。
  2. 启动或重启服务器。
  3. 自动生成三个文件:
    • plugins/AdvancedChatv2/config.yml — 所有面向玩家的消息配置
    • plugins/AdvancedChatv2/block.yml — 广告过滤词库和域名后缀列表
    • plugins/AdvancedChatv2/playerdata.json — 首次保存时创建,存储开关状态和忽略状态

无需数据库。无需额外插件。无需配置即可开始使用。


命令

/chattoggle

字段 值
别名 /ctoggle, /tc
权限 advancedchat.toggle
可用对象 默认所有玩家

功能说明: 切换玩家是否可见公共聊天。

  • 默认情况下所有玩家的聊天均为开启状态。运行 /chattoggle 将其关闭——他们将不再接收来自任何人的公共聊天消息。
  • 再次运行 /chattoggle 将其重新开启——他们将恢复正常看到聊天内容。
  • 玩家自己的消息不受影响。他们仍然可以输入并发送消息;只是在关闭状态下,他们无法看到他人发来的消息。
  • 此设置保存到磁盘,并在重启、重连和服务器崩溃后保持持久化。
  • 仅对关闭聊天的玩家存储开关状态——保持聊天开启的玩家不占用任何内存。

/ignore <player>

字段 值
别名 /unignore
权限 advancedchat.ignore
可用对象 默认所有玩家
Tab 补全 是 — 建议当前在线的所有玩家

功能说明: 隐藏或取消隐藏特定玩家的聊天消息。这是一个个人开关——仅影响您的视角。被忽略的玩家永远不会收到通知。

  • 运行一次 /ignore Steve 将隐藏 Steve 未来所有的聊天消息。
  • 再次运行 /ignore Steve 将恢复显示他的消息。
  • 支持离线玩家——您可以忽略当前未在线的玩家。名称通过 Bukkit 的离线玩家缓存解析。如果该玩家从未加入过服务器,命令会提示“未找到”。
  • 您不能忽略自己。
  • 每位玩家的忽略列表是独立存储的。忽略 Steve 不会影响其他人查看 Steve 消息的视角——仅影响您自己。
  • 当您取消忽略最后一名玩家且忽略列表变为空时,该列表所占用的内存会立即释放。

/ignorelist

字段 值
别名 /ilist, /ignoredlist
权限 advancedchat.ignore
可用对象 默认所有玩家

功能说明: 显示您当前正在忽略的所有玩家的格式化列表。名称通过 Bukkit 的离线玩家缓存从 UUID 解析为用户名——无需额外的查找或延迟。列表按字母顺序排序。

如果您没有忽略任何人,系统会提示您这一情况,并提示如何使用 /ignore 命令。


权限

权限节点 授予内容 默认拥有者
advancedchat.toggle 使用 /chattoggle 所有玩家
advancedchat.ignore 使用 /ignore 和 /ignorelist 所有玩家
advancedchat.bypass.filter 发送任何消息而不受广告过滤检查 仅限 OP

广告过滤

在公共聊天中发送的每条消息在抵达任何玩家之前都会被扫描。扫描在内存中进行,不会增加可测量的性能开销。检测机制包含三层:

1. 禁用词汇 (block.yml → blocked-words)

一个纯文本短语列表。如果短语任意位置出现在消息中(不区分大小写,子字符串匹配),消息将被阻止。

默认设置下会被阻止的示例:

  • "discord.gg/myserver" — 包含 discord.gg
  • "Get FREE RANKS at our server!" — 包含 free ranks
  • "BUY NOW at our website" — 包含 buy now

2. 禁用域名后缀 (block.yml → blocked-extensions)

一个域名结尾列表。消息中任何以这些后缀结尾的词都被视为 URL,消息将被阻止。

示例:

  • "play.ourserver.net" — 以 .net 结尾
  • "visit shop.store for items" — 以 .store 结尾
  • "join us at coolserver.gg" — 以 .gg 结尾

3. IP 地址检测(始终启用)

任何匹配 IPv4 地址模式(x.x.x.x)的文本都将自动被阻止,无论列表如何设置。

示例:

  • "connect to 192.168.1.1"
  • "ip: 10.0.0.1:25565"

被屏蔽时会发生什么

消息会被取消——其他玩家永远不会看到它。发送者会收到 filter-blocked 消息。不会通知其他人。拥有 advancedchat.bypass.filter 权限的玩家将跳过所有三层过滤。


配置文件

config.yml — 消息

插件发送给玩家的每条消息。使用 & 颜色代码。

messages:
  chat-disabled:      "&a聊天已 &c禁用&a。使用 &f/chattoggle &a重新启用。"
  chat-enabled:       "&a聊天已 &a启用&a。你现在可以再次看到公共聊天。"
  now-ignoring:       "&a你正在忽略 &f{player}&a。他们的消息对你隐藏。"
  no-longer-ignoring: "&a你不再忽略 &f{player}&a。你可以再次看到他们的消息。"
  player-not-found:   "&c未找到玩家 &f{player} &c或该玩家从未加入过服务器。"
  ignore-self:        "&c你不能忽略自己。"
  ignore-usage:       "&e用法:&f/ignore <player>"
  ignorelist-empty:   "&e你没有忽略任何人。使用 &f/ignore <player> &e来忽略某人。"
  ignorelist-header:  "&8&m----&r &e被忽略的玩家 &7({size}) &8&m----"
  ignorelist-entry:   "&7- &f{player}"
  ignorelist-footer:  "&8&m----&r &7使用 &f/ignore <player> &7取消忽略 &8&m----"
  filter-blocked:     "&c你的消息被屏蔽了——禁止发布广告。"
  players-only:       "&c只有玩家才能使用此命令。"
  no-permission:      "&c你没有权限使用此命令。"

占位符:

占位符 适用位置
{player} now-ignoring, no-longer-ignoring, player-not-found, ignorelist-entry
{size} ignorelist-header

颜色代码:

代码 颜色 代码 颜色
&0 黑色 &8 深灰色
&1 深蓝色 &9 蓝色
&2 深绿色 &a 绿色
&3 深青色 &b 青色
&4 深红色 &c 红色
&5 深紫色 &d 浅紫色
&6 金色 &e 黄色
&7 灰色 &f 白色
&l 加粗 &o 斜体
&m 删除线 &n 下划线
&r 重置 &k 乱码

block.yml — 广告过滤词

blocked-words:
  - "discord.gg"
  - "buy now"
  - "free ranks"
  - "join my server"
  - "youtube.com"
  # 在此处添加你自己的条目

blocked-extensions:
  - ".com"
  - ".net"
  - ".org"
  - ".fun"
  - ".gg"
  - ".xyz"
  - ".io"
  - ".me"
  - ".store"
  - ".online"
  - ".site"
  - ".club"
  - ".tk"
  - ".ml"
  # 在此处添加更多后缀

更改在服务器重启或插件重载后生效。


数据与持久化

玩家数据保存在 plugins/AdvancedChatv2/playerdata.json 中:

{
  "chatDisabled": [
    "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
  ],
  "ignored": {
    "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb": [
      "cccccccc-cccc-cccc-cccc-cccccccccccc"
    ]
  }
}
  • chatDisabled — 关闭聊天的玩家 UUID。开启聊天的玩家根本不会列出。
  • ignored — 观察者 UUID 到被忽略 UUID 数组的映射。忽略列表为空的玩家根本不会列出。

保存时机:

  • 玩家断开连接 → 在主线程外异步保存
  • 使用命令(toggle / ignore)→ 异步保存,以便即使在下一次断开连接前服务器崩溃,状态也能持久化
  • 服务器关闭 → 最终同步保存,无数据丢失

序列计数器确保如果多个异步保存同时排队,只写入最新的快照。旧的进行中的写入会自动丢弃。


RAM 和 CPU 占用

本节提供插件执行的每个操作的精确数字,让你确切知道它为服务器增加了多少负载。


每位玩家的内存占用

存储内容 每项字节数 备注
chatDisabled 中的一个 UUID ~64 字节 仅当玩家切换聊天为 OFF 时存储
ignored 映射中的一条记录(外层) ~64 字节 仅在玩家忽略某人时创建
忽略列表中的一项 UUID(内层) ~64 字节 每个被忽略的玩家一条
没有任何切换或忽略的玩家 0 字节 不活跃玩家不存储任何内容

按服务器规模的实际总计:

在线玩家数 10% 关闭聊天 5% 有忽略列表(平均每人忽略 5 人) 插件总 RAM
100 名玩家 10 × 64 B = 0.6 KB 5 × 5 × 64 B = 1.6 KB ~2.2 KB
500 名玩家 50 × 64 B = 3.1 KB 25 × 5 × 64 B = 8 KB ~11 KB
1,000 名玩家 100 × 64 B = 6.4 KB 50 × 5 × 64 B = 16 KB ~22 KB
10,000 名玩家 1,000 × 64 B = 64 KB 500 × 5 × 64 B = 160 KB ~224 KB

在任何合理的玩家数量下,插件使用的 RAM 远低于 1 MB。服务器本身、区块数据、实体和其他插件将使用吉字节(GB)——相比之下,这个插件几乎不可见。


每条聊天消息的 CPU 占用

每条聊天消息都会在 异步线程(非主线程 tick)上触发两个操作:

步骤 1 — 广告过滤器检查

消息会与你的 blocked-words 列表和域名模式进行检查。

操作 每次调用时间 备注
一次 String.contains() 单词检查 ~20–50 纳秒 扫描消息以查找一个短语
一次正则表达式域名模式检查 ~500–1,000 纳秒 匹配一个域名扩展名
IP 地址正则表达式检查 ~500 纳秒 始终运行一次
50 个单词 + 20 个扩展名(典型配置) ~30–50 微秒总计 单条消息的整个过滤器检查

步骤 2 — 接收者过滤

对于每个将接收消息的玩家,插件执行两次 ConcurrentHashMap.get() 查找——一次检查他们是否关闭了聊天,一次检查他们是否忽略了发送者。两者都是 O(1) 复杂度,每次耗时约 50–100 纳秒。

在线接收者 查找次数 时间
50 名玩家 100 次查找 ~5–10 微秒
200 名玩家 400 次查找 ~20–40 微秒
500 名玩家 1,000 次查找 ~50–100 微秒
1,000 名玩家 2,000 次查找 ~100–200 微秒

每条消息总计(过滤器 + 接收者循环):

在线玩家数 每条消息耗时 每秒消息数(10 名玩家聊天) CPU 占用
100 ~60 µs 10 msg/s = 0.6 ms/s < 单个核心的 0.1%
500 ~150 µs 10 msg/s = 1.5 ms/s < 单个核心的 0.2%
1,000 ~250 µs 10 msg/s = 2.5 ms/s < 单个核心的 0.3%

整个工作负载均在异步线程上运行,与主服务器 Tick 隔离。即使过滤过程比预期耗时更长,TPS 也完全不受影响。


保存操作

操作 线程 耗时 频率
快照复制(异步写入前) 主线程或退出线程 ~5–50 µs 每次玩家退出或执行命令时
JSON 写入磁盘 异步线程 ~1–5 ms 每次玩家退出或执行命令时
关闭时保存 主线程 ~1–5 ms 仅在 /stop 时执行一次

JSON 文件很小——即使有 10,000 名玩家且每个人都拥有忽略列表,其大小也不太可能超过几百 KB。写入时间保持在 5 ms 以下。由于写入是异步进行的,主线程永远不会被阻塞。


内存与 CPU 总结

指标 数值
500 名玩家时的插件内存占用 ~11 KB
1,000 名玩家时的插件内存占用 ~22 KB
聊天时每条消息的 CPU 开销(500 名玩家) ~150 µs,在异步线程上
聊天期间对主线程的影响 零
保存期间对主线程的影响 零(异步)
游戏过程中的磁盘 I/O 零
与原版聊天的性能对比 无法区分

文件夹结构

plugins/
└── AdvancedChatv2/
    ├── config.yml          ← 所有面向玩家的消息
    ├── block.yml           ← 广告过滤词和域名后缀
    └── playerdata.json     ← 自动生成,请勿手动编辑

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源