AdminWatchdog

🌟 Overview

AdminWatchdog is a powerful Minecraft plugin designed to monitor and log administrative activities on your server. With real-time Discord notifications, rich embeds, and comprehensive logging, you'll never miss important server events again.

✨ Key Highlights

• 🔔 Real-time Discord Notifications - Instant webhook alerts for admin actions
• 🎨 Rich Embeds - Beautiful Discord embeds with item images and detailed information
• 🎯 Custom Command Responses - Configurable alerts for specific commands with role mentions
• 📊 Creative Inventory Tracking - Monitor items taken from creative mode
• 🔄 Auto-Updates - Built-in update checker keeps your plugin current
• 🛡️ Permission-Based Monitoring - Flexible monitoring based on permissions or OP status

📸 Screenshots

Discord Webhook Examples

Creative Inventory Monitoring

Command Execution Alerts

Custom Command Responses

Gamemode Change Notifications

🚀 Features

📡 Discord Integration

• Webhook Support - Send notifications to any Discord channel
• Rich Embeds - Beautiful formatted messages with item images
• Custom Responses - Configure specific messages for any command
• Role Mentions - Alert specific roles for critical actions

🔍 Monitoring Capabilities

• Command Monitoring - Track all admin commands
• Creative Inventory - Monitor items taken from creative mode
• Gamemode Changes - Log all gamemode switches
• Console Commands - Track server console activity
• Permission-Based - Monitor by OP status or specific permissions

⚙️ Configuration Options

• Flexible Monitoring - Choose what to monitor and log
• Command Blacklisting - Exclude sensitive commands from logs
• Time Formatting - Customizable timestamp formats
• Debug Mode - Verbose logging for troubleshooting

🔄 Additional Features

• Auto-Update Checker - Get notified of new releases
• File Logging - Local log files with rotation
• Tab Completion - User-friendly command interface
• Reload Support - Update configuration without restart

📦 Installation

1. Download the latest release from the Downloads Page
2. Place the JAR file in your server's plugins folder
3. Restart your server
4. Configure the plugin by editing plugins/AdminWatchdog/config.yml
5. Set up your Discord webhook URL
6. Reload the plugin with /adminwatchdog reload

🔧 Configuration

Basic Setup

# Discord Integration
discord:
  webhook-url: "YOUR_DISCORD_WEBHOOK_URL_HERE"
  enabled: true
  embeds:
    enabled: true
    creative-inventory: true
    color: "#00d4aa"

Custom Command Responses

Configure specific alerts for important commands:

custom-responses:
  enabled: true
  ban: "⚠️ **ADMIN ACTION** - %player% banned someone at %time%"
  op: "🔐 **CRITICAL** - %player% used OP command! <@&ROLE_ID> at %time%"
  gamemode: "🎮 **GAMEMODE** - %player% changed gamemode at %time%"

Monitoring Settings

monitoring:
  ops: true                    # Monitor operators
  console: true               # Monitor console commands
  gamemode-changes: true     # Monitor gamemode switches
  creative-inventory:
    enabled: true
    detailed-logging: true

🎯 Custom Command Responses

One of AdminWatchdog's most powerful features is the ability to configure custom Discord messages for specific commands:

Available Placeholders

• %player% - The player who executed the command (for player commands)
• %sender% - The sender who executed the command (for console commands)
• %command% - The full command that was executed
• %time% - Formatted timestamp

Discord Mentions

• <@USER_ID> - Mention a specific user
• <@&ROLE_ID> - Mention a specific role
• @everyone - Mention everyone

Example Configurations

custom-responses:
  enabled: true
  
  # Critical Commands (Player)
  op: "🔐 **CRITICAL** - %player% gave OP to someone! <@&123456789> %time%"
  deop: "🔐 **CRITICAL** - %player% removed OP from someone! <@&123456789> %time%"
  
  # Critical Commands (Console)
  "/stop": "🛑 **SERVER SHUTDOWN** - Console is stopping the server! <@&123456789> %time%"
  "/reload": "🔄 **SERVER RELOAD** - %sender% reloaded server at %time%"
  
  # Moderation Commands  
  ban: "⚠️ **BAN** - %player% banned a player at %time%"
  kick: "⚠️ **KICK** - %player% kicked a player at %time%"
  
  # World Management
  gamemode: "🎮 **GAMEMODE** - %player% changed gamemode at %time%"
  tp: "🌐 **TELEPORT** - %player% teleported at %time%"
  
  # Item Management
  give: "🎁 **GIVE** - %player% gave items to someone at %time%"

📋 Commands

Command	Permission	Description
/adminwatchdog	adminwatchdog.use	Show plugin information
/adminwatchdog version	adminwatchdog.use	Display plugin version
/adminwatchdog reload	adminwatchdog.reload	Reload configuration
/adminwatchdog update	adminwatchdog.update.check	Check for updates

🔑 Permissions

Permission	Description	Default
adminwatchdog.use	Basic plugin access	true
adminwatchdog.reload	Reload configuration	op
adminwatchdog.update.check	Check for updates	op
adminwatchdog.update.notify	Receive update notifications	op
adminwatchdog.monitor	Be monitored by the plugin	false

⚠️ Note: The source code is provided for reference only. Modification, redistribution, or reuse is prohibited under the license terms.

🤝 Contributing

Important: This project uses a proprietary license that restricts code modifications and reuse.

How to Contribute

• 🐛 Report Bugs - Open an issue describing the problem
• 💡 Suggest Features - Request new features with detailed descriptions
• 📖 Improve Documentation - Suggest documentation improvements via issues
• 🧪 Test Beta Versions - Help test pre-release versions

⚠️ Contribution Restrictions

• ❌ No code pull requests - Source code modifications are not accepted
• ❌ No forks for modification - Creating derivative works is prohibited
• ❌ No code suggestions - Direct code contributions cannot be merged
• ✅ Ideas and feedback welcome - Conceptual suggestions are appreciated

For special licensing arrangements or partnership opportunities, please contact me directly.

💡 Feature Requests

Have an idea for AdminWatchdog? Open an issue with the enhancement label!

📞 Support

Need help? Here's how to get support:

1. 📖 Check the Documentation
2. 🔍 Search Existing Issues
3. 💬 Join our Discord Server
4. 🐛 Create a New Issue

📄 License

This project is licensed under a Proprietary License - see the LICENSE file for details.

For licensing inquiries or special permissions, please contact me.

⭐ Show Your Support

If you found this plugin helpful, please consider:

• ⭐ Starring this repository
• 📢 Sharing with other server administrators
• ☕ Sponsoring on GitHub to support development

🙏 Acknowledgments

• Thanks to the Minecraft modding community
• Discord for their excellent webhook API
• TejasLamba2006

---