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 Printer, Printer, 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

- PlaceholderAPI Support — Detects Litematica (via `servux:litematics`) and Schematica (via `schematica`) channel registration and payloads. - PlaceholderAPI Support — Catches EasyPlace protocol abuse, debug NBT queries, and custom payload fingerprints even when players disable Servux sync. - PlaceholderAPI Support — 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) - PlaceholderAPI Support — Blocks rapid command execution and `/setblock` spam commonly used by schematic quick-paste. - PlaceholderAPI Support — Escalating penalties: Warn → TempBan → Ban. Supports LiteBans, AdvancedBan, and EssentialsX. - PlaceholderAPI Support — Automatically exempts Bedrock players from all checks to prevent false positives from protocol translation. - PlaceholderAPI Support — Send rich embed alerts to your staff Discord when detections or punishments occur. - PlaceholderAPI Support — Optional GrimAC integration to feed violations into your existing anti-cheat. - PlaceholderAPI Support — Auto-adjusts detection sensitivity based on server TPS and online player count. - PlaceholderAPI Support — 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

- Soft-Depends: Soft-Depends: - 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

- Geyser/Floodgate: Paper, Spigot, Purpur (1.12.2+) - Geyser/Floodgate: 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.