🛡️ AdminAbuseDetector

Keep your server secure and transparent with real-time admin command monitoring!

AdminAbuseDetector is a powerful Bukkit/Spigot plugin designed to help server owners maintain transparency and detect potential admin abuse by monitoring suspicious command usage in real-time.

🚀 Key Features

📊 Comprehensive Command Monitoring

• Monitors critical admin commands: give, effect, summon, xp, gamemode, tp, teleport, kill, clear, enchant, setblock, fill, weather, time, difficulty
• Tracks commands from both players and console
• Real-time detection with zero performance impact

🔔 Multi-Channel Notifications

• Discord Integration: Beautiful embed notifications sent directly to your Discord server
• In-Game Alerts: Instant notifications to online staff members
• Console Logging: Detailed server logs with timestamps and command details

⚡ Advanced Discord Features

• Rich embed messages with color-coded alerts
• Detailed information including sender, command, timestamp, and server name
• Asynchronous webhook delivery to prevent server lag
• Professional formatting with emojis and structured fields

🔧 Easy Configuration

• Simple config.yml setup
• Just add your Discord webhook URL and you're ready to go
• No complex permissions or setup required

📋 How It Works

1. Detection: The plugin monitors all command executions in real-time
2. Analysis: Checks if the command matches the monitored list
3. Notification: Instantly sends alerts through multiple channels:
   • Discord webhook with detailed embed
   • In-game message to staff with adminabuse.notify permission
   • Server console log entry

🛠️ Installation & Setup

1. Download and place the plugin in your plugins folder
2. Start/restart your server
3. Edit plugins/AdminAbuseDetector/config.yml
4. Add your Discord webhook URL:

   discord:
     webhook-url: "https://discord.com/api/webhooks/YOUR_WEBHOOK_URL"
   

5. Reload or restart your server

🎯 Perfect For

• Server Owners who want to monitor staff activity
• Network Administrators managing multiple servers
• Community Servers maintaining transparency
• Competitive Servers preventing unfair advantages
• Any Server prioritizing fairness and accountability

📊 What Gets Monitored

The plugin tracks usage of these potentially game-changing commands:

• Item Commands: give, clear
• Player Effects: effect, gamemode
• World Manipulation: setblock, fill, weather, time, difficulty
• Entity Commands: summon, kill
• Player Commands: tp, teleport, xp

🔒 Security & Privacy

• Transparent Operation: No hidden features or backdoors
• Open Source Mindset: Clean, auditable code
• Permission-Based: Only staff members receive notifications
• Non-Intrusive: Doesn't interfere with normal server operations

📸 Discord Notification Example

When a monitored command is detected, you'll receive a professional Discord notification with:

• 🚨 Alert Header: "CHEAT COMMAND DETECTED!"
• 👤 Sender Info: Player name and type (Player/Console)
• ⚡ Command Details: Exact command that was executed
• 🕐 Timestamp: When the command was executed
• 🖥️ Server Name: Which server the command was used on

🎮 Compatibility

• Bukkit: ✅ Fully Compatible
• Spigot: ✅ Fully Compatible
• Paper: ✅ Fully Compatible
• Minecraft Versions: 1.8+ (tested up to latest)

🆘 Support

Need help? Have suggestions? Found a bug?

• Check the plugin documentation
• Review the configuration examples
• Report issues through the project page

📝 Permissions

• adminabuse.notify - Receive in-game notifications when commands are detected (default: OP)

---

⭐ If this plugin helps keep your server fair and transparent, consider leaving a review!

AdminAbuseDetector - Because transparency builds trust.