Home

Vistructum

Vistructum detects swastikas that players build from blocks on Paper servers and reports them as findings for staff review. It never kicks, bans, or rolls back on its own.

The project ships two plugins:

Plugin	Jar	Purpose
vistructum	vistructum-<version>.jar	Core: detection, storage, public API. No commands.
vistructum-ui	vistructum-ui-<version>.jar	/vis command, review menu, staff chat alerts. Uses only the public API.

An optional sidecar (vistructum-sidecar.jar) runs model inference on a separate machine.

Requirements

• Paper 1.21.4, Java 21
• Clients on any 1.21.x version through ViaVersion and ViaBackwards on the server

Pages

• Building: build the jars and Docker images
• Configuration: core, UI, and sidecar settings
• Commands and Permissions: /vis and its permissions
• Plugin API: use Vistructum from your own plugin
• Contributing: rules and checks for pull requests