HuskyGuard

An anti-cheat and admin toolkit for Purpur / Paper 26.2 by Husky Forge. It spots cheat clients, movement and combat cheats, illegal items and griefing exploits, and gives staff a live inventory inspector, full chat and command logging, and a few handy build tools.

It reports by default and does not punish. Set alert-only: false in the config when you want it to also set cheaters back and cancel their hits.

Highlights

• Client detection with a built-in list of 170+ hack clients, flagged as HACK the moment a player joins.
• Combat checks (reach, angle, kill aura, one-tap mace) that understand spears, attribute swapping, elytra and pearl macing, so friendly fights don't spam alerts.
• Movement checks (fly, speed, no-fall, jesus) that allow wind charges, elytra and wind-burst launches.
• Illegal item reverting for bad enchantments, custom attributes, oversized stacks, names, lore and books.
• /inspect, a clickable GUI to look through, and take items from, a player's inventory or ender chest.
• Full chat log of commands, chat messages, signs and books.
• /ore to drop a cube of any ore next to you, even from spectator mode.

Commands

Command	What it does	Permission
/inspect <player> [ender] (alias /check)	Opens a GUI that mirrors the player's real inventory, armor and off-hand. The Inventory and Ender Chest buttons switch the preview. Click an item to pick it up, shift-click to move it into your own inventory, or put items in. Every open and every item moved is logged.	huskyguard.check
/ore <ore> <right|left|front|back> [size]	Places a solid cube of an ore next to you, relative to where you are facing, so it works from spectator mode. Type the ore with spaces or underscores, for example /ore deepslate diamond right or /ore ancient debris front 5. The default size is 3 (up to 9). It never replaces chests, furnaces or bedrock.	huskyguard.ore
/ore undo	Puts back the blocks from your last cube.	huskyguard.ore
/findplayer <player>	Reports a player's exact coordinates to the console and to staff with alerts only. The target never sees it.	huskyguard.findplayer
/hg reload	Reloads the config.	huskyguard.admin
/hg client <player>	Shows which client a player joined with and its brand string.	huskyguard.admin
/hg vl <player>	Shows a player's current violation levels per check.	huskyguard.admin
/hg cmdlog <player or text> [yyyy-MM-dd]	Searches the day's chat and command log and shows the last 20 matches.	huskyguard.admin
/hg trouser	Lists the exploit counters that are active.	huskyguard.admin
/hg cleanchunk	Cleans illegal items out of every container in the chunk you stand in.	huskyguard.admin
/hg kick <player> [reason]	Kicks a player and tells staff.	huskyguard.kick
/hg ban <player> [reason] /hg unban <player>	Bans or pardons a player, online or offline, and logs it to punishments.log.	huskyguard.ban

/hg also works as /huskyguard and /hguard.

Client detection

• Reads each player's client brand a moment after they join and matches it against the list in config.yml.
• Each client is tagged HACK, CLIENT, MODDED, VANILLA or UNKNOWN, and you choose which types alert staff.
• Ships with 170+ hack clients already on the list, including Meteor, Wurst, Aristois, LiquidBounce, RusherHack, ThunderHack, Future, Impact, BleachHack, Sigma, Vape and many more. Names match with spaces, dashes and dots ignored.
• A hack client that hides behind a plain "fabric" or "vanilla" brand can still be caught when it registers a channel under its own name.
• Add or edit clients in config.yml; the first match wins.

Combat checks

• Reach, angle, hits through walls, multi-target hits and click speed (CPS).
• One-tap mace: catches absurd damage, a smash with no fall, and faked falls from teleport-packet exploits such as MaceKill.
• Built for friendly fights:
  • Spear has its own reach and damage limits, lunge and charge are allowed, and one hit can pass through several targets.
  • Attribute swapping: items you just swapped away from still count for that hit.
  • Mace damage follows your real fall height, including Density, so a huge legit smash isn't flagged.
  • Elytra macing and pearl catching: the fake-fall check is relaxed for a short time after elytra, an ender pearl or a wind-charge launch.
• All of these limits and timings are adjustable under combat: in the config.

Movement checks

• Fly (hover and ascend), speed, no-fall and jesus, with optional setbacks.
• Aware of wind charges, wind burst, elytra, riptide, water and other legit boosts.

Exploit and grief protection

• Teleport-packet exploits: TPAura, InfiniteReach, MaceKill, ProjectileTeleport, Teleport, TPFly and spear blink.
• Nuker and insta-mine, boat noclip, scaffold and fast placing, and statistical X-ray detection.
• Click-command books and signs (ForceOPBook and ForceOPSign) and book title overflow dupes.
• A watch list of dangerous OP commands, an alert when an OP joins from a new IP, and a block on command-block items taken from the creative menu.

Illegal item reverting

• Puts items back to normal: over-max or wrong-target enchantments, custom attribute modifiers (the usual one-tap trick), oversized stacks, and over-long names, lore, books or data strings.
• Cleans containers the moment they are opened, and /hg cleanchunk cleans a whole chunk.
• Can run in report-only mode with items.revert: false.

Chat and command log

• Writes player commands, public chat messages, sign text and book edits, plus console commands, to one file per day in plugins/HuskyGuard/command-logs/.
• Records the player's name and UUID, and marks messages that another plugin cancelled.
• Writing happens on a background thread, so it never lags the server.
• Commands that only a client-side mod handles never reach the server, so they can't be logged. If the client sends them as plain chat they are.
• Search it in game with /hg cmdlog. Chat, signs and books can each be switched off in the config.

Alerts and logs

• Alerts go to the console and to every player with huskyguard.alerts.
• Violation levels build up per check and slowly decay, and alerts start at a level you choose.
• Log files in the plugin folder: violations.log, clients.log, check.log, ore.log, findplayer.log and punishments.log.

Spectator tab fix

• Makes players look the same in the tab list no matter what game mode they are in, so nobody can tell who is in spectator.
• Best: install ProtocolLib and it rewrites the game-mode packet, so the font is identical for everyone.
• No ProtocolLib: an optional fallback removes the italics from the name.

Permissions

Permission	Default	Description
huskyguard.admin	op	Use /hg admin subcommands
huskyguard.alerts	op	Receive cheat and client alerts
huskyguard.check	op	Use /inspect (and take items)
huskyguard.ore	op	Use /ore
huskyguard.findplayer	op	Use /findplayer
huskyguard.kick	op	Use /hg kick
huskyguard.ban	op	Use /hg ban and /hg unban
huskyguard.bypass	nobody	Skip all checks. Ops are not exempt by default.

Installation

1. Use a Purpur or Paper 26.2 server (Java 25).
2. Drop HuskyGuard-1.0.0.jar into plugins/ and start the server.
3. Edit plugins/HuskyGuard/config.yml and run /hg reload.
4. Optional: install ProtocolLib for the spectator tab fix.

Configuration

Everything is in config.yml: switch any check on or off under checks:, tune reach, damage and spear limits under combat:, set the /ore size and gap under ore:, and manage the client list and the chat log options.

Support and community

• Discord: https://discord.gg/ZP3VF3MhXB
• Support the project (PayPal): https://www.paypal.com/paypalme/ItzRealHusky

---

---