Skip to content
SCULKANTICHEAT

Troubleshooting & FAQ

Work top to bottom — the first three sections cover most reports.

Sculk didn't load

Check the first lines of console after startup.

  • Unsupported server version — confirm your platform and version are in the supported range shown on the home page. Paper forks not listed there are untested.
  • Java version errors — Sculk needs Java 17+. Check with java -version.
  • No Sculk lines at all — the jar isn't in plugins/, or a file rename broke the .jar extension (Windows hides extensions by default).

A legitimate player got flagged

This is the report to take seriously — it's the failure Sculk is engineered against, and the logs make it diagnosable.

  1. Run /sculk logs <player> and look at which check flagged and at what VL.
  2. Low VL flags (well under max-vl) are working as intended: borderline moments flag, decay, and never punish. No action needed.
  3. Repeated flags on one check for players in one situation (a minigame, a custom item, an unusual block interaction) → raise that check's tolerance or add the world to exempt.worlds, and please report it so defaults can improve.
  4. Never hand out sculk.bypass as the fix — it removes all protection for that player.

Alerts are too noisy / too quiet

  • Noisy: raise alerts.min-vl-to-alert, or leave verbose mode off (/sculk verbose off — it's per-staff and easy to forget).
  • Quiet: lower min-vl-to-alert, and confirm your staff actually hold sculk.alerts and toggled /sculk alerts on.

Performance concerns

Sculk's checks run off the main thread; it should be near-invisible in a timings/spark report. If you see it high in a profile:

  1. Confirm settings.workers: auto (or that a pinned count isn't 1).
  2. Check whether another plugin is calling Sculk's API synchronously.
  3. Bring the profile to support — a real regression is a bug we want.

FAQ

Does Sculk work with ViaVersion / multi-version servers? Sculk tests against the version range published on the home page. Version-bridging plugins are common; report issues with your exact combination.

Does it conflict with other anticheats? Running two anticheats doubles false-flag risk and confuses evidence. Pick one.

Do players need to install anything? No. Sculk is entirely server-side.

Where do I get help fastest? The Discord — include your Sculk version, server platform/version, and the output of /sculk status.