# SimpleLog 插件
一个轻量级且易于使用的 Spigot/Paper 服务器日志插件,旨在记录清晰且有组织的服务器活动。
## 概述
SimpleLog 是一个简单易用的“即插即用”插件,它可以自动将关键服务器事件记录到结构良好的文本文件中。它专为需要以简单的方式监控玩家活动和服务器健康状况,而无需使用大型插件复杂性的服务器管理员而设计。安装后,它会在后台静默运行,无需任何配置。
# 功能
- 玩家连接日志记录:记录每次玩家加入或离开服务器的时间。
- 聊天日志记录:捕获所有公开的玩家聊天消息。
- 命令日志记录:记录玩家执行的所有命令。
- 警告日志记录:捕获并保存来自服务器控制台的所有[WARN]消息。
- 组织的文件结构:自动将日志组织到单独的文件夹中(加入-离开,聊天,命令,警告)。
- 每日日志文件:为每天创建一个新的日志文件,采用当前日期命名(例如,2025-08-28.log)。
- 高兼容性:专为 Minecraft 1.21.x 构建,与 Spigot、Paper 和 Bukkit 兼容。
- 零配置:无需设置。只需将其放入您的插件文件夹中,即可使用。
## 安装
1. 从发布页面下载最新的 SimpleLog-vX.X-x.jar。
2. 将下载的 .jar 文件放入服务器的 /plugins 目录中。
3. 重新启动或重新加载您的服务器。插件将自动生成所需的文件夹并开始记录。
## 日志文件结构
所有日志都存储在插件/SimpleLog/ 目录中。结构如下:
```
plugins/
└── SimpleLog/
├── chat/
│ └── 2025-08-28.log
├── command/
│ └── 2025-08-28.log
├── join-left/
│ └── 2025-08-28.log
└── warn/
└── 2025-08-28.log
```
日志格式
每个日志条目都采用易于阅读和解析的格式。
- ```join-left/YYYY-MM-DD.log```
```join-玩家名:玩家-uuid-HH:mm:ss```
```left-玩家名:玩家-uuid-HH:mm:ss```
- ```chat/YYYY-MM-DD.log```
```玩家名:玩家-uuid-HH:mm:ss-玩家发送的聊天消息。```
- ```command/YYYY-MM-DD.log```
```玩家名:玩家-uuid-HH:mm:ss-/命令及其参数```
- ```warn/YYYY-MM-DD.log```
- ```HH:mm:ss-来自控制台的完整警告消息。```