CCLogger

插件

· 作者 Rikkening

记录聊天和命令

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

最新 CCLogger v5.2.0-alpha.3 · 1.21.4

一键开服(送7天)

CCLogger 是什么?

CCLogger 记录 Paper 服务器上的玩家活动。聊天消息、指令、加入、离开、踢出——所有内容都会记录到您选择的存储后端中。

您可以使用纯文本文件以简化操作,如果希望在不依赖外部组件的情况下进行查询,可以使用 SQLite;对于大型部署,可以连接 MySQL、MongoDB 或 Redis。所有写入操作均为异步执行,因此不会影响服务器的 TPS(每秒刻数)。


功能特性

日志记录

聊天 - 带有时间戳、世界名称和坐标的消息

指令 - 所有指令(支持黑名单,例如 /login、/register 等)

连接 - 加入、离开、踢出事件

输出选项:

  • 全局日志文件 (chat.log, commands.log)
  • 按玩家生成的文件 (players/Steve.log)
  • 自定义格式占位符:%date、%name、%content、%world、%x、%y、%z

存储

文件 - 纯文本文件,人类可读(无需配置)

SQLite - 本地数据库,无需配置(无需配置)

MySQL - 适用于多服网络的共享数据库(需要 MySQL 服务器)

MongoDB - 文档型存储,支持水平扩展(需要 MongoDB)

Redis - 高速内存存储,适合高并发场景(需要 Redis)

所有后端均使用异步写入和连接池技术。


隐私保护

支持多种 IP 记录模式以满足 GDPR 合规要求:

  • disabled - 不存储 IP 地址
  • truncated - 将最后一段置零(192.168.1.x 变为 192.168.1.0)
  • hashed - 使用每日轮换盐值的 bcrypt 哈希
  • full - 完整存储 IP 地址

可以通过正则表达式屏蔽特定指令。拥有 cclogger.exempt 权限的玩家不会被记录日志。


警报通知

实时监控关键词和指令:

  • 定义触发词(例如 "hack"、"cheat"、"exploit")
  • 定义触发指令(例如 "/op"、"/gamemode")
  • 拥有 cclogger.notify 权限的管理员会收到游戏内警报
  • 所有触发记录均会写入文件

Web 仪表盘

CCLogger 包含一个基于 React 的现代 Web 仪表盘(默认禁用):

仪表盘概览

  • 统计概览及日志类型细分
  • 日志分布饼图
  • 显示近期活动的活动时间线
  • 一目了然的活跃玩家排行

实时时间线

  • 自动刷新的实时活动流
  • 支持通过键盘快捷键暂停/恢复
  • 可按日志类型筛选(聊天、指令、登录、登出)
  • 滚动后出现“跳至最新”按钮

日志浏览器

  • 全库全文搜索
  • 按类型、玩家、日期范围筛选
  • 大数据量结果集的分页功能
  • 导出为 JSON 或 CSV 格式

玩家档案

  • 显示 Minecraft 头像(通过 Crafatar)
  • 每位玩家的活动统计数据
  • 近期活动历史记录
  • 点击任意玩家姓名即可查看其档案

REST API

  • POST /api/auth/token - 获取 JWT Token
  • GET /api/logs - 带筛选条件的日志查询
  • GET /api/logs/player/{name} - 指定玩家的日志
  • GET /api/logs/search?q=term - 搜索日志内容
  • GET /api/stats - 统计数据

支持 JWT 认证与速率限制。


运行环境要求

  • Paper 1.21+ 或 Folia
  • Java 21+

指令

  • /cclogger - 显示帮助信息
  • /cclogger reload - 重载配置(需要 cclogger.reload 权限)
  • /cclogger count <word> [player] - 统计词频(需要 cclogger.statistics 权限)
  • /cclogger clear - 归档并清空日志(需要 cclogger.admin 权限)

权限节点

  • cclogger.* - 所有权限(默认:OP)
  • cclogger.notify - 接收警报通知(默认:OP)
  • cclogger.exempt - 豁免日志记录(默认:false)
  • cclogger.reload - 重载配置(默认:OP)
  • cclogger.statistics - 使用计数指令(默认:OP)
  • cclogger.admin - 清空/归档日志(默认:OP)
  • cclogger.web - Web API 访问权限(默认:OP)

安装设置

  1. 将 JAR 文件放入 plugins/ 目录
  2. 重启服务器
  3. 编辑 plugins/CCLogger/config.yml
  4. 执行 /cclogger reload

默认配置开箱即用。如果您不想使用 SQLite,请修改 storage.type 设置。


配置示例

storage:
  type: sqlite  # file, sqlite, mysql, mongodb, redis

privacy: ip-logging: disabled

notifications: enabled: true chat-keywords: - "hack" - "cheat"

web: enabled: false port: 8080


相关链接

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源