<div align="center"> <h1>TotemGuard</h1> <img alt="Build" src="https://github.com/Bram1903/TotemGuard/actions/workflows/gradle.yml/badge.svg"> <img alt="GitHub Release" src="https://img.shields.io/github/release/Bram1903/TotemGuard.svg"> <br> <a href="https://www.spigotmc.org/resources/totemguard.119385/"><img alt="SpigotMC" src="https://img.shields.io/badge/-SpigotMC-blue?style=for-the-badge&logo=SpigotMC"></a> <a href="https://modrinth.com/plugin/totemguard"><img alt="TotemGuard" src="https://img.shields.io/badge/-Modrinth-green?style=for-the-badge&logo=Modrinth"></a> <br> <a href="https://discord.deathmotion.com"><img alt="Discord" src="https://img.shields.io/badge/-Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white"></a> </div> ## Overview TotemGuard is a lightweight anti-cheat plugin designed to detect players using AutoTotem. It operates asynchronously to minimize server impact and offers extensive configurability, enabling server owners to tailor the plugin to their specific needs. ### Prerequisites TotemGuard requires the (https://modrinth.com/plugin/packetevents) library to function. Ensure it is installed on your server. ### Sponsors (https://cdn.modrinth.com/data/cached_images/525804ff66c27014be7a41445a9637114c25288c.png)](https://www.ej-technologies.com/jprofiler) ## Table of Contents - (#showcase) - (#supported-platforms--versions) - (#checks) - (#features) - (#commands) - (#permission-nodes) - (#installation) - (#credits) - (#license) ## Showcase !(docs/showcase/showcase.png) ## Supported Platforms & Versions | Platform | Supported Versions | |---------------------------------|--------------------| | Paper, Folia, and related forks | 1.20 - 1.21.5 | ## Checks For a much more detailed explanation of the checks, see (https://github.com/Bram1903/TotemGuard/wiki/Checks) ### AutoTotem - **AutoTotemA** - Click time difference - **AutoTotemB** - Impossible standard deviation - **AutoTotemC** - Impossible average standard deviation - **AutoTotemD** - Suspicious re-totem packet sequence - **AutoTotemE** - Impossible low outliers - **AutoTotemF** - Invalid interactions during inventory close ### BadPackets - **BadPacketsA** - Opt-out message in a mod configuration channel - **BadPacketsB** - Banned client brand - **BadPacketsC** - Same slot change packet ### ManualTotem - **ManualTotemA** - Time difference between replacement after totem removal ## Features - **Performance** - Asynchronous operations ensure minimal impact on server performance. - **Database Support** - Compatible with both MySQL and SQLite. - **Folia Integration** - Supports (https://papermc.io/software/folia) for regionized multithreading. - **Webhooks** - Send alerts and punishments to a Discord webhook. - **Highly Configurable** - Adjust nearly every setting during runtime to fit your server's needs. - **Update Checker** - Automatically checks for updates on startup. - **Bypass Permission** - Allows players with `TotemGuard.Bypass` to bypass checks. - **Cross Server Alerts** - Easily send and retrieve alerts across multiple servers, through either plugin messaging or Redis. - **Bedrock Exception** - Automatically ignores Bedrock Edition players to prevent false positives. ## Commands - `/totemguard` or `/tg` - Main command for TotemGuard. - `/totemguard reload` - Reload the plugin configuration. - `/totemguard alerts` - Toggle alerts for the player. - `/totemguard check <player>` - Check the player for AutoTotem. - `/totemguard alerts <player>` - Toggle alerts for another player. - `/totemguard profile` - Display the player's profile. - `/totemguard stats` - Show plugin statistics. - `/totemguard clearlogs` - Clear the logs. - `/totemguard track/untrack <player>` - Tracks the player. - `/totemguard top` - Shows the top 10 violators. - `/totemguard manualban <player>` - Manually ban a player. - `/totemguard database trim` - Trim the database. - `/totemguard database clear` - Clear the database. ## Permission Nodes Operators (OPs) have these permissions by default, except `TotemGuard.Debug`: - `TotemGuard.*` - Access to all TotemGuard permissions. - `TotemGuard.Staff` - Access to `TotemGuard.Check`, `TotemGuard.Alerts`, and `TotemGuard.Profile`. - `TotemGuard.Databases.*` - Access to all database-related commands. - `TotemGuard.Reload` - Access to the `/totemguard reload` command. - `TotemGuard.Check` - Access to the `/totemcheck` command. - `TotemGuard.Alerts` - Access to the `/totemguard alerts` command. - `TotemGuard.Alerts.Others` - Toggle alerts for other players. - `TotemGuard.Profile` - Access to the `/totemguard profile` command. - `TotemGuard.Stats` - Access to the `/totemguard stats` command. - `TotemGuard.ClearLogs` - Access to the `/totemguard clearlogs` command. - `TotemG

TotemGuard

## Overview

TotemGuard is a lightweight anti-cheat plugin designed to detect players using AutoTotem. It operates asynchronously to minimize server impact and offers extensive configurability, enabling server owners to tailor the plugin to their specific needs.

### Prerequisites

TotemGuard requires the (https://modrinth.com/plugin/packetevents) library to function. Ensure it is installed on your server.

### Sponsors [!(https://cdn.modrinth.com/data/cached_images/525804ff66c27014be7a41445a9637114c25288c.png)](https://www.ej-technologies.com/jprofiler)

## Table of Contents

• (#showcase)
• (#supported-platforms--versions)
• (#checks)
• (#features)
• (#commands)
• (#permission-nodes)
• (#installation)
• (#credits)
• (#license)

## Showcase

!(docs/showcase/showcase.png)

## Supported Platforms & Versions

| Platform | Supported Versions | |---------------------------------|--------------------| | Paper, Folia, and related forks | 1. 20 - 1. 21. 5 |

For a much more detailed explanation of the checks, see (https://github.com/Bram1903/TotemGuard/wiki/Checks)

### AutoTotem

• AutoTotemA - Click time difference
• AutoTotemB - Impossible standard deviation
• AutoTotemC - Impossible average standard deviation
• AutoTotemD - Suspicious re-totem packet sequence
• AutoTotemE - Impossible low outliers
• AutoTotemF - Invalid interactions during inventory close

### BadPackets

• BadPacketsA - Opt-out message in a mod configuration channel
• BadPacketsB - Banned client brand
• BadPacketsC - Same slot change packet

### ManualTotem

- ManualTotemA - Time difference between replacement after totem removal

## Features

• Performance - Asynchronous operations ensure minimal impact on server performance.
• Database Support - Compatible with both MySQL and SQLite.
• Folia Integration - Supports (https://papermc.io/software/folia) for regionized multithreading.
• Webhooks - Send alerts and punishments to a Discord webhook.
• Highly Configurable - Adjust nearly every setting during runtime to fit your server's needs.
• Update Checker - Automatically checks for updates on startup.
• Bypass Permission - Allows players with `TotemGuard. Bypass` to bypass checks.
• Cross Server Alerts - Easily send and retrieve alerts across multiple servers, through either plugin messaging or
• Redis.
• Bedrock Exception - Automatically ignores Bedrock Edition players to prevent false positives.

## Commands

• `/totemguard` or `/tg` - Main command for TotemGuard.
• `/totemguard reload` - Reload the plugin configuration.
• `/totemguard alerts` - Toggle alerts for the player.
• `/totemguard check ` - Check the player for AutoTotem.
• `/totemguard alerts ` - Toggle alerts for another player.
• `/totemguard profile` - Display the player's profile.
• `/totemguard stats` - Show plugin statistics.
• `/totemguard clearlogs` - Clear the logs.
• `/totemguard track/untrack ` - Tracks the player.
• `/totemguard top` - Shows the top 10 violators.
• `/totemguard manualban ` - Manually ban a player.
• `/totemguard database trim` - Trim the database.
• `/totemguard database clear` - Clear the database.

## Permission Nodes

Operators (OPs) have these permissions by default, except `TotemGuard. Debug`:

• `TotemGuard.` - Access to all TotemGuard permissions.
• `TotemGuard. Staff` - Access to `TotemGuard. Check`, `TotemGuard. Alerts`, and `TotemGuard. Profile`.
• `TotemGuard. Databases.` - Access to all database-related commands.
• `TotemGuard. Reload` - Access to the `/totemguard reload` command.
• `TotemGuard. Check` - Access to the `/totemcheck` command.
• `TotemGuard. Alerts` - Access to the `/totemguard alerts` command.
• `TotemGuard. Alerts. Others` - Toggle alerts for other players.
• `TotemGuard. Profile` - Access to the `/totemguard profile` command.
• `TotemGuard. Stats` - Access to the `/totemguard stats` command.
• `TotemGuard. ClearLogs` - Access to the `/totemguard clearlogs` command.
• `TotemG