GherrixDevPlugins & Resources

Official documentation

ComplexityAntiCheats

ComplexityAntiCheats is a packet-based anti-cheat for Paper and Folia. It monitors movement, combat, inventory, block and packet behavior while keeping world access on the correct server scheduler.

View productGet support
ComplexityAntiCheats cover

Getting started

Installation

  1. 1

    Stop the Minecraft server completely.

  2. 2

    Install EntityPacketBridge 1.1.0 or newer in the plugins folder.

  3. 3

    Place ComplexityAntiCheats.jar inside the plugins folder.

  4. 4

    Optionally install FoliaNPC for combat probes and NetworkClientGuardPaper for client integration.

  5. 5

    Start the server and review plugins/ComplexityAntiCheats/config.yml.

  6. 6

    Begin with log-only enabled, review violations.tsv and calibrate thresholds before enabling punishments.

Supported environments

Compatibility

1.5.0Plugin version
1.20.x - 1.21.xMinecraft
Paper / FoliaServer software
Java 17 or newerRuntime

Integrations

Dependencies

EntityPacketBridge 1.1.0+

Required

Provides the packet layer used by every anti-cheat check.

FoliaNPC

Optional

Enables NPC-based combat probes.

NetworkClientGuardPaper

Optional

Adds client guard integration on the Paper/Folia server.

NetworkPunishments

Optional

Forwards kick and ban actions to a Velocity proxy.

Reference

Commands

Administration commands

CommandDescriptionPermission
/cac statusShows the anti-cheat service and check status.complexityanticheats.admin
/cac reloadReloads the anti-cheat configuration.complexityanticheats.admin
/cac guiOpens the administration interface.complexityanticheats.admin

Access control

Permissions

PermissionDefaultDescription
complexityanticheats.adminOperatorsAllows administration commands and receives anti-cheat alerts.
complexityanticheats.bypassNobodyExcludes a player from anti-cheat checks.

Server setup

Configuration notes

  • Available profiles are lenient, normal and strict.
  • Adaptive checks can reduce violation levels when player ping or server tick time is unstable.
  • Movement, environment, packet, combat, inventory, item-use and block checks can be tuned separately.
  • violations.tsv stores check evidence and should not be shared publicly without anonymizing player data.

Important notes

  • The /cac command also supports the /nac alias.
  • Release 1.5.0 was smoke-tested on Folia 26.1.2 with EntityPacketBridge 1.2.0.
  • Always calibrate checks with real players before enabling automatic kicks or bans.

Visual guide

Images

ComplexityAntiCheats logo
ComplexityAntiCheats 1.5.0 cover