AntiLitematica

AntiLitematica

The ultimate Litematica / Schematica / Printer detection plugin for Paper/Spigot

---

Overview

AntiLitematica is a powerful server-side plugin designed to detect and prevent the use of Litematica, Schematica, and their Printer features on your Minecraft server. It operates entirely server-side — no client mod installation required.

With deep ProtocolLib integration, graduated punishment system, and Geyser (Bedrock) compatibility, AntiLitematica provides robust protection while keeping false positives to a minimum.

---

Features

• Network Channel Detection — Detects Litematica (via servux:litematics) and Schematica (via schematica) channel registration and payloads.
• ProtocolLib Deep Inspection — Catches EasyPlace protocol abuse, debug NBT queries, and custom payload fingerprints even when players disable Servux sync.
• Anti-Printer Engine — Multi-layered block placement analysis:
• Enforced raytrace (players must look at blocks they place)
• Placement rate limiting
• Consecutive same-type block detection
• No look-change detection (bots don't micro-adjust aim)
• Command Guard — Blocks rapid command execution and /setblock spam commonly used by schematic quick-paste.
• Graduated Punishment System — Escalating penalties: Warn → TempBan → Ban. Supports LiteBans, AdvancedBan, and EssentialsX.
• Geyser Compatible — Automatically exempts Bedrock players from all checks to prevent false positives from protocol translation.
• Discord Webhook — Send rich embed alerts to your staff Discord when detections or punishments occur.
• Anti-Cheat Integration — Optional GrimAC integration to feed violations into your existing anti-cheat.
• Dynamic Thresholds — Auto-adjusts detection sensitivity based on server TPS and online player count.
• In-Game GUI Config — Manage all settings through an intuitive inventory GUI with live reload.
• PlaceholderAPI Support — Exposes placeholders for external plugins.

---

How It Works

1. When a player joins, the plugin monitors registered plugin channels. If servux:litematics or schematica is detected, action is taken immediately.
2. ProtocolLib intercepts suspicious packets (abnormal hit vectors, NBT queries) that are strong indicators of Litematica's EasyPlace or Printer.
3. The Anti-Printer engine analyzes every block placement for inhuman patterns (too fast, no raytrace, no camera movement).
4. All checks respect the antilitematica.bypass permission and skip Geyser Bedrock players automatically.

---

Commands

/antilitematica reload    — Reload configuration
/antilitematica gui       — Open configuration GUI
/antilitematica status    — View current settings
/antilitematica reset <player>   — Reset violation record
/antilitematica history <player> — View violation history
/antilitematica update    — Check for updates

Alias: /al

---

Permissions

antilitematica.admin    — Access to all commands
antilitematica.bypass   — Bypass all detection checks
antilitematica.notify   — Receive staff alert messages

---

Dependencies

• Required: ProtocolLib
• Soft-Depends: PlaceholderAPI, Geyser, LiteBans, AdvancedBan, EssentialsX

---

Configuration

All settings are stored in config.yml and messages.yml. Key sections:

• detection — Channel list, action type (LOG/KICK/BAN/COMMANDS), ProtocolLib signals
• anti_printer — Raytrace, rate limits, pattern detection thresholds
• command_guard — Blocked commands and burst limits
• graduated_punishment — Escalation levels and durations
• geyser_compat — Enable/disable Bedrock player exemption
• discord — Webhook URL and notification settings

---

Compatibility

• Server software: Paper, Spigot, Purpur (1.12.2+)
• Java: 8+
• Geyser/Floodgate: Fully supported, Bedrock players auto-exempted

---

Support

For bug reports, feature requests, or general support, please use the discussion section below.

> By using this plugin you agree to anonymous bStats metrics collection. You can disable this in the configuration.