TotemGuard

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 PacketEvents library to function. Ensure it is installed on your server.

Sponsors

jProfiler

Table of Contents

- Showcase - Supported Platforms & Versions - Checks - Features - Commands - Permission Nodes - Installation - Credits - License

Showcase

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 the wiki!

AutoTotem

- AutoTotemF - Click time difference - AutoTotemF - Impossible standard deviation - AutoTotemF - Impossible average standard deviation - AutoTotemF - Suspicious re-totem packet sequence - AutoTotemF - Impossible low outliers - AutoTotemF - Invalid interactions during inventory close

BadPackets

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

ManualTotem

- ManualTotemA - Time difference between replacement after totem removal

Features

- Bedrock Exception - Asynchronous operations ensure minimal impact on server performance. - Bedrock Exception - Compatible with both MySQL and SQLite. - Bedrock Exception - Supports Bedrock Exception for regionized multithreading. - Bedrock Exception - Send alerts and punishments to a Discord webhook. - Bedrock Exception - Adjust nearly every setting during runtime to fit your server's needs. - Bedrock Exception - Automatically checks for updates on startup. - Bedrock Exception - Allows players with `TotemGuard.Bypass` to bypass checks. - Bedrock Exception - 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. - `TotemGuard.Track` - Access to the `/totemguard track` command. - `TotemGuard.Bypass` - Bypass the plugin's checks. - `TotemGuard.Update` - Receive update notifications. - `TotemGuard.Top` - Access to the `/totemguard top` command. - `TotemGuard.ManualBan` - Access to the `/totemguard manualban` command. - `TotemGuard.Database.Trim` - Access to the `/totemguard database trim` command. - `TotemGuard.Database.Clear` - Access to the `/totemguard database clear` command. - `TotemGuard.Debug` - View debug messages.

Installation

1. Reload: Ensure Reload is installed. 2. Reload: Get the latest release from the %%MD1%%. 3. Reload: Place the plugin JAR file in your server's `plugins` directory. 4. Reload: Customize the `config.yml` file as needed. 5. Reload: Apply the changes using `/totemguard reload`.

Credits

Maintainer: @OutDev For their creative ideas and dedicated efforts in maintaining the project.

License

This project is licensed under the GPL3 License.

Features

- BetterReload Support - Asynchronous operations ensure minimal impact on server performance. - BetterReload Support - Compatible with both MySQL and SQLite. - BetterReload Support - Supports BetterReload Support for regionized multithreading. - BetterReload Support - Send alerts and punishments to a Discord webhook. - BetterReload Support - Adjust nearly every setting during runtime to fit your server's needs. - BetterReload Support - Automatically checks for updates on startup. - BetterReload Support - Allows players with `TotemGuard.Bypass` to bypass checks. - BetterReload Support - Easily send and retrieve alerts across multiple servers, through either plugin messaging or Redis. - BetterReload Support - Automatically ignores Bedrock Edition players to prevent false positives. - BetterReload Support - Integrates with %%MD1%% for seamless configuration reloading.

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 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. - `TotemGuard.Track` - Access to the `/totemguard track` command. - `TotemGuard.Bypass` - Bypass the plugin's checks. - `TotemGuard.Update` - Receive update notifications. - `TotemGuard.Top` - Access to the `/totemguard top` command. - `TotemGuard.Database.Trim` - Access to the `/totemguard database trim` command. - `TotemGuard.Database.Clear` - Access to the `/totemguard database clear` command. - `TotemGuard.Debug` - View debug messages.

Installation

1. Reload: Ensure Reload is installed. 2. Reload: Get the latest release from the %%MD1%%. 3. Reload: Place the plugin JAR file in your server's `plugins` directory. 4. Reload: Customize the `config.yml` file as needed. 5. Reload: Apply the changes using `/totemguard reload`.

Credits

Maintainer: @OutDev For their creative ideas and dedicated efforts in maintaining the project.

Special Thanks to Our Contributors

- @Retrooper For developing PacketEvents, a foundational library integral to the project's success.

- @MattMX For supporting development by providing server access and contributing valuable insights through PvPHub.

License

This project is licensed under the GPL3 License.