OPList - Intelligent OP Permission Guardian Plugin

OPList - 智能OP权限守护插件

!Minecraft
!Spigot

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)

# 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. 授权名单配置

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. 自定义命令配置

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. 广播消息配置

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[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状态: 是]