# **⌚ 欢迎使用 Sessioneer!**
### **以前所未有的方式跟踪、保存和显示玩家会话数据！**
**Sessioneer** 是一款功能强大且灵活的插件，旨在监控和存储有关您的 Minecraft 服务器上玩家会话的详细信息。无论您是想奖励活跃玩家、创建排行榜还是仅仅跟踪游戏时间统计数据，Sessioneer 都能提供您所需的所有工具，并具有美观的格式和广泛的自定义选项。
---
## 🌟 **主要特点**
- **实时会话跟踪**: 玩家加入时自动开始计数，并在注销时保存数据
- **持久性数据存储**: 在 YAML 文件或 MySQL 数据库中存储玩家统计信息
- **美观的时间格式**: 以人类可读的格式显示时间（例如：`12 д. 4 ч. 25 м. 17 сек.`)
- **全面的玩家统计数据**: 跟踪会话、总游戏时间、加入次数、首次加入日期和最后一次出现时间
- **PlaceholderAPI 集成**: 与 6 多个强大的占位符无缝集成
- **丰富的命令系统**: 具有制表符自动完成和彩色输出的直观命令
- **离线玩家支持**: 查看当前离线玩家的统计数据
- **自动数据库更新**: 针对无缝更新进行智能 MySQL 模式管理
---
## 📜 **可用命令**
| 命令 | 描述 |
|---------|-------------|
| `/sessioneer` | 显示包含所有可用命令的主要帮助菜单 |
| `/sessioneer version` | 显示当前插件版本 |
| `/sessioneer session <昵称>` | 显示指定玩家的当前会话时间 |
| `/sessioneer joins <昵称>` | 显示玩家加入服务器的总次数 |
| `/sessioneer info <昵称>` | 显示带有美观彩色输出的全面玩家统计数据 |
✨ **专业提示**: 使用 **制表符自动完成** 来轻松浏览命令和玩家名称！
---
## 🎯 **可用占位符**
| 占位符 | 描述 |
|-------------|-------------|
| `%sessioneer_player_session%` | 当前玩家的游戏会话时间（例如：`15 м. 32 сек.`) |
| `%sessioneer_player_alltime%` | 所有会话的总游戏时间（例如：`12 д. 4 ч. 25 м. 17 сек.`) |
| `%sessioneer_onjoin_amount%` | 玩家加入服务器的总次数 |
| `%sessioneer_player_lastseen%` | 玩家最后一次出现的时间（例如：`25 мин. назад` 或 `Онлайн`) |
| `%sessioneer_player_firstjoin%` | 玩家首次加入的日期和时间（例如：`25.12.2023 14:30`) |
| `%sessioneer_player_average_time%` | 平均会话时间（例如：`32 м. 15 сек.`) |
---
## ⚙️ **配置选项**
Sessioneer 支持两种存储方法：
- **文件存储** (YAML) - 设置简单，非常适合小型到中型服务器
- **MySQL 数据库** - 为大型服务器提供可扩展的解决方案，并具有自动模式更新
```yaml
# 存储方法
method: "file" # 或 "mysql"
# MySQL 配置 (如果 method: "mysql")
host: "localhost"
name: "sessioneer_db"
user: "your_username"
password: "your_password"
```
---
## 🎨 **美观的输出示例**
当使用 `/sessioneer info ` 时，您将获得令人惊艳的格式化输出：
```
============= PlayerName =============
Это игрок - PlayerName
Текущее время сессии - 15 м. 32 сек.
Общее время - 12 д. 4 ч. 25 м. 17 сек.
Первый заход - 25.12.2023 14:30
Последний заход - Онлайн
Среднее время игры - 32 м. 15 сек.
==============================
```
---
## 🔧 **要求**
- **服务器**: Paper 1.20.1 或更高版本
- **依赖**: PlaceholderAPI
- **存储**: 内置文件支持或 MySQL
---
## 🚀 **非常适合**
- **服务器排行榜** - 创建游戏时间排名
- **奖励系统** - 根据游戏时间给予奖励
- **服务器统计数据** - 跟踪服务器参与度
- **社区建设** - 对活跃玩家表示感谢
- **管理员工具** - 监控玩家活动
立即使用 Sessioneer 增强您的服务器体验！