📋 ReportWebhook - Simple Player Reports for Minecraft

---

🔍 What is ReportWebhook?

ReportWebhook is a lightweight plugin for Minecraft servers using Paper, Spigot, or Bukkit. It allows players to report others by typing a simple command /report. When a report is made, it sends a clean and easy-to-read message to a Discord channel using webhooks. This helps server admins keep track of players who may be breaking the rules.

The plugin is built to be safe, without showing exact player locations, and works smoothly on modern Minecraft servers, especially version 1.21 and above.

---

🎯 Key Benefits

• Easy Player Reports: Players only need to type /report followed by the name and reason.
• Discord Integration: Reports appear instantly in your chosen Discord server as neat message cards (called embeds).
• Privacy Safe: Does not share coordinates to protect player locations.
• Fast and Reliable: Runs without slowing down your server by working asynchronously (in the background).
• Updated for Modern Servers: Made for Minecraft Paper servers 1.21 and later.

---

💻 System Requirements

Before installing, make sure your setup meets these needs:

• Minecraft server running Paper, Spigot, or Bukkit software.
• Server version 1.21 or later is strongly recommended.
• Java 21 or a compatible recent Java version installed on your server.
• A Discord server where you can create webhooks (a few minutes setup required).
• Basic access to install plugins on your Minecraft server.

---

🛠 Features at a Glance

• Command: Players use /report <player> <reason> to send reports.
• Discord Webhook: Sends professional-looking messages with clear details.
• Privacy: No location or coordinate details leak in reports.
• Async-Safe: Works in the background without interrupting gameplay.
• Easy Configuration: Simple setup for your Discord webhook URL and message style.

---

🚀 Getting Started

Follow these steps to get ReportWebhook up and running on your server.

Step 1 – Download the Plugin

You can download the latest version of ReportWebhook here:

Visit this page to download the plugin .jar file. Look for the newest release and download the .jar file. This file is the actual plugin that runs on your Minecraft server.

Step 2 – Install the Plugin on Your Server

1. Locate your Minecraft server folder on your computer or hosting service.
2. Open the plugins folder inside your server directory.
3. Drag and drop the downloaded ReportWebhook .jar file into the plugins folder.

Step 3 – Configure the Plugin

1. Start your Minecraft server.
2. ReportWebhook will create a folder named ReportWebhook inside your plugins folder.
3. Open the configuration file (config.yml) inside that folder with a text editor (Notepad or similar).
4. Set your Discord webhook URL (you will create this in your Discord server) in the config file.
5. Save the file and restart your Minecraft server to apply the settings.

---

📥 Download & Install

Download the latest ReportWebhook plugin by visiting this page:

https://github.com/PanPizza15/ReportWebhook/releases

On this page:

• Find the most recent release version.
• Look for a file ending in .jar.
• Click to download this .jar file.
• Put this file in your server’s plugins folder.

Once the plugin is installed and configured, start your server and your players can begin reporting with /report.

---

⚙ How to Use ReportWebhook

Once installed and configured, here is how players and admins use the plugin.

For Players

• Use the command:

  /report <playername> <reason>
  

• For example:

  /report Griefer123 Using hacks
  

• This sends a report to Discord, notifying moderators.

For Server Admins

• Receive real-time Discord notifications with clean, easy-to-understand messages.
• View who reported whom, and the reason, all in a professional embed format.
• Use this information to investigate and act on rule breakers quickly.

---

🔧 Plugin Configuration Tips

Here are some tips to configure ReportWebhook smoothly:

• You must create a Discord webhook URL in your Discord server channel where reports will be sent.
  To do this, go to the channel settings > Integrations > Webhooks > New Webhook. Copy the webhook URL and paste it into config.yml.

• You can customize the message formats and choose whether to include certain details in reports via config settings.

• Keep your plugin updated regularly by visiting the releases page to get the latest fixes and features.

---

❓ FAQ

Q: Does this plugin work on all Minecraft servers?
A: It works on Paper, Spigot, and Bukkit servers, mainly tested on version 1.21 and newer.

Q: Can players see the coordinates of reported players?
A: No, ReportWebhook purposely avoids sharing location details to protect privacy.

Q: What if I don’t have Discord?
A: Since reports send directly to Discord webhooks, you’ll need a Discord server to receive and view reports.

---

📂 Additional Resources

• Official Releases: https://github.com/PanPizza15/ReportWebhook/releases
• PaperMC Server Software: https://papermc.io
• SpigotMC Community: https://www.spigotmc.org
• Discord Webhook Setup Guide: https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks

---

🧑‍💻 Support and Contribution

If you have questions or run into issues:

• Visit the GitHub repository issues page to see if your problem has been addressed.
• Open a new issue if you need help or want to report bugs.
• You can also suggest new features or improvements.

---

Thank you for using ReportWebhook to help keep your Minecraft server safe and well-moderated.