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 versionerrors — Sculk needs Java 17+. Check withjava -version.- No Sculk lines at all — the jar isn't in
plugins/, or a file rename broke the.jarextension (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.
- Run
/sculk logs <player>and look at which check flagged and at what VL. - Low VL flags (well under
max-vl) are working as intended: borderline moments flag, decay, and never punish. No action needed. - 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. - Never hand out
sculk.bypassas 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 holdsculk.alertsand 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:
- Confirm
settings.workers: auto(or that a pinned count isn't1). - Check whether another plugin is calling Sculk's API synchronously.
- 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.