OPList

# OPList - Intelligent OP Permission Guardian Plugin # OPList - 智能OP权限守护插件 !(https://img.shields.io/badge/Minecraft-1.21-blueviolet?style=flat-square) !(https://img.shields.io/badge/Spigot-API%207.0%2B-yellow?style=flat-square) ## 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<br>• Player names must be enclosed in single quotes<br>• Each ID should start with a dash and be on a separate line | | **Example** | `- 'AdminSteve'` allows player AdminSteve to hold OP permissions | | 属性 | 说明 | |-------------|--------------------------------------------------------------------| | **功能** | 白名单系统，定义允许拥有OP权限的玩家 | | **格式** | YAML列表格式 | | **注意事项** | • 严格区分大小写<br>• 使用单引号包裹玩家名<br>• 每个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 <player> 24h 非法获取OP权限` | | **Permission Requirement** | Ensure the plugin has permission to execute the target command | | 属性 | 说明 | |-------------|--------------------------------------------------------------------| | **功能** | 定义检测到非法OP时执行的命令 | | **占位符** | `{player}` 自动替换为违规玩家名称 | | **扩展应用**| 可配置为其他处罚命令，如：`tempban <player> 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., `<br>&c &6{player} &e已被系统自动封禁` | | 属性 | 说明 | |--------------|--------------------------------------------------------------------| | **功能** | 定义全服广播的消息内容 | | **颜色代码** | 支持`&`符号的十六进制颜色代码（需客户端支持） | | **占位符** | `{player}` 自动替换为违规玩家名称 | | **排版建议** | 使用颜色代码分段强调关键信息，例如：<br>`&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