- 版权类型
- 原创
- 插件中文名称
- op白名单
- 插件英文名称
- InkWhitelistOp
- 原帖地址
- #
- 支持的核心（服务端）
- Spigot
- Paper
- Folia
- Purpur
- PufferFish
- SpongeVanilla
- Leaves
- 其他核心
- 语言支持
- 中文（简体）
- 适配版本（Java）
- 1.12
[MD]
### 🎯 插件简介
InkWhitelistOp（墨迹 OP 白名单）用于限制服务器 OP 权限仅可由白名单成员持有。
插件会在玩家进服与定时巡检时校验 OP 身份，非白名单 OP 会被自动移除权限并踢出，防止误授 OP 或被恶意提权后长期驻留。
---
### ✨ 功能特性
- 🛡 **OP 守卫** : 进服即查 + 定时轮询双重校验
- 🚫 **自动处置** : 非白名单 OP 自动取消 OP 并踢出
- 🗂 **白名单持久化** : `players.yml` 保存 `玩家名:UUID` 映射
- 🧾 **审计日志** : 关键操作与处置动作可追踪
- 🔁 **热重载** : 支持命令重载配置与任务
- 🧩 **命令别名** : 主命令 `inkwhitelistop`，别名 `iop`
---
### 📦 命令列表
| 命令 | 说明 | 权限 |
|---|---|---|
| `/inkwhitelistop reload` | 重载配置与守卫任务 | `ink.whitelistop.admin` |
| `/inkwhitelistop add <玩家名称>` | 添加 OP 白名单（仅控制台） | `ink.whitelistop.admin` |
| `/iop reload` | 同上（别名） | `ink.whitelistop.admin` |
| `/iop add <玩家名称>` | 同上（别名，且仅控制台） | `ink.whitelistop.admin` |
---
### 🔑 权限节点
| 权限 | 说明 | 默认 |
|---|---|---|
| `ink.whitelistop.admin` | 管理命令权限（reload/add） | op |
---
### 🧾 配置示例（config.yml）
```yml
# 配置版本（用于后续升级迁移提醒）
config-version: 1
action:
# 非白名单 OP 被移除权限后的踢出消息（支持 & 颜色）
kick-message:
- "&c你没有通过 OP 白名单校验，已移除 OP 权限。"
- "&7如需恢复，请联系服务器管理员。"
check:
# 检查周期（单位: tick，20tick=1秒）
interval-tick: 40
```
### 🧾 白名单示例（players.yml）
```yml
whitelist:
# 独立玩家白名单，格式为：玩家名称:UUID
# 支持半角/全角冒号，UUID 可留空（仅按名称匹配）
players:
- "Notch:069a79f4-44e9-4726-a5be-fca90e38aaf5"
- "AdminPlayer:"
```
---
[/MD]
