Grief Scan

GriefScan

Anti-grief scanner for suspicious player actions — one JAR for Paper, Spigot, and Folia (1.19–26.1).

GriefScan watches the usual grief patterns in real time: lava and TNT dumps, arson, chest breaking, villager kills, and players looting valuables from many distant containers. When something looks wrong, staff get an alert in console, admin chat, Discord, or an optional website webhook.

Features

• Configurable filters — place/break blocks and place/kill entities, with limits, time windows, worlds, and optional height ranges
• Anti-theft — flags suspicious valuables taken from many distant containers (own shulkers are ignored)
• Playtime exemption — skip trusted veterans (playtime: 30h)
• Auto-ban — optional ban after repeated violations
• Localization — en, ru, es, zh, hi, ar, fr, de, ja, pt
• SQLite persistence — violations stored in violations.db
• Alert cooldown / anti-spam — no Discord flood
• Bypass — griefscan.bypass plus exempt player/UUID lists
• Integrations — CoreProtect and LiteBans quick commands in Discord embeds
• Folia-safe scheduler
• Clickable teleport coords for admins (Adventure)
• */griefscan inspect * — session violation summary

Built-in filters

Filter · What it watches
LAVA_PLACEMENT · Placing lava
TNT_PLACEMENT · Placing TNT
ARSON · Setting fire
CHEST_BREAKING · Breaking chests / barrels
FRAME_BREAKING · Breaking item frames
VILLAGER_KILLING · Killing villagers

You can add your own filters in config.yml (armor stands, custom blocks, extra entities, etc.).

Installation

1. Download GriefScan.jar
2. Put it in plugins/
3. Start the server once to generate config and message files
4. Edit plugins/GriefScan/config.yml (Discord webhook, filters, worlds)
5. Run /griefscan reload

Supported servers: Paper / Folia / Spigot
Minecraft: 1.19.x, 1.20.x, 1.21.x, 26.1.x
Java: 17+ (use the JVM required by your server)

Soft-depends: CoreProtect, LiteBans

Commands

Aliases: /gs, /grief
Permission: griefscan.admin (default: op)

Command · Description
/griefscan reload · Reload config and messages
/griefscan status · Active filters and log stats
/griefscan toggle · Enable or disable a filter
/griefscan logs report · Write a violations report
/griefscan logs clear [player] · Clear all or one player's stats
/griefscan logs stats [player] · Overall or player violation stats
/griefscan antitheft status · Anti-theft status
/griefscan antitheft clear · Clear player anti-theft history
/griefscan antitheft clearall · Clear all anti-theft history
/griefscan language · Change language
/griefscan inspect · Session violation summary

Permissions

• griefscan.admin — all commands (default: op)
• griefscan.bypass — skip filters and anti-theft

Configuration

plugins/GriefScan/config.yml

language: en # en, ru, es, zh, hi, ar, fr, de, ja, pt

notify:
console: true
discord: true
webhook: 'discord.com/api/webhooks/...';
website: false

filters:
LAVA_PLACEMENT:
enabled: true
limit: 5
time_window: 30
blocks: [LAVA]
action: notify
worlds: [world]

anti_theft:
enabled: true
min_containers: 3
min_locations: 3
min_distance: 20
time_window: 300

auto_ban:
enabled: false
violations_threshold: 3

playtime: 30h