§1 · SUBJECT
REV
1.0.2 stable
PLATFORM
Paper / Purpur 1.21.10
RUNTIME
Java 21
CHECKS
39 · 29 on · 10 experimental
STORAGE
SQLite · PostgreSQL · MariaDB

Every flag comes with its evidence.

FlagForge is a server-side anti-cheat and item-flow integrity plugin for Paper and Purpur. It records what each player did, checks it against what the server allows, and hands staff the reasoning, not just a verdict.

EXHIBIT A

64 diamonds nobody accounted for

A player's inventory gained items that no recorded action explains. The finding doesn't stop at "suspicious": it says what happened just before.

Sample finding. The player, plugin and values are invented; the field names are FlagForge's.

/ff finding 1874 inventory.reconciliation.a · HEURISTIC
player
Steve_42
gained
64 × minecraft:diamond
explained by
nothing recorded
recentPluginInventory
KitsPlus (KitMenuHolder)
recentPluginInventorySecondsAgo
4
recentCommand
/kit
itemTags
kitsplus
> declare it with recordItemTransaction and this stops
§2 · EVIDENCE INDEX

All 39 checks, in the open

CHECKEVIDENCEDEFAULTWHAT IT CATCHES
economy.item_gain_rate.aANOMALYenabledSoft per-material gain-rate anomaly (notify only)
economy.item_gain_rate.bHEURISTICenabledHard per-material gain-rate ceiling
inventory.reconciliation.aHEURISTICenabledItems gained that no recorded action explains
inventory.illegal_stack.aSERVER_IMPOSSIBLEenabledA stack larger than the item allows
inventory.illegal_item.aSERVER_IMPOSSIBLEenabledDenylisted items such as command blocks and barriers
inventory.transaction_burst.aHEURISTICenabledAbnormal inventory-transaction rate
movement.speed.aANOMALYenabledHorizontal speed beyond a mechanics-aware envelope
movement.flight.aHEURISTICenabledSustained unsupported airborne movement
movement.nofall.aHEURISTICenabledFall distance and damage that don't add up
movement.timer.aHEURISTICenabledMovement packets out of step with server time
movement.waterwalk.aANOMALYenabledStanding on fluid for too long
movement.elytra.aANOMALYenabledImpossible elytra acceleration
movement.step.aANOMALYexperimentalAn invalid instant upward step
movement.phase.aSERVER_IMPOSSIBLEexperimentalMoving through solid blocks
movement.suspicious_teleport.aANOMALYexperimentalA long teleport with no known cause
combat.reach.aANOMALYenabledHits beyond a latency-compensated reach, to the real hitbox
combat.attack_rate.aHEURISTICenabledSustained attack rate beyond a conservative ceiling
combat.multitarget.aHEURISTICenabledTwo targets hit from opposite directions at once
combat.bad_order.aPROTOCOL_INVALIDenabledA hit with no arm swing before it
combat.totem_swap.aANOMALYenabledA totem re-equipped implausibly fast
combat.line_of_sight.aANOMALYenabledA hit through a wall
combat.rotation.aHEURISTICexperimentalRepeated instant snaps onto a target
combat.autoclicker.aHEURISTICexperimentalUnusually regular click timing
combat.velocity.aANOMALYexperimentalIgnoring the knockback the server applied
world.fastbreak.aSERVER_IMPOSSIBLEenabledA block broken faster than the server's own minimum
world.nuker.aHEURISTICenabledSustained multi-block break rate
world.fastplace.aHEURISTICenabledSustained block-placement rate
world.interaction_reach.aANOMALYenabledBreaking blocks beyond a conservative reach
world.impossible_action.aSERVER_IMPOSSIBLEenabledPlacement beyond a hard ceiling
world.floating_place.aSERVER_IMPOSSIBLEenabledA block placed against nothing
world.tnt_prime_rate.aHEURISTICenabledPriming TNT implausibly fast (server-load protection)
world.scaffold.aHEURISTICexperimentalBridging while looking straight down
world.pearl_clip.aANOMALYexperimentalAn ender pearl that lands inside blocks
world.xray_ore_rate.aANOMALYexperimentalToo much valuable ore over a long window; statistical, not proof
packet.rate.aHEURISTICenabledA flood of combat or interaction packets
packet.sequence.aPROTOCOL_INVALIDenabledAttacking an entity the server never showed
packet.payload.aSERVER_IMPOSSIBLEenabledNaN or infinite movement coordinates
packet.payload.bPROTOCOL_INVALIDexperimentalPackets the crash guard caught
packet.inventory_state.aHEURISTICenabledAn inventory click the server can't classify
Full catalog with every parameter →
§3 · STANDING ORDERS

Rules FlagForge never breaks

  1. 01
    Enforcement is off until an admin turns it on.A fresh install only observes and reports. Kicks, setbacks and commands wait for your decision.
  2. 02
    Nobody bypasses by default.Not even operators. Exemptions are granted on purpose, scoped, and they expire.
  3. 03
    New checks ship disabled or experimental.An upgrade never starts flagging your players with something you haven't turned on.
  4. 04
    Each check has a response ceiling.No single check can do more than the most you allowed for it, however often it fires.
  5. 05
    Your plugins can explain themselves.Kits, crates and shops declare what they hand out through the API, so those gains aren't flagged.