IllegalScanner

This plugin checks Minecraft items for banned or unsafe data. It scans worlds, chunks, players, inventories, and saved data.

Features

• Scan nearby chunks.

• Scan the current area around a player or location.

• Scan loaded chunks in the server.

• Scan one world.

• Scan all worlds.

• Scan offline players.

• Scan all loaded and saved data with the everything mode.

• Check item stacks for overstacking.

• Check item data for illegal enchantments.

• Check item data for bad attributes.

• Check item data for bad potion effects.

• Check item data for bad books and nested containers.

• Check item data for oversized compressed payloads.

• Check for unobtainable items.

• Check for custom item components that are not allowed.

• Watch mode checks players on join.

• Watch mode checks opened inventories.

• Watch mode checks picked up items.

• Watch mode checks dropped items.

• Watch mode checks creative inventory actions.

• Watch mode sends alerts to staff with the proper permission.

• Results open in an in-game menu.

• The menu lets staff filter results.

• The menu lets staff preview finding details.

• The menu lets staff go to the item location.

• The menu lets staff open the holder.

• Staff with the delete permission can remove flagged items.

• Each scan can write a report file.

• The config controls scan limits and ignored values.

• The config controls auto scans.

• The config controls default radius and watch severity.

Commands

• /illegals opens the main menu.
• /illegals scan nearby scans around online players.
• /illegals scan here scans around your current location.
• /illegals scan player NAME scans one player.
• /illegals scan world NAME scans one world.
• /illegals scan loaded scans loaded chunks.
• /illegals scan offline scans offline players.
• /illegals scan enderchests scans UnstableEC ender chests.
• /illegals scan everything scans all supported data.
• /illegals watch on turns watch mode on.
• /illegals watch off turns watch mode off.
• /illegals alerts opens recent alerts.
• /illegals reload reloads the config.

Permissions

• illegalscanner.use opens the scanner and scans.
• illegalscanner.alerts gets watch alerts.
• illegalscanner.delete removes flagged items.

Config

The config file sets the default scan radius, worker threads, read limits, max findings, max item bytes, ignored items, max enchant levels, watch settings, and auto scan settings.

Notes

This plugin is made for Paper and Folia server environments. It reads live chunk data in a safe way. It reads unloaded chunk data from disk in a controlled way. It avoids heavy work on the main server tick when possible.