COWMODSКаталог модов

TotemGuard

TotemGuard is a simple anti-cheat that tries to detect players who are using AutoTotem.

Автор: DevBram16,8 тыс.26обновлён 5 июл. 2026 г.
Скачать 2.1.4Все версии (15)
УправлениеОптимизацияУтилиты

Описание

TotemGuard

Build GitHub Release
SpigotMC TotemGuard
Discord

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

Demo

Supported Platforms & Versions

PlatformSupported Versions
Paper, Folia, and related forks1.20 - 1.21.5

Checks

For a much more detailed explanation of the checks, see the wiki!

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 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.
  • 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. 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.

Credits

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

License

This project is licensed under the GPL3 License.

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.
  • 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.
  • 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 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. 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.

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.

Галерея

Alert ShowcaseLogs Command

Последние версии

Все версии →
release

TotemGuard 2.1.4

2.1.4
5 июл. 2026 г.6 тыс.Minecraft: 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2folia, paper, purpur
Скачать
Что нового
26.2 support
release

TotemGuard 2.1.3

2.1.3
4 мая 2026 г.3 тыс.Minecraft: 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2folia, paper, purpur
Скачать
Что нового
# IMPORTANT This will be the last release of TotemGuard V2, before the release of TotemGuard V3. TotemGuard V3 is currently in a private branch while I am finishing it, but will soon be merged into main. Thank you for everyone that was involved with TotemGuard V1 & V2. We run on over a 1000 servers right now: https://bstats.org/plugin/bukkit/TotemGuard/23179 and this will soon be much more with the release of V3 coming around the corner. @OutDev0 and I are truly excited for what TotemGuard V3 will bring to the table! Stay tuned! ## Changes - Added support for Minecraft 26.1.2 ## New Contributors * @NriotHrreion made their first contribution in https://github.com/Bram1903/TotemGuard/pull/18 **Full Changelog**: https://github.com/Bram1903/TotemGuard/compare/v2.1.2...v2.1.3
release

TotemGuard 2.1.2

2.1.2
13 янв. 2026 г.2,9 тыс.Minecraft: 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11folia, paper, purpur
Скачать
Что нового
# TotemGuard v2.1.2 ### Changes * Added: 1.21.11 Support * Added: AutoTotemH * Added: Multi alias support for commands * Added: Compatibility checker And other stuff I forgot. Sorry for the slow 1.21.11 update. I have mostly been focusing on TotemGuard 3.0 👀 **Full Changelog**: https://github.com/Bram1903/TotemGuard/compare/v2.1.1...v2.1.2
release

TotemGuard 2.1.1

2.1.1
26 окт. 2025 г.1,2 тыс.Minecraft: 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10folia, paper, purpur
Скачать
Что нового
# TotemGuard v2.1.1 ### Changes * Fixed: Players getting kicked for a network protocol error * Fixed: Not being able to load the TotemGuard profile on servers with world saving disabled * Fixed: TotemGuard Profile being wrongly formatted when having more than three punishments * Fixed: Incompatibility with AntiSpoof Pro **Full Changelog:** [v2.1.0 → v2.1.1](https://github.com/Bram1903/TotemGuard/compare/v2.1.0...v2.1.1)
release

TotemGuard 2.1.0

2.1.0
20 окт. 2025 г.188Minecraft: 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10folia, paper, purpur
Скачать
Что нового
# TotemGuard v2.1.0 This release introduces new detections, improves reliability, and significantly reduces false flags from BadPacketsD. It also restores broad version support and modernizes the internal command system. ### Changes * Added new detection set. * Reduced false positives from BadPacketsD. * Restored compatibility with all Minecraft versions from **1.16.5** up to **1.21.10** (previously only supported 1.20.6+). * Migrated command handling from **CommandAPI** to **Incendo Cloud**, improving maintainability and future version support. * General performance and stability improvements. **Full Changelog:** [v2.0.4 → v2.1.0](https://github.com/Bram1903/TotemGuard/compare/v2.0.4...v2.1.0)
release

TotemGuard 2.0.4

2.0.4
22 июл. 2025 г.1,2 тыс.Minecraft: 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8folia, paper, purpur
Скачать
Что нового
- Added: 1.21.8 Support **Full Changelog**: https://github.com/Bram1903/TotemGuard/compare/v2.0.3...v2.0.4
release

TotemGuard 2.0.3

2.0.3
12 июл. 2025 г.182Minecraft: 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7folia, paper, purpur
Скачать
Что нового
## What's Changed - Fixed: PacketEvents 2.9.1 Compatibility - Fixed: Bypass permission not working - Fixed: `tg alerts <player>` sending the confirmation message to the player instead of the console **Full Changelog**: https://github.com/Bram1903/TotemGuard/compare/v2.0.2...v2.0.3
release

TotemGuard 2.0.2

2.0.2
2 июл. 2025 г.170Minecraft: 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7folia, paper, purpur
Скачать
Что нового
Added: 1.21.6 & 1.21.7 Support Added: BadPacketsD Reworked: Discord Webhook Implementation **Full Changelog**: https://github.com/Bram1903/TotemGuard/compare/v2.0.1...v2.0.2
release

TotemGuard 2.0.1

2.0.1
15 июн. 2025 г.284Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5folia, paper, purpur
Скачать
Что нового
Fixed: Error upon registering the totemguard command on recent 1.21.5 paper builds
release

TotemGuard 2.0.0

2.0.0
15 июн. 2025 г.73Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5folia, paper, purpur
Скачать
Что нового
## TotemGuard v2.0.0 Release Notes ### What's New This is a **complete rewrite** of TotemGuard. For the list of changes, check the commit history at the bottom of this message; there are way too many to write down. :-) ### Note If you’ve used TotemGuard 1.x.x before, make sure to delete your current `TotemGuard` folder inside the `plugins` directory. Also, if you were using an external database, either remove the old one or start fresh with a new database — old formats won’t work anymore. ### Found a Bug? If you run into any bugs, please create an issue on my GitHub repository and I’ll try to patch them as soon as possible. **Full Changelog**: [https://github.com/Bram1903/TotemGuard/compare/v1.2.0...v2.0.0](https://github.com/Bram1903/TotemGuard/compare/v1.2.0...v2.0.0)