QuickReport

Minecraft 版本： 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10

平台： bukkit paper purpur spigot

标签： game-mechanics management technology

QuickReport

A quick and efficient reporting system for Minecraft servers

? Description

QuickReport is a powerful and user-friendly reporting system designed for Minecraft servers. It allows players to report cheaters, rule-breakers, or any misconduct with ease, while providing administrators with comprehensive tools to manage and process reports efficiently.

✨ Key Features

• Easy Report Submission - Players can report others with a simple command
• Admin Review System - Accept or reject reports with customizable rewards
• Report History - Players can view their submitted reports
• Advanced Query System - Detailed report information for staff members
• Cooldown Protection - Prevents spam with configurable cooldown timers
• Clickable Messages - Interactive admin notifications with click-to-view functionality
• SQLite Database - Lightweight and efficient data storage
• Reward System - Automatically reward players for accepted reports
• Multi-Language Support - Built-in English and Turkish language support
• PlaceholderAPI Integration - Statistics and leaderboard placeholders

? Installation

1. Download the latest QuickReport-1.0.0.jar from the releases page
2. Place the JAR file in your server's plugins folder
3. Restart your server or use a plugin manager to load it
4. Configure the plugin by editing config.yml and messages.yml in the plugins/QuickReport/ folder
5. Reload the plugin with /reload confirm or restart the server

? Commands

Player Commands

Admin Commands

? Permissions

⚙️ Configuration

config.yml

# QuickReport Configuration File

# General Settings
report-cooldown-seconds: 60 # Cooldown for submitting new reports
max-reports-per-cooldown: 1 # Maximum reports within cooldown period

# Report Reasons (Tab-completion support)
report-reasons:
  - "Fly"
  - "KillAura"
  - "Speed"
  - "Xray"
  - "Griefing"
  - "Swearing"

# Admin Notification Settings
admin-permission: "quickreport.admin"
notification-sound: "ENTITY_EXPERIENCE_ORB_PICKUP"
notification-volume: 1.0
notification-pitch: 1.0

# Reward System Configuration
rewards:
  diamond-reward:
    name: "&bDiamond Reward"
    command: "give %player% diamond 5"
  money-reward:
    name: "&eMoney Reward"
    command: "eco give %player% 1000"
  key-reward:
    name: "&6Crate Key Reward"
    command: "crate give %player% common 1"

Customizing Report Reasons

Edit the report-reasons list in config.yml to add or remove valid reasons:

report-reasons:
  - "Hacking"
  - "Exploiting"
  - "Toxicity"
  - "Scamming"

Admin Notification Sound

Change the sound played to admins when a new report is submitted. See Spigot Sound List for available sounds.

? Reward System

The reward system allows you to automatically reward players when their reports are accepted.

Adding a New Reward

1. Open config.yml
2. Add a new reward under the rewards section:

rewards:
  custom-reward:
    name: "&aCustom Reward"
    command: "give %player% diamond_block 1"

3. Use the reward code when accepting a report:

/reportaction accept 123 custom-reward

The %player% placeholder will be replaced with the reporter's username.

? PlaceholderAPI Support

QuickReport integrates with PlaceholderAPI to provide statistics and leaderboard placeholders.

Available Placeholders

Usage Example

# In a scoreboard or hologram
&6Top Reporter: &e%quickreport_top_kabul_isim_1%
&7Reports: &a%quickreport_top_kabul_sayi_1%

? Multi-Language Support

QuickReport supports multiple languages out of the box. The primary language is English (en), with Turkish (tr) as a secondary language.

Customizing Messages

Edit messages.yml to customize messages:

messages:
  report-success:
    en: "&aYour report has been submitted successfully!"
    tr: "&aRaporunuz başarıyla gönderildi!"

Adding a New Language

1. Open messages.yml
2. Add your language code to any message:

messages:
  report-success:
    en: "&aYour report has been submitted!"
    tr: "&aRaporunuz gönderildi!"
    de: "&aDein Bericht wurde eingereicht!"

? Usage Examples

Player Workflow

1. Submit a report:

   /report Cheater123 Fly He was flying in spawn

2. Check your reports:

   /myreports

3. Query a specific report:

   /queryreport 5

Admin Workflow

1. View pending reports:

   /reports

2. Click on a report or use:

   /queryreport 5

3. Accept a report with reward:

   /reportaction accept 5 diamond-reward

4. Reject a report with reason:

   /reportaction reject 5 Insufficient evidence

? Report Status

Reports can have three statuses:

• PENDING - Awaiting admin review

• ACCEPTED - Approved by staff (reporter gets rewarded)

• REJECTED - Denied by staff

• Developer: Melut