# VectorGuard<\/p>\n
**Production-grade combat anti-cheat for Paper servers.**<\/p>\n
VectorGuard is a 100% server-side anti-cheat plugin focused exclusively on **combat detection**. It uses packet-level analysis, tick-based telemetry, and multi-signal detection to identify cheaters with high accuracy and minimal false positives.<\/p>\n
Built from the ground up for modern Paper servers (1.20.x\u20131.21.x) with Java 21.<\/p>\n
—<\/p>\n
## Product Overview<\/p>\n
VectorGuard is a combat-only anti-cheat designed to catch the most common PvP exploits while staying light on performance and fair on legitimate players. Every check uses multiple independent signals (rotation, timing, movement, cooldown usage, and hit validation) and applies buffered violations with decay, so one-off spikes do not punish normal players. Ping-aware thresholds and packet-timing compensation reduce false positives for high-latency players.<\/p>\n
Administrators get a fast response workflow: clickable in-game alerts with action buttons, a threat score that aggregates risk across checks, and a visual report command for quick evidence review. A built-in GUI lets staff adjust thresholds, toggle checks, and tune punishments without editing files or restarting the server. Alerts can also be mirrored to Discord for off-server monitoring.<\/p>\n
VectorGuard ships as a single jar with no external dependencies. PacketEvents is embedded, and the plugin runs entirely server-side with no client mod required.<\/p>\n
—<\/p>\n
## Features<\/p>\n
### Detection Engine
\n– **19 combat checks** targeting the most common cheat modules including Mace PvP exploits, crystal PvP automation, bow manipulation, and inventory exploits
\n– **Multi-signal compound detection** \u2014 each check combines multiple independent signals for high confidence
\n– **Buffered violation system** with configurable decay \u2014 prevents single-tick flukes from triggering punishments
\n– **Latency compensation** \u2014 all checks account for player ping to avoid false-flagging high-ping players
\n– **Tick-based analytics** with per-player position history and rotation profiling<\/p>\n
### Admin Experience ### Architecture —<\/p>\n ## Checks<\/p>\n ### Combat<\/p>\n | Check | Description | ### Packet<\/p>\n | Check | Description | —<\/p>\n ## Requirements<\/p>\n – **Java 21+** —<\/p>\n ## Installation<\/p>\n 1. Download `VectorGuard-x.y.z.jar` —<\/p>\n ## Commands<\/p>\n | Command | Description | —<\/p>\n ## Permissions<\/p>\n | Permission | Default | Description | —<\/p>\n ## Configuration<\/p>\n All settings are in `plugins\/VectorGuard\/config.yml`.<\/p>\n ### Check Configuration ### Punishment Stages ### Discord Webhooks ### Admin Alerts —<\/p>\n ## GUI Config Editor<\/p>\n Run `\/vg gui` to open an interactive GUI where you can: —<\/p>\n ## FAQ<\/p>\n **Q: Does this require players to install anything?** **Q: Is PacketEvents required as a separate plugin?** **Q: Does it work with Purpur\/Pufferfish\/other Paper forks?** **Q: Will it conflict with other anti-cheats?** **Q: How do I reduce false positives?** —<\/p>\n ## Credits<\/p>\n **Created by Mr. Dev**<\/p>\n —<\/p>\n ## License<\/p>\n Copyright (c) 2025 NeonDev. All Rights Reserved.<\/p>\n This software and its source code are the exclusive property of NeonDev.<\/p>\n No part of this software, including but not limited to the source code, compiled Unauthorized use, reproduction, or distribution of this software, or any portion THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR VectorGuard is a 100% server-side anti-cheat plugin focused exclusively on combat detection. It uses packet-level analysis, tick-based telemetry, and multi-signal detection to identify cheaters with high accuracy and minimal false positives.<\/p>\n","protected":false},"featured_media":165383,"template":"","meta":{"_minecraft_slug":"vectorguard","_minecraft_project_id":"qAcDiYuQ","_minecraft_author":"NeonDev","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":26,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"vectorguard.zip","_minecraft_size_bytes":8849285,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T22:16:15.759386Z","_minecraft_date_created":"2026-04-04T20:27:20.369879Z","_minecraft_date_modified":"2026-03-07T09:25:01.396399Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/vectorguard","_minecraft_icon_attachment_id":165383,"_minecraft_imported_at":"2026-06-09T17:41:36+00:00","_minecraft_import_hash":"ccc547e4121ca749ce9d8c11ef5e5869","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,127,128],"mod_loader":[131,132,133],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-165382","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-paper","mod_category-purpur","mod_loader-folia","mod_loader-paper","mod_loader-purpur","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– **Clickable chat alerts** with action buttons: `[TP]` `[VL]` `[DBG]` `[RPT]`
\n– **Threat score system** \u2014 composite 0\u2013100% risk assessment across all checks
\n– **Visual threat reports** via `\/vg report
\n– **Sound alerts** for online admins (configurable)
\n– **Discord webhook integration** for off-server monitoring
\n– **In-game GUI** for editing thresholds, toggling checks, and tuning punishments<\/p>\n
\n– **100% server-side** \u2014 no client mod required
\n– **PacketEvents** embedded and shaded \u2014 zero external dependencies
\n– **Modular check system** \u2014 each check is independent and fully configurable
\n– **Performance profiler** built-in (`\/vg profile`)
\n– **Multi-version support** \u2014 Paper 1.20.x through 1.21.x<\/p>\n
\n|——-|————-|
\n| **Aimbot** | Detects snap rotations, acceleration spikes, over-smooth curves, and precision patterns consistent with aim assistance |
\n| **TriggerBot** | Identifies automated attack timing with near-zero reaction delay after crosshair alignment |
\n| **AutoTotem** | Catches unrealistically fast offhand totem swaps during lethal damage windows |
\n| **Reach** | Eye-to-hitbox distance verification with ping, sprint, and movement leniency |
\n| **Velocity** | Detects Anti-Knockback by verifying displacement after server-sent velocity packets |
\n| **Criticals** | Identifies fake critical hits via spoofed position packets (abnormal crit rate, ground-flag oscillation, tiny Y offsets) |
\n| **AutoClicker** | Catches robotic click patterns through timing variance analysis (stddev, CPS, coefficient of variation) |
\n| **KillAura** | Detects multi-target attacks, angle mismatch, wall attacks, and perfect cooldown abuse |
\n| **Sprint** | Identifies backwards sprinting, KeepSprint, and sprint-toggle patterns around attacks |
\n| **MaceSpoof** | Detects spoofed fall-distance position packets for fake Mace smash damage (Criticals-Mace exploit) |
\n| **MaceNoFall** | Catches NoFall + Mace combos: players deal Mace fall-bonus damage but evade fall damage on landing |
\n| **MaceSwap** | Identifies automated weapon switching to Mace during falls (AttributeSwap \/ auto-swap patterns) |
\n| **CrystalAura** | Detects automated crystal place-and-break cycles (superhuman crystal attacks\/sec, place\u2192break pairing, fast-break ratio) |
\n| **BowManipulation** | Catches BowSpam and BowAimbot via charge variance analysis, fire rate, and abnormal hit rates at distance |
\n| **InventoryCleaner** | Identifies inhuman inventory manipulation speed (AutoTotem swaps, chest stealing, combat inventory use) |
\n| **AutoWeapon** | Detects automated weapon switching around attacks (pre-attack swap ratio, A\u2192B\u2192A swap-back patterns) |
\n| **HitboxExpand** | Catches expanded entity hitboxes via lateral offset analysis and edge-hit rate tracking |
\n| **AutoArmor** | Detects automated armor equipping during combat (rapid armor clicks, anti-break durability swaps) |<\/p>\n
\n|——-|————-|
\n| **Timer** | Detects game speed manipulation via packet rate analysis (burst, sustained, and average rate monitoring) |<\/p>\n
\n– **Paper 1.20.x \u2013 1.21.x** (or forks: Purpur, Pufferfish, etc.)
\n– No external dependencies \u2014 PacketEvents is embedded<\/p>\n
\n2. Place it in your server’s `plugins\/` folder
\n3. Start or restart the server
\n4. Edit `plugins\/VectorGuard\/config.yml` to customize thresholds
\n5. Use `\/vg reload` to apply changes without restarting<\/p>\n
\n|———|————-|
\n| `\/vg reload` | Reload configuration |
\n| `\/vg debug
\n| `\/vg vl
\n| `\/vg report
\n| `\/vg gui` | Open the in-game config editor |
\n| `\/vg profile [seconds]` | Run performance profiler |<\/p>\n
\n|————|———|————-|
\n| `vectorguard.admin` | op | Access to all `\/vg` commands and GUI |
\n| `vectorguard.alert` | op | Receive in-game cheat alerts with action buttons |
\n| `vectorguard.debug.view` | op | View debug output |
\n| `vectorguard.report` | true | Allows using `\/vg report` to generate threat reports |<\/p>\n
\nEach check has:
\n– `enabled` \u2014 toggle the check on\/off
\n– `buffer-threshold` \u2014 buffer must exceed this to flag
\n– `buffer-decay-per-tick` \u2014 buffer decreases each tick
\n– `vl-per-breach` \u2014 violation level added per flag
\n– `vl-decay-per-tick` \u2014 VL decreases each tick
\n– `thresholds.*` \u2014 check-specific tuning values<\/p>\n
\n“`yaml
\npunishments:
\n alert-vl: 2.5 # Send alert to admins
\n setback-vl: 6.0 # Teleport player to last safe position
\n punish-vl: 12.0 # Execute punishment command
\n punish-command: “kick %player% Unfair combat behavior detected by VectorGuard.”
\n“`<\/p>\n
\n“`yaml
\nnotifications:
\n discord:
\n enabled: true
\n webhook-url: “https:\/\/discord.com\/api\/webhooks\/…”
\n min-vl: 5.0
\n cooldown-ms: 10000
\n“`<\/p>\n
\n“`yaml
\nnotifications:
\n admin:
\n sound-enabled: true
\n clickable-actions: true
\n show-threat-score: true
\n“`<\/p>\n
\n– Toggle checks on\/off
\n– Edit buffer thresholds and VL values
\n– Adjust punishment thresholds and cooldowns
\n– Save changes to config and reload<\/p>\n
\nA: No. VectorGuard is 100% server-side.<\/p>\n
\nA: No. PacketEvents is embedded inside the VectorGuard jar.<\/p>\n
\nA: Yes, any Paper fork should work.<\/p>\n
\nA: VectorGuard focuses only on combat. It can coexist with movement-focused anti-cheats, but running two combat anti-cheats may cause duplicate flagging.<\/p>\n
\nA: Increase the `buffer-threshold` and `ping-cutoff-ms` values for checks that are flagging incorrectly. The defaults are tuned conservatively.<\/p>\n
\nbinaries, documentation, configuration files, or any associated assets, may be
\nused, copied, modified, merged, published, distributed, sublicensed, sold, or
\notherwise exploited for any purpose without the prior written permission of the
\ncopyright holder.<\/p>\n
\nof it, is strictly prohibited and may result in civil and criminal penalties.<\/p>\n
\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
\nAUTHOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
\nOF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
\nSOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.<\/p>\n","protected":false},"excerpt":{"rendered":"