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: "<red>Sus Menu"

# Leave blank for the default prefix: "<gray>[<red>SUS<gray>]"
prefix: ""

# Colors: <red> <green> <gold> <orange> <#RRGGBB> <bold> <reset> or &c style codes
messages:
  no-permission: "<red>You don't have permission."
  players-only: "<red>Only players can use this."
  nobody: "<green>Nobody is sus right now."
  spectating: "<gray>Now spectating <white>{target}<gray>."
  target-offline: "<red>That player is no longer online."
  reloaded: "<green>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