SusMenu

A menu of the players your anti-cheat has flagged. Click one and you go into spectator and teleport to them.

Type /sus and you get a menu of suspicious players who are online right now, most flagged first. Each one shows up as their player head with:

• their name
• how many times they've been flagged
• why they're sus (the checks they've flagged, like Fly x8, Speed x3)
• the last check that flagged them

Click a head and you're put in spectator mode and teleported to that player.

Supported anti-cheats

• Grim
• Vulcan
• Matrix
• Spartan

Pick the one you use in config.yml. The default is Grim. You need the anti-cheat installed, SusMenu doesn't detect cheats on its own.

Commands

/sus opens the menu.

/sus reload reloads the config.

Permissions

• susmenu.use lets you open the menu (op by default)
• susmenu.reload lets you use /sus reload (op by default)

Config

# Which anti-cheat to read flags from: grim, vulcan, matrix or spartan
anti-cheat: grim

# Optional. Leave blank to auto-detect the anti-cheat's flag event.
# Only fill this in if the console says it couldn't find the event.
# Example: event-class: "me.frep.vulcan.api.event.VulcanFlagEvent"
event-class: ""

A player only shows up in the menu with at least this many flags

min-flags: 1

Flags older than this many minutes are forgotten (0 = never forget)

flag-expire-minutes: 60

How many different reasons to list on each player head

max-reasons: 5

Menu title

menu-title: "Sus Menu"

Leave blank for the default prefix: "[SUS]"

prefix: ""

Colors: <#RRGGBB> or &c style codes

messages: no-permission: "You don't have permission." players-only: "Only players can use this." nobody: "Nobody is sus right now." spectating: "Now spectating {target}." target-offline: "That player is no longer online." reloaded: "Config reloaded."

## Things to know

- Flags are counted by SusMenu starting from when it loads, so a fresh restart starts the count over.
- Only players who are online show up, since you can't spectate someone who left.
- The menu shows up to 54 players at a time.
- When the server starts, check the console for a line saying SusMenu hooked into your anti-cheat. If it says it couldn't find the flag event, set `event-class` in the config or leave a bug on github and I'll sort it out.

## Compatibility

Works on Paper, Purpur, Spigot, Bukkit and Folia, from 1.21.11 up. Needs Java 21 or newer.

Made by justkillercam