原创 聊天 [Waterfall/BungeeCord] BungeeChatLogger —— 群组服聊天统一后台记录插件 2026-06-18

[Waterfall/BungeeCord] BungeeChatLogger —— 群组服聊天统一后台记录插件​

插件简介​

BungeeChatLogger 是一款用于 Waterfall / BungeeCord 群组服 的聊天记录插件。

它可以将玩家在各个子服中的 普通聊天 和 私聊命令 统一推送到 Waterfall 后台控制台，方便服主在代理端集中查看玩家聊天内容，不需要再分别进入每个子服后台查看。

本插件适合多子服群组服使用，例如生存服、资源服、副本服、地皮服、RPG服等。

---

插件特点​

支持 Waterfall / BungeeCord 代理端使用

支持 1.12.2 CatServer 子服环境

只需要安装在代理端，不需要每个子服都安装

支持记录普通聊天

支持记录常见私聊命令

控制台显示玩家所在子服

控制台显示玩家名、UUID、消息内容

不修改玩家聊天内容

不拦截聊天消息

不影响原有聊天插件

不操作背包、经济、权限、物品等数据

---

适用环境​

推荐环境：

代理端：Waterfall / BungeeCord
子服端：CatServer / Spigot / Paper 1.12.2
Java：Java 8+

本插件主要面向群组服代理端使用。

插件命令​

重载配置：

/bcl reload

查看插件状态：

/bcl status

---

配置文件示例​

log-normal-chat: true
log-private-message-commands: true

private-commands:
- msg
- tell
- w
- whisper
- m
- pm
- r
- reply
- emsg
- etell
- ewhisper
- er
- ereply

format-normal: "[ChatLogger] [普通聊天] [{server}] {player}({uuid}): {message}"
format-private: "[ChatLogger] [私聊命令] [{server}] {player}({uuid}): {message}"

strip-color: true
anti-log-forge: true

---

配置说明​

log-normal-chat​

是否记录普通聊天。

log-normal-chat: true

设置为 false 后，不再记录普通聊天。

---

log-private-message-commands​

是否记录私聊命令。

log-private-message-commands: true

设置为 false 后，不再记录私聊命令。

---

private-commands​

私聊命令列表。

只要玩家输入的命令在这个列表内，就会被记录到 Waterfall 后台。

例如：

private-commands:
- msg
- tell
- w
- r

---

format-normal​

普通聊天的后台显示格式。

可用变量：

{server} 玩家所在子服
{player} 玩家名称
{uuid} 玩家UUID
{message} 聊天内容

---

format-private​

私聊命令的后台显示格式。

可用变量：

{server} 玩家所在子服
{player} 玩家名称
{uuid} 玩家UUID
{message} 玩家输入的私聊命令内容

---

strip-color​

是否去除颜色符号。

strip-color: true

建议保持开启，避免玩家通过颜色代码影响后台显示。

---

anti-log-forge​

是否启用基础日志防伪处理。

anti-log-forge: true

建议保持开启，避免玩家通过特殊换行等内容伪造后台日志。

---

注意事项​

本插件只负责记录聊天，不会改变玩家实际聊天内容。

本插件不会拦截消息，也不会阻止玩家发送聊天。

/r、/reply 这类回复命令可以记录玩家输入的内容，但不一定能准确判断实际回复对象。

如果需要精准记录私聊双方，需要额外适配具体私聊插件，例如 EssentialsX、CMI 等。

本插件涉及私聊记录功能，建议服主根据服务器规则提前告知玩家。

---

更新记录​

v1.0.0​

新增普通聊天记录功能

新增私聊命令记录功能

新增 Waterfall / BungeeCord 后台统一输出

新增配置文件

新增 /bcl reload 重载命令

新增 /bcl status 状态查看命令

新增基础颜色清理与日志防伪处理

---

插件定位​

BungeeChatLogger 适合需要统一管理群组服聊天记录的服主使用。

如果你的服务器是多子服架构，又希望在代理端集中查看玩家聊天和私聊命令，那么这个插件会比较实用。