- 版权类型
- 原创
- 版权链接
- #
- 语言支持
- 中文（简体）
- 前置组件
- LeviLamina：
https://github.com/LiteLDev/LeviLamina
LegacyScriptEngine：
https://github.com/LiteLDev/LegacyScriptEngine
- 适配版本（基岩）
- 26.x
PlayerLogger — 高性能轻量化的玩家行为全记录日志插件
插件简介
PlayerLogger 是一款高性能功能全面的轻量化玩家行为日志记录插件，能够自动记录玩家在服务器中的各类操作，并按事件类型分类存储、按日期自动分割日志文件。插件内置 37 种事件监听，涵盖聊天、方块操作、实体交互、经济变动、红石机械等几乎所有玩家行为，帮助管理员轻松追溯问题、分析玩家活动。
同时提供游戏内表单查看界面
/playerlog ，支持分页浏览和关键词搜索，无需手动翻阅文件即可快速定位日志。
核心特性
全事件覆盖
- 玩家行为：聊天、进出服务器、死亡、命令执行
- 方块操作：放置、破坏、告示牌修改、展示框操作
- 物品交互：使用物品、拾取/丢弃、桶操作、盔甲变化、物品栏变化
- 实体交互：攻击实体、交互实体
- 容器相关：容器开关、容器内容变化
- 生物/世界：生物死亡、生物特殊行为、弹射物击中、爆炸事件、火焰蔓延
- 经济系统：金钱增加、减少、转账、设置金额
- 红石/机械：红石更新、活塞推动、漏斗输出
智能存储
- 按类型分类：每种事件独立文件夹（如“玩家聊天”、“经济系统”），中文命名直观易找
- 按日期分割：每日生成独立日志文件（如 chat_2026-07-18.log），防止单文件过大
- 高性能写入：采用批量写入 + 限流机制，即使在高负载服务器也不影响 TPS
游戏内查看
- 指令
/playerlog（仅 OP 可用）直接打开日志列表 - 分页显示：每页 20 条记录，底部“上一页/下一页”轻松翻页
- 关键词搜索：输入关键词快速过滤日志内容，结果同样支持分页
- 只显示已启用类型：列表自动过滤未开启的日志类型，界面简洁
灵活配置
配置文件 /plugins/PlayerLogger/config.json 支持独立开关每个日志类型，按需启用/禁用。
日志目录结构
代码：
playerlogs/
├── 玩家聊天/
├── 告示牌修改/
├── 玩家进出服务器/
├── 玩家放置方块/
├── 玩家破坏方块/
├── 玩家执行命令/
├── 玩家死亡/
├── 玩家使用物品/
├── 玩家拾取丢弃/
├── 玩家桶操作/
├── 玩家开关容器/
├── 玩家物品栏变化/
├── 玩家攻击实体/
├── 玩家交互实体/
├── 生物死亡/
├── 生物特殊行为/
├── 弹射物击中/
├── 爆炸事件/
├── 火焰蔓延/
├── 容器内容变化/
├── 玩家操作展示框/
├── 玩家盔甲变化/
├── 经济系统/
├── 红石更新/
├── 活塞推动/
└── 漏斗输出/ 配置文件示例
/plugins/PlayerLogger/config.json：
代码：
{
"chat": true, // 玩家聊天消息
"sign": true, // 告示牌修改
"join": true, // 玩家进入服务器
"leave": true, // 玩家离开服务器
"place": true, // 玩家放置方块
"break": true, // 玩家破坏方块
"command": true, // 玩家执行命令
"death": true, // 玩家死亡
"item_use": true, // 玩家使用物品
"item_pickup_drop": true, // 玩家拾取/丢弃物品
"bucket": true, // 玩家桶操作
"container_open": true, // 玩家打开容器
"container_close": false, // 玩家关闭容器
"inventory_change": true, // 玩家物品栏变化
"attack_entity": true, // 玩家攻击实体
"interact_entity": true, // 玩家交互实体
"armor_change": true, // 玩家盔甲变化
"use_frame": true, // 玩家操作展示框
"mob_death": true, // 生物死亡
"mob_behavior": true, // 生物特殊行为
"projectile": true, // 弹射物击中实体
"explosion": true, // 爆炸事件
"fire_spread": false, // 火焰蔓延
"container_change": true, // 容器内容变化
"money_add": true, // 经济-金钱增加
"money_reduce": true, // 经济-金钱减少
"money_trans": true, // 经济-转账
"money_set": true, // 经济-设置金额
"redstone": false, // 红石更新
"piston": false, // 活塞推动
"hopper": false // 漏斗输出
}🛠 环境依赖
- LeviLamina
- LegacyScriptEngine
安装方法
- 将插件解压到
/plugins/目录 - 重启服务器
- 插件自动创建
/playerlogs/目录及配置文件 - 默认所有类型均启用，可根据需求修改配置文件
- OP 玩家输入
/playerlog即可在游戏内查看日志
