# OPList - Intelligent OP Permission Guardian Plugin
# OPList - 智能OP权限守护插件
## Plugin Overview
## 插件概述
A smart OP permission monitoring system that detects OP permission changes in real-time. When an unauthorized player obtains OP permissions, the plugin will automatically perform the following actions:
一个智能的OP权限监控系统，实时检测服务器中的OP权限变动。当检测到未授权的玩家获取OP权限时，将自动执行以下操作：
- Immediately revoke illegal OP permissions
- Execute preset ban commands
- Broadcast warning messages to all players
- Log security events to the console
- 立即撤销非法OP权限
- 执行预设的封禁命令
- 向全服玩家发送警示广播
- 记录安全事件到控制台
## Key Features
## 主要功能
- 🛡️ Real-time OP permission monitoring
- 🛡️ 实时OP权限监控
- ⚡ Automatic execution of security measures
- ⚡ 自动执行安全措施
- 📢 Visual alert notifications
- 📢 可视化警报通知
- 🔧 Highly customizable configuration
- 🔧 高度可定制化配置
- 📅 Supports all versions of modern Minecraft servers
- 📅 支持全版本现代Minecraft服务端
## Configuration File Explanation (`config.yml`)
## 配置文件详解 (`config.yml`)
```yaml
# List of players allowed to retain OP permissions
# 允许保留OP的玩家名单
allowed_ops:
- 'trusted_admin'
# Custom command to execute when an illegal OP is detected (use {player} as a placeholder)
# 当发现非法OP时执行的自定义命令（可用 {player} 作为占位符）
custom_command: 'ban {player} 非法获取管理员权限'
# Broadcast message after banning (use {player} as a placeholder)
# 封禁后的广播消息（可用 {player} 作为占位符）
broadcast_message: '&c玩家 &6{player} &c因非法获取OP权限已被封禁！'
```
### Configuration Item Details
### 配置项说明
#### 1. Authorized List Configuration
#### 1. 授权名单配置
```yaml
allowed_ops:
- 'trusted_admin'
```
| Attribute | Description |
|-----------|-------------|
| **Function** | Whitelist system to define players allowed to have OP permissions |
| **Format** | YAML list format |
| **Notes** | • Case-sensitive
• Player names must be enclosed in single quotes
• Each ID should start with a dash and be on a separate line |
| **Example** | `- 'AdminSteve'` allows player AdminSteve to hold OP permissions |
| 属性 | 说明 |
|-------------|--------------------------------------------------------------------|
| **功能** | 白名单系统，定义允许拥有OP权限的玩家 |
| **格式** | YAML列表格式 |
| **注意事项** | • 严格区分大小写
• 使用单引号包裹玩家名
• 每个ID独占一行并以短横线开头 |
| **示例** | `- 'AdminSteve'` 表示允许玩家AdminSteve持有OP权限 |
#### 2. Custom Command Configuration
#### 2. 自定义命令配置
```yaml
custom_command: 'ban {player} 非法获取管理员权限'
```
| Attribute | Description |
|-----------|-------------|
| **Function** | Define the command to execute when an illegal OP is detected |
| **Placeholder** | `{player}` automatically replaces the违规 player's name |
| **Extended Use** | Can be configured as other punishment commands, e.g., `tempban
24h 非法获取OP权限` |
| **Permission Requirement** | Ensure the plugin has permission to execute the target command |
| 属性 | 说明 |
|-------------|--------------------------------------------------------------------|
| **功能** | 定义检测到非法OP时执行的命令 |
| **占位符** | `{player}` 自动替换为违规玩家名称 |
| **扩展应用**| 可配置为其他处罚命令，如：`tempban 24h 非法获取OP权限` |
| **权限需求**| 确保插件拥有执行目标命令的权限 |
#### 3. Broadcast Message Configuration
#### 3. 广播消息配置
```yaml
broadcast_message: '&c玩家 &6{player} &c因非法获取OP权限已被封禁！'
```
| Attribute | Description |
|-----------|-------------|
| **Function** | Define the content of the server-wide broadcast message |
| **Color Codes** | Supports hexadecimal color codes with `&` symbol (client support required) |
| **Placeholder** | `{player}` automatically replaces the违规 player's name |
| **Formatting Suggestion** | Use color codes to emphasize key information, e.g., `
&c[Alert] &6{player} &e已被系统自动封禁` |
| 属性 | 说明 |
|--------------|--------------------------------------------------------------------|
| **功能** | 定义全服广播的消息内容 |
| **颜色代码** | 支持`&`符号的十六进制颜色代码（需客户端支持） |
| **占位符** | `{player}` 自动替换为违规玩家名称 |
| **排版建议** | 使用颜色代码分段强调关键信息，例如：
`&c[警报] &6{player} &e已被系统自动封禁` |
## Installation Guide
## 安装指南
- Download the latest version of the plugin
- Place the JAR file into your server's `plugins/` directory
- Restart your server to generate the configuration file
- Edit `plugins/config.yml` to configure settings
- Reload the configuration file or restart your server to apply changes
- 下载最新版本插件
- 将jar文件放入服务器的`plugins/`目录
- 重启服务器生成配置文件
- 编辑`plugins/config.yml`进行配置
- 重载配置文件或重启服务器生效
## Notes
## 注意事项
**🎨 Color Codes**
**🎨 颜色代码**
Examples of color codes supported in broadcast messages:
广播消息支持的颜色代码示例：
- `&4` Dark Red (深红)
- `&c` Red (红色)
- `&6` Gold (金色)
- `&e` Yellow (黄色)
- `&a` Green (绿色)
**📜 Log Tracking**
**📜 日志追踪**
All security events are logged in the console with the format:
所有安全事件都会在控制台记录，格式：
`[OPList] Handled illegal OP player [Name: 1, Online: No, Original OP Status: Yes]`
`[OPList] 已处理非法OP玩家 [名称: 1, 在线: 否, 原OP状态: 是]`
