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.

Showcase

Supported Platforms & Versions

Platform	Supported Versions
Paper, Folia, and related forks	1.18 - 1.21.1

Checks

AutoTotem

• AutoTotemA - Click time difference
• AutoTotemB - Impossible standard deviation
• AutoTotemC - Impossible consistency difference
• 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

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 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.
• Bedrock Exception - Automatically ignores Bedrock Edition players to prevent false positives.
• BetterReload Support - Integrates with BetterReload 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 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 database trim - Trim the database.
• /totemguard database clear - Clear the database.
• /totemcheck <player> - Check the player for AutoTotem.

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.Bypass - Bypass the plugin's checks.
• TotemGuard.Update - Receive update notifications.
• 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. Prerequisites: Ensure PacketEvents is installed.
2. Download: Get the latest release from the GitHub release page.
3. Install: Place the plugin JAR file in your server's plugins directory.
4. Configure: Customize the config.yml file as needed.
5. Reload: Apply the changes using /totemguard reload.

Compiling From Source

Prerequisites

• Java Development Kit (JDK) 21 or higher
• Git

Steps

1. Clone the Repository:

   git clone https://github.com/Bram1903/TotemGuard.git
   

2. Navigate to the Project Directory:

   cd TotemGuard
   

3. Compile the Source Code: Use the Gradle wrapper to build the plugin:

   Linux / macOS

   ./gradlew build
   

   Windows

   .\gradlew build
   

Credits

Special thanks to:

• @Retrooper: Author of PacketEvents.

License

This project is licensed under the GPL3 License.