## 🌐 概述
**IPViewer** 是一个适用于 [Paper](https://papermc.io/) Minecraft 服务器 _1.20_ 及更高版本的插件，专为服务器管理员和版主设计。它提供了一种简单的方式来查看玩家的 IP 地址，有助于服务器管理以及检测封禁规避或冒号账户。
所有技术设置和功能在此处均适用于插件的最新版本，并且可能无法在旧版本上工作。
## 🔍 特性
* 查看自插件安装以来加入服务器的所有玩家，以及他们的 IP 地址和最后出现时间
* 轻松过滤和搜索玩家 IP
* 检测跨多个帐户的共享 IP
* 帮助追踪封禁规避和可疑活动
## 📜 指令
以下是可以在插件中使用的所有指令：
* `/ipv help` - 显示所有可用的插件指令
* `/ipv reload` - 重新加载插件配置
* `/ipv list
` - 显示包含可选过滤器（例如，按 IP 或加入时间）的玩家列表
## 🪪 `/ipv list` 的过滤器
`/ipv list` 命令支持灵活的过滤器，以帮助您搜索和组织玩家的 IP 数据。所有过滤器可以在单个命令中一起使用。
| **过滤器** | **描述** |
|-------------------------------------|----------------------------------------------------------------------------------------------|
| `page:` 或仅 `` | 显示特定的结果页 (例如 `/ipv list 2` 或 `/ipv list page:2`) |
| `player:` | 按玩家名称过滤结果（支持部分匹配和通配符） |
| `ip:` | 按 IP 地址过滤（支持部分匹配和通配符） |
| `country:` | 按国家/地区名称或代码过滤（例如 `country:United States`） |
| `state:` | 按区域或州过滤（对于更细粒度的 IP 地理位置很有用，例如 `state:New York`） |
| `time:` | 仅显示在指定时间范围内的玩家（例如 `time:24h`、`time:30m`） |
### 🧠 通配符
使用文本 (`player`, `ip`, `country`, `state`) 的过滤器支持 SQL 风格的通配符：
* `%` - 匹配任何字符序列
* `_` - 匹配单个字符
### 📌 示例
```
/ipv list player:stev% ip:192.168.% time:7d page:3
```
此命令显示页码 `3` 的玩家，其名称以 `stev` 开头，IP 以 `192.168.` 开头，并且在过去 `7 天` 内出现过。
## 📁 配置
首次启动时会生成配置文件，您可以修改它以调整输出格式或其他插件设置。 可以在 [这里](https://github.com/MusiJVR/IPViewer/blob/main/src/main/resources/config.yml) 查看默认配置。
配置文件中的所有消息都使用 [MiniMessage](https://docs.advntr.dev/minimessage/) 格式，允许使用丰富的文本格式（颜色、渐变、粗体等）。您可以使用 [MiniMessage Viewer](https://webui.advntr.dev/) 预览和创建格式化的消息。
## ⚙️ 开发者和管理员设置
该插件具有权限：
| **权限** | **含义** |
|-----------------------------|---------------------------------------|
| `ipviewer.ipviewer` | 授予访问 `/ipv` 指令的权限 |
## ❗ 问题
请在 [这里](https://github.com/MusiJVR/IPViewer/issues) 或 [Discord](https://discord.gg/xY8WJt7VGr) 上留下任何您发现的错误消息。
## 💬 社交媒体
- 在 [Modrinth](https://modrinth.com/plugin/ipviewer) 上的页面
- 在 [GitHub](https://github.com/MusiJVR/IPViewer) 上的页面
- 在 [Discord](https://discord.gg/xY8WJt7VGr) 上的页面
