# StationLog —— 轻量级玩家行为日志记录插件
## 插件简介
StationLog 是一款专为 Minecraft 服务器服主设计的轻量级玩家行为日志记录插件。它无需数据库、配置简单、占用极低，通过 CSV 文件记录玩家的重要行为，方便服主管理服务器、排查纠纷、分析玩家活动。
不同于功能庞杂的大型日志插件，StationLog 更注重“开箱即用”和“易于查看”。所有日志均可直接使用 Excel、WPS 或其他表格软件打开，无需额外学习复杂的查询语法。
---
## 插件特色
-
无需 MySQL、SQLite 等数据库支持
- 按日期自动生成日志文件
- 异步写入，降低对服务器性能的影响
- 支持 Excel/WPS 直接查看与筛选
- 可自由开启或关闭不同类型的日志记录
- 支持忽略指定世界与指定玩家
- 轻量、稳定、易部署
---
## 支持版本
- Paper
- Spigot
兼容版本：
- Minecraft 1.20.1 ～ 1.21.8
---
## 记录内容
### 玩家行为
- 玩家进入服务器（JOIN）
- 玩家退出服务器（QUIT）
- 玩家死亡（DEATH）
- 玩家聊天（CHAT）
- 玩家执行命令（COMMAND）
### 方块行为
- 放置方块（BLOCK_PLACE）
- 破坏方块（BLOCK_BREAK）
### 容器行为
- 打开容器（CONTAINER_OPEN）
支持记录大多数常见容器，包括：
- 箱子
- 木桶
- 熔炉
- 漏斗
- 潜影盒
- 其他可交互容器
---
## 日志存储
日志将自动保存至：
plugins/StationLog/logs/
并按日期生成独立文件，例如：
2026-06-22.csv
2026-06-23.csv
CSV 格式示例：
时间,玩家,行为,世界,X,Y,Z,详情
2026-06-22 10:15:20,Steve,JOIN,world,0,64,0,-
2026-06-22 10:18:03,Steve,BLOCK_BREAK,world,125,64,-32,DIAMOND_ORE
2026-06-22 10:19:11,Alex,COMMAND,world,0,65,0,/spawn
---
## 配置示例
可通过配置文件自由控制记录内容：
ignore-worlds:
- example_world
ignore-players:
- Notch
record-chat: true
record-commands: true
record-container: true
record-block: true
---
## 指令
/stationlog reload
重载配置文件。
/stationlog stats
查看当前日志统计信息。
---
## 适用场景
- 玩家纠纷处理
- 熊孩子破坏排查
- 日常服务器巡查
- 玩家活跃度分析
- 管理员行为留档
- 小型与中型服务器日志审计
---
## 为什么选择 StationLog？
如果你觉得大型日志插件功能过于复杂、学习成本高，或者只是想要一个“安装即可使用”的行为记录工具，那么 StationLog 会是一个不错的选择。
它没有繁琐的数据库配置，也无需记忆复杂指令。安装后即可自动记录重要行为，让日志管理回归简单。
轻量，但足够可靠。
---
感谢每一位使用与反馈的服主。如果在使用过程中发现问题或有新的功能建议，欢迎提出意见，我们将持续优化 StationLog，打造更实用、更高效的玩家行为日志插件。
## 插件简介
StationLog 是一款专为 Minecraft 服务器服主设计的轻量级玩家行为日志记录插件。它无需数据库、配置简单、占用极低，通过 CSV 文件记录玩家的重要行为，方便服主管理服务器、排查纠纷、分析玩家活动。
不同于功能庞杂的大型日志插件，StationLog 更注重“开箱即用”和“易于查看”。所有日志均可直接使用 Excel、WPS 或其他表格软件打开，无需额外学习复杂的查询语法。
---
## 插件特色
-
无需 MySQL、SQLite 等数据库支持-
按日期自动生成日志文件-
异步写入，降低对服务器性能的影响-
支持 Excel/WPS 直接查看与筛选-
可自由开启或关闭不同类型的日志记录-
支持忽略指定世界与指定玩家-
轻量、稳定、易部署---
## 支持版本
- Paper
- Spigot
兼容版本：
- Minecraft 1.20.1 ～ 1.21.8
---
## 记录内容
### 玩家行为
- 玩家进入服务器（JOIN）
- 玩家退出服务器（QUIT）
- 玩家死亡（DEATH）
- 玩家聊天（CHAT）
- 玩家执行命令（COMMAND）
### 方块行为
- 放置方块（BLOCK_PLACE）
- 破坏方块（BLOCK_BREAK）
### 容器行为
- 打开容器（CONTAINER_OPEN）
支持记录大多数常见容器，包括：
- 箱子
- 木桶
- 熔炉
- 漏斗
- 潜影盒
- 其他可交互容器
---
## 日志存储
日志将自动保存至：
plugins/StationLog/logs/
并按日期生成独立文件，例如：
2026-06-22.csv
2026-06-23.csv
CSV 格式示例：
时间,玩家,行为,世界,X,Y,Z,详情
2026-06-22 10:15:20,Steve,JOIN,world,0,64,0,-
2026-06-22 10:18:03,Steve,BLOCK_BREAK,world,125,64,-32,DIAMOND_ORE
2026-06-22 10:19:11,Alex,COMMAND,world,0,65,0,/spawn
---
## 配置示例
可通过配置文件自由控制记录内容：
ignore-worlds:
- example_world
ignore-players:
- Notch
record-chat: true
record-commands: true
record-container: true
record-block: true
---
## 指令
/stationlog reload
重载配置文件。
/stationlog stats
查看当前日志统计信息。
---
## 适用场景
- 玩家纠纷处理
- 熊孩子破坏排查
- 日常服务器巡查
- 玩家活跃度分析
- 管理员行为留档
- 小型与中型服务器日志审计
---
## 为什么选择 StationLog？
如果你觉得大型日志插件功能过于复杂、学习成本高，或者只是想要一个“安装即可使用”的行为记录工具，那么 StationLog 会是一个不错的选择。
它没有繁琐的数据库配置，也无需记忆复杂指令。安装后即可自动记录重要行为，让日志管理回归简单。
轻量，但足够可靠。
---
感谢每一位使用与反馈的服主。如果在使用过程中发现问题或有新的功能建议，欢迎提出意见，我们将持续优化 StationLog，打造更实用、更高效的玩家行为日志插件。
