Threshold | Grief Protection v1.0.0

Threshold
Threshold watches for the actions that grief and exploit attempts have in common: doing something too fast, too many times, in too short a window. Three checks run per world, each can be switched on or off without touching the others, and every flag is logged so you can see exactly what happened.

Built for: Survival, SMP, and any server that wants grief protection without a heavy anti-cheat.

Three checks, one per risk

Block placement abuse catches fast-place grief and world-fill scripts. Container duplication attempts catches rapid item movement inside chests and other storage. Command spam abuse catches rapid command execution used to lag the server or brute-force something. Each check counts a player's actions in a sliding window and flags them once they go over the limit.

Per-world control, not all-or-nothing
Turn any single check off for one world without touching the others. A creative build world can allow fast block placement while the survival world keeps every check on. Toggle from the admin panel or with /threshold toggle <check> <world> on|off.

Admin panel

Open /threshold as an admin for a control panel: a toggle icon for each check showing its current limit, window, and action, a recent flags list for the world you are viewing, and a world selector to cycle through every world on the server. Click a check to flip it on or off for that world instantly.

Warn, log, or kick
Set what happens when a check flags a player: warn them and record it, log it quietly to console and the flag list, or kick them outright. Each check picks its own action.

Flag log

Every flag records who, which check, what happened, and when. Check the last flags for any world with /threshold flags, or see them live in the admin panel. The log saves to disk and survives a restart.

Features

• Three sliding-window checks: block placement, container duplication, and command spam.
• Per-world enable and disable for every check, independent of the others.
• Configurable limit and window for each check, plus a warn, log, or kick action.
• Admin panel with live toggles, a flag list, and a world selector.
• Flag log saved to disk, kept per world, survives a restart.
• threshold.bypass permission to fully exempt trusted staff or bots.
• Full tab completion for every command and subcommand.
• Config auto migration and an in-game reload, no restart needed.

Commands

• /threshold or /threshold gui - open the admin panel (admin only).
• /threshold help - list the commands.
• /threshold status [world] - show which checks are on or off for a world.
• /threshold checks - list every check with its limit, window, and action.
• /threshold toggle <check> <world> [on|off] - enable or disable a check for a world.
• /threshold flags [world] - show the most recent flags for a world.
• /threshold support - show the support Discord link.
• /threshold reload - reload the config and messages.

Aliases: /thr, /guard.

Permissions

• threshold.use - status, checks, and support. Default: everyone.
• threshold.admin - open the panel, toggle checks, view flags, and reload. Default: operators.
• threshold.bypass - exempt this player from all checks. Default: nobody.

Requirements

• Minecraft 1.21 to 26.1.2.
• Paper, Spigot, or Bukkit.
• Java 21.

Installation

1. Drop Threshold-1.0.0.jar into your plugins folder.
2. Start the server once to generate config.yml.
3. Adjust limits, windows, and actions to taste, then run /threshold reload.

Try it first
Threshold is live on our test server, hosted here on BuiltByBit. Use the test server link on this page to connect and try the panel and every check yourself.

Support
Questions and bug reports are welcome. Join the No Click Studios Discord at https://discord.gg/drBwA958bn.