# ⭐ 高级玩家统计插件
一个为 NSR-AI 添加高级玩家统计信息和隐私控制的插件。
---
**✔ 深入统计** • **✔ 玩家隐私** • **✔ AFK 追踪器**
---
## ⚙ 核心功能
* **深入的玩家统计信息** — 追踪各种玩家统计信息，包括游戏时间、击杀数、死亡数、开采方块数等等。
* **玩家隐私** — 一套全面的隐私系统，允许玩家控制谁可以查看他们的统计信息。
* **AFK 追踪器** — 自动检测玩家是否 AFK 并通知管理员。
* **自然语言命令** — 使用更自然和直观的命令来与插件交互。
* **玩家名称“您是不是要找？”** — 纠正玩家名称中的拼写错误，使命令更容易使用。
## 可用的统计信息
* `playtime` - 总游戏时间
* `health` - 当前生命值
* `hunger` - 当前饥饿值
* `deaths` - 总死亡次数
* `kills` - 总击杀次数
* `kd` - 击杀死亡比
* `blocks_mined` - 玩家开采的方块数
* `blocks_placed` - 玩家放置的方块数
* `distance_traveled` - 总旅行距离
* `streak` - 当前 PvP 击杀连击数
* `afk` - 玩家是否 AFK？
* `afktime` - AFK 的总时间
* `location` - 世界名称 & 维度（或离线时的最后位置）
## 安装方法
1. 下载插件的最新版本。
2. 将 `NSR-AI-Advanced-Player-Stats.jar` 文件放置在 `plugins/NSR-AI/addons` 目录中。
3. 重启你的服务器。插件将创建其默认配置文件并准备好使用。
## 依赖项
* **必需:**
* [**NSR-AI**](https://modrinth.com/project/mtI8ktEs): 此插件需要安装并启用主 NSR-AI 插件。
* **可选:**
* [**PlaceholderAPI**](https://www.spigotmc.org/resources/placeholderapi.6245/): 允许你在其他插件中使用此插件的统计信息。
### 命令
```
/ai stats <玩家> - 显示玩家的所有统计信息。
/ai <统计信息> <玩家> - 显示特定玩家的统计信息。
/ai privacy <玩家> <功能> [on|off] - 切换玩家的隐私设置。
/ai help stats - 显示所有玩家数据命令的列表。
# 不规则命令示例
/ai kills by ansh
/ai ansh deaths
/ai what is the playtime of ansh
/ai show me the location of ansh
```
### 权限
```
nsr-ai.stats.view — 默认：true
nr-ai.stats.view.others — 默认：true
nsr-ai.privacy — 默认：true
nsr-ai.admin.privacy — 默认：OP
nsr-ai.admin.privacy.bypass — 默认：OP
```
### 示例配置文件 (privacy.yml)
```
default:
health: true
hunger: true
deaths: true
kills: true
kd: true
blocks_mined: true
blocks_placed: true
distance_traveled: true
playtime: true
afk: true
streak: true
location: true
stats: true
afks:
kick-timer: 8
```
### 目录树
```
plugins/
└── NSR-AI/
└── addons/
├── NSR-AI-Advanced-Player-Stats.jar
└── NSR-AI-Advanced-Player-Stats/
├── playerprivacy/
│ └── <玩家名称>-.yml
└── privacy.yml
```
---
**需要帮助或发现错误？** 在下方评论并我会尽快回复！