ReportPlugin - Minecraft Player Reporting System

# ReportPlugin - Professional Minecraft Player Reporting System

## Overview

**ReportPlugin** is a comprehensive Minecraft server plugin that provides players with an intuitive GUI-based system to report other players for rule violations. Reports are automatically sent to Discord via webhooks and can optionally be stored in a local SQLite database for record-keeping.

**Author:** SkullyDragon
**Version:** 1.0.0

## ✨ Features

### Core Features
- **User-Friendly GUI**: Clean, easy-to-use inventory interface for reporting
- **Multiple Report Categories**: Pre-defined reasons (Hacking, Griefing, Spamming, Harassment, Other)
- **Discord Integration**: Automatic webhook notifications to your Discord server
- **Permission System**: Configurable permissions for report usage
- **Anti-Self-Report**: Prevents players from reporting themselves

### Advanced Features
- **Optional Database Storage**: SQLite database for persistent report logging
- **Configurable Settings**: Extensive configuration options
- **Timestamp Tracking**: Automatic timestamp recording for all reports
- **Plugin Metrics**: Built-in logging and error handling

### Report Categories
- ️ **Hacking**: Report players using cheats or exploits
- **Griefing**: Report destruction of builds or property
- **Spamming**: Report excessive chat spam
- **Harassment**: Report toxic behavior or harassment
- ❓ **Other**: Custom reasons not covered above

## Installation

1. **Download** the plugin JAR file (`ReportPlugin-1.0.0.jar`)
2. **Place** the JAR in your server's `plugins` folder
3. **Restart** your Minecraft server
4. **Configure** the plugin (see Configuration section below)
5. **Restart** again to apply configuration changes

## ⚙️ Configuration

### Basic Configuration (`plugins/ReportPlugin/config.yml`)

```yaml
# Discord webhook URL for automatic report notifications
discord-webhook-url: " https://discord.com/api/webhooks/YOUR_WEBHOOK_ID/YOUR_TOKEN"

# Optional database storage
use-database: false # Set to true to enable SQLite database storage
database-file: "reports.db" # Database filename
```

### Permissions

Add these to your permissions plugin (LuckPerms, PermissionsEx, etc.):

```yaml
permissions:
report.use:
description: Allows players to use the /report command
default: true
```

## Usage

### For Players
1. Use the command: `/report <playername>`
2. Click on the desired report reason in the GUI
3. Your report is automatically submitted!

### For Server Administrators
- Reports appear instantly in your configured Discord channel
- If database is enabled, all reports are logged locally
- Monitor player behavior and take appropriate action

## Database Schema (Optional)

When database storage is enabled, reports are stored in this table:

```sql
CREATE TABLE reports (
id INTEGER PRIMARY KEY AUTOINCREMENT,
reporter TEXT NOT NULL, -- Player who made the report
target TEXT NOT NULL, -- Player being reported
reason TEXT NOT NULL, -- Report reason/category
timestamp DATETIME DEFAULT CURRENT_TIMESTAMP
);
```

## Commands

| Command | Description | Permission |
|---------|-------------|------------|
| `/report <player>` | Open report GUI for specified player | `report.use` |

## Premium Features & Support

This plugin is available for **FREE** with core features. For premium enhancements, custom development, or priority support:

### Contact Information
- **Discord:** .skully.dragon.
- **Author:** SkullyDragon

### Premium Services Available
- Custom report categories
- Advanced database integrations (MySQL, PostgreSQL)
- Web dashboard for report management
- Automated moderation actions
- Custom plugin development
- Priority bug fixes and updates

## Requirements

- **Java:** 8 or higher
- **Minecraft Server:** Spigot 1.16.5+ or Paper 1.16.5+
- **Dependencies:** None (all included)

## License

This plugin is proprietary software. Redistribution without permission is prohibited.

## Support

For support, feature requests, or premium services:
- Msg me Discord: .skully.dragon.
- Report bugs or issues through Discord

---

**Made with ❤️ by SkullyDragon**
*Professional Minecraft plugin development services available*