Перейти к содержимому
Mineforgian

AntiLitematica

Server plugin blocking Litematica's auto-place to prevent unfair building advantages.

Загрузки
517
Подписчики
1
Обновлён
22 мая 2026 г.
Лицензия
GPL-3.0-or-later

Опубликован 26 февраля 2026 г.

Исходный кодСообщить об ошибке

AntiLitematica

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

Version MC Version bStats

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.

Ченджлог

6.0.0Релиз26.1, 26.1.1, 26.1.2 · 22 мая 2026 г.

v6.0.0

New Features

  • World Whitelist -- Skip detection entirely in configured worlds (build/creative servers). Configurable via world_whitelist section.
  • Command Allowlist -- Exempt normal commands (/msg, /tell, etc.) from blocking via allowed_commands.
  • OneBot 11 (QQ Bot) Support -- Send detection notifications to QQ groups via LLBot/go-cqhttp HTTP API.
  • Web Dashboard SSE Real-Time Push -- Server-Sent Events push live updates to dashboard without manual refresh.
  • Web Dashboard Quick Settings -- Toggle detection, printer, command guard, graduated punishment, webhook directly from dashboard.
  • Violation Ranking API -- Top 20 violators ranking endpoint (/api/ranking), viewable in dashboard.
  • Admin Audit Log -- All admin actions logged to audit.log, viewable in Web Dashboard.
  • Batch Kick Command -- /al kickall kicks all currently flagged players.
  • Detection Statistics -- StatsTracker tracks daily detection/punishment counts and hit rates. Configurable retention.
  • Prometheus Metrics Endpoint -- /api/metrics exposes metrics for Grafana monitoring.
  • Auto-Detect Player Language -- 50+ Minecraft client locales auto-detected, messages in player's own language.
  • Language Files in lang/ Folder -- Clean plugin root, all messages_*.yml in lang/ subfolder.
  • JAR Auto-Replace -- Auto replaces running JAR with backup when downloading updates.
  • Public API -- AntiLitematicaAPI with DetectionEvent and PunishmentEvent.

Improvements

  • Configuration file reorganized into 14 numbered sections.
  • Config auto-migration bumped to v3 for all new fields.
  • pom.xml added release 21 to eliminate compiler warning.
  • Documentation: full wiki/ and docs/ structure, no emoji.
  • GitHub Actions CI: auto-build on push, release upload.

Bug Fixes

  • Fixed raw ConcurrentHashMap types in PlacementGuard
  • Fixed Discord webhook 307 redirect handling
  • Fixed Discord webhook hardcoded User-Agent
  • Removed outdated src/main/resources/META-INF/

Dependency Changes

  • No new dependencies. Vulcan/Matrix use runtime reflection. MySQL requires external Connector/J.
4.3.0-betaБета26.1, 26.1.1, 26.1.2 · 2 мая 2026 г.

Fix high false positive rates in PlacementGuard Convert GUI to single-page 54-slot inventory Remove gray glass from rows 1-5, keep only GrimAC Optimize GUI display text for zh_cn and en Fix block disappearance for Bedrock players (Geyser+Floodgate API, multi-threading) GUI reorganization with gray glass fillers Create 12 language files (zh_CN, en, zh_TW, fr, de, ja, ko, ru, es, pt, ar, vi) Redesign GUI according to user's detailed specification (detection settings, punishment, anti-cheat, anti-printer, webhook+dynamic+language, system settings)

4.2.1-betaБета26.1, 26.1.1, 26.1.2 · 1 мая 2026 г.

Reduced false positives by relaxing printer detection thresholds, made single placement warnings non-blocking, improved command burst tolerance, and kept repeated suspicious behavior detectable for real offenders.

4.1.1Релиз26.1, 26.1.1, 26.1.2 · 1 мая 2026 г.
  • Fixed an error caused by graduated punishments directly kicking/banning players in ProtocolLib async packet listening.
  • Punishment actions are now properly scheduled to run on the main thread, compatible with Paper/Spigot async safety checks.
4.1.0Релиз26.1, 26.1.1, 26.1.2 · 1 мая 2026 г.
  • Enhanced EasyPlace Detection: Implemented precise modeling for EasyPlace patterns instead of simple hitVec range checks.
  • PlacementGuard Upgrade: Added fine-grained printer mode recognition with statistical correlation analysis between placement direction and player facing.
4.0.0Релиз26.1, 26.1.1, 26.1.2 · 1 мая 2026 г.

Cross-version Support — Fully compatible with Minecraft 1.12.2 ~ 1.21+ - Update Checker — Automatically checks for the latest version from GitHub Releases and SpigotMC on startup

  • Automatic update reminder when staff join the server
  • Manual update check via /antilitematica update
    • Tab Command Completion — Supports tab completion for /antilitematica <reload|status|gui|update|reset|history>
  • Online player name completion for reset / history subcommands

Geyser Support

3.3.0Релиз26.1, 26.1.1, 26.1.2 · 30 апреля 2026 г.

Important

Please delete old configuration files before updating, old configs are incompatible with this version

Added

  • Added dynamic threshold adjustment function
  • Added brand new GUI interface
  • Full multilingual language support
3.1.0Релиз26.1, 26.1.1, 26.1.2 · 29 апреля 2026 г.

Graduated punishments with LiteBans/AdvancedBan support, enhanced projection placement detection, command spam guard, active servux blocking, and persistent SQLite violation tracking.

Комментарии

Загружаем…