# 🎮 玩家统计 Minecraft 插件
Player Statistics 是一个 Minecraft 服务器插件，用于跟踪和管理玩家统计数据，为玩家和服务器管理员提供有用的命令和功能。
---
## ✨ 功能
- 💾 与 MySQL 集成，实现持久性数据存储
- ⚡ 提供命令以查看和同步玩家统计数据
- 📊 自动跟踪玩家统计数据
- 🔧 易于配置和扩展
---
## 📷 截图
---
## 🚀 开始使用
### 1. 安装
1. 从 [Releases](https://github.com/SpreadSheets600/Minecraft-Statistics/releases) 部分下载最新的编译后的 `.jar` 文件。
2. 将 `.jar` 文件放入服务器的 `plugins` 目录中。
3. 重新启动您的 Minecraft 服务器。
### 2. 配置
1. 首次运行后，将在插件的文件夹中生成一个 `config.yml` 文件。
2. 打开 `config.yml` 并根据需要更新 MySQL 数据库设置和其他选项：
```yaml
mysql:
host: localhost
port: 3306
database: minecraft
username: root
password: yourpassword
```
3. 保存文件并重新启动服务器以应用更改。
---
## 🕹️ 命令
| 命令 | 描述 | 权限 |
|-----------------|------------------------------------|-----------------------------|
| `/stats` | 查看您的统计数据 | `playerstatistics.stats` |
| `/syncplayers` | 同步所有玩家数据到数据库 | `playerstatistics.sync` |
| `/debugger` | 调试插件操作（管理员） | `playerstatistics.debug` |
---
## 🛠️ 从源代码构建
> **注意:** 大多数用户不需要从源代码构建。如果您只想使用该插件，请从发布版本下载预构建的 `.jar`。
1. 确保您已安装 [Java 17+](https://adoptopenjdk.net/) 和 [Maven](https://maven.apache.org/)。
2. 克隆此存储库：
```sh
git clone https://github.com/yourusername/PlayerStatistics.git
cd PlayerStatistics
```
3. 构建插件：
```sh
mvn clean compile
mvn clean package
```
4. 编译后的 `.jar` 文件将位于 `target/` 目录中。
---
## 🤝 贡献
欢迎贡献！要贡献：
1. fork 此存储库并创建您的功能分支 (`git checkout -b feature/AmazingFeature`)
2. 提交您的更改 (`git commit -m 'Add some AmazingFeature'`)
3. 推送到分支 (`git push origin feature/AmazingFeature`)
4. 打开一个拉取请求
请遵循现有的代码样式，并包含清晰的提交消息。
---
## 💬 支持
对于问题或功能请求，请在 [GitHub](https://github.com/spreadSheets600/minecraft-statistics) 上提交问题。