EP Reports

EPReports

A modern yet user-friendly and simple player reporting system with nice graphical menus and Discord webhooks.

Works on Paper · Spigot · Bukkit · Purpur · Folia (Minecraft 1.19 – 1.21+)

---

About

EPReports lets players report others through a clean, fully customizable glass-bordered GUI. Reports are stored locally (or in a database) and sent to Discord via webhook with rich embeds. Designed for public release: multi-language, rate-limited, and admin-friendly.

---

Features

• Modern glass-bordered GUI (main → player select → reason → confirm)
• Discord webhook with rich embeds (reporter, target, reason, location, server info)
• 6 languages out of the box: English, Turkish, Chinese, Russian, French, German
• Pre-defined reasons + custom reason via chat
• Rate limiting (cooldown + window limit) with admin bypass
• Storage backends: YAML (default), SQLite, MySQL, MariaDB
• In-game admin report viewer (/reports)
• Fully customizable menus via menu/*.yml
• Configurable command aliases (rapor, report, reports, …)
• Sound effects
• Folia-safe schedulers
• No punishment system — report only

---

Commands

Command	Description
/report	Open the report menu
/report <player>	Open reason menu for a player
/report <player> <reason>	Send a report directly
/report list / /reports	Admin report viewer
/report reload	Reload config & languages

---

Permissions

Permission	Default	Description
epreports.report	true	Submit reports
epreports.view	op	View stored reports
epreports.reload	op	Reload configuration
epreports.admin	op	Full admin + rate-limit bypass

---

Quick Setup

1. Drop the JAR into plugins/
2. Start the server
3. Set webhook-url in config.yml
4. (Optional) Set language: "en" / "tr" / …
5. /report reload

That’s it.

---

Requirements

• Minecraft: 1.19 – 1.21+
• Java: 21+
• Server: Paper, Spigot, Bukkit, Purpur, or Folia
• Discord webhook URL (required for Discord delivery)

---

Configuration highlights

• Language selection
• Server name / ID for embeds
• Cooldown & rate limits
• Embed title, color, footer, role mention, thumbnail
• Pre-defined report reasons
• Storage type (yaml / sqlite / mysql / mariadb)
• Custom command aliases
• Per-menu YAML files (titles, sizes, materials, slots, lore)

Full documentation: see WIKI.md inside the project / release.

---

Links

• Author: ElderPlayer
• License: All rights reserved

---

EPReports — clean reports, clean GUI, Discord-ready.