[NEW] AimSnap Check
Detects the auto-aim signature of programmatic aim-lock clients: a large yaw rotation in the tick(s) before a firework launch, immediately followed by near-zero yaw drift on the launch tick itself. Humans always leave >=1° micro-jitter after a hard snap; cheats that set rotation programmatically collapse to exact 0°.
Per-player yaw ring buffer fed from PlayerMoveEvent, evaluated against the live launch-tick yaw on ProjectileLaunchEvent. Tunable thresholds: pre-snap-min-angle (35°), launch-tick-max-angle (0.5°),
max-sample-gap-ms (150). Disabled by default — enable after server-specific tuning.
[IMPROVEMENT] Elytra Booster (Dive Memory, Oscillation Fix, API)
Anti-elytrabooster: added dive peak pitch memory (decay per tick, min pitch, sustain-ticks) so legitimate dive→level momentum is not penalized by the level-flight cap while memory still decays over time.
Pitch oscillation bypass closed: when |pitch| is within pitch-oscillation-clamp-degrees and there is no dive memory and no transition grace, the cap uses the live pitch instead of the generous short-window max — so bobbing the head while flying level cannot inflate the allowed speed.
Dive memory only grows after dive-peak-memory-sustain-ticks consecutive ticks at or above dive-peak-memory-min-pitch, so brief flicks no longer grant a long cheat-sized ceiling.
[IMPROVEMENT] ElytraTarget Smarter & Faster Flagging
Three legitimacy gates were added to flag faster on cheats while eliminating false positives on the two main legit edge cases that the old check confused with hacks:
- Depletion gate: if the pre-launch snapshot showed a single rocket and the main hand is now AIR, treat as natural depletion (600ms grace window).
- Quick-switch gate: if the player switched OFF a rocket slot within 80ms of the launch, treat as a legit fast hotbar swap.
- Silent-switch fast path: if neither gate trips and the player is gliding with no rocket in either hand, flag immediately (debounce reduced from longer values to 600ms).
Pre-launch material+amount snapshot is captured in ProjectileLaunchEvent and evaluated against the post-tick state (1-tick delay) for accurate hand-state assessment.
[IMPROVEMENT] Flight Reversal Multi-Signal Consensus
Replaced the old single-signal 140° yaw-delta check (trivially bypassed by the orbital fly-past pattern: hit → fly past → arc back → hit again) with a three-signal consensus scoring system. Flags only when ≥2 signals trip AND a firework boost was used between hits:
- Yaw bounce: max(yawDelta, directionDelta) ≥ min-bounce-angle, optionally requiring attacker velocity reversal (dot product of velocity vectors < 0).
- Flyby/orbital: max distance from victim between hits ≥ flyby-distance AND re-entry into close radius (≤ flyby-distance × 0.5).
- Path/chord ratio: actual path length between hits / straight-line chord ≥ path-ratio (loops are ≥ 2.2; straight re-approaches are ~1.0).
Per-player position ring buffer (128 samples) fed each tick from PlayerMoveEvent powers the geometric signals. Tested against orbital bypass patterns from upgradeElytraTarget and Перелёт противника — they trip ≥2 signals consistently while legitimate hit-and-return passes trip ≤1.
New tunables: flyby-distance, path-ratio, require-firework-between, require-velocity-reversal.
[IMPROVEMENT] NPC Tracker Anti-Detection Overhaul
NPC UUID generation changed from UUID.randomUUID() (v4) to UUID.nameUUIDFromBytes("OfflinePlayer:" + name) (v3). This matches Minecraft's offline-mode UUID format, defeating the most common client-side bot detection check that compares entity UUID against the expected OfflinePlayer hash.
Tested against the UUID-based bot detection used by clients that filter entities where UUID != nameUUIDFromBytes("OfflinePlayer:" + name) — NPC now passes this check.
[IMPROVEMENT] NPC Display & LuckPerms
When LuckPerms is present, NPC nametag styling (above-head when enabled) uses the default group's prefix from LuckPerms — the same prefix real players on the default track would show, keeping NPCs visually consistent with your server's tab/rank formatting.
[IMPROVEMENT] Silent Detection Mode
ElytraBooster (SuperFirework) check no longer rubber-bands or clamps the player's velocity on flag. The player is silently flagged without any indication they've been detected, allowing delayed punishment to execute without the player knowing what triggered it.
[IMPROVEMENT] Hit Block System Rework
hit-block-duration has been moved under detection.hit-block as a proper category with enabled and duration settings.
Default changed to enabled: false so players cannot detect they've been flagged through blocked hits. Combined with delayed punishment, the player gets banned without ever knowing what triggered it.
[IMPROVEMENT] Flight Reversal Anti-Bypass
Flight Reversal now uses packet-level yaw tracking combined with direction vector analysis between attacker and victim. Cheats that bypass by changing their rotation mode (e.g. silent rotation, server-side rotation spoofing) are now detected because the system analyzes the actual geometric direction from attacker to victim, not just the reported yaw.
Detection angle lowered from 140° to 120° for wider coverage.
Time window increased from 4s to 5s for more consistent detection across varying ping.
[NEW] Support Command
/elytratarget that shows plugin info, version, author, purchase link, and Discord. Accessible by all players.
Configurable via support-command: true/false in config.yml.
[IMPROVEMENT] Language Files
All # comment blocks in language files are now translated to their respective language (French, Spanish, Polish, Turkish) instead of being in English.
Added support-message localization to all 5 language files.
[PATCH] Config Version Bumped to 1.0.5
[PATCH] Language Versions Bumped to 1.0.5
[MAJOR] New license system
- We have moved to the new Orvex Studios license system. Licenses are now managed through Discord (view, and update your server IPs there).
- If you need help, open a ticket in our Discord support channel.
[MAJOR] Updated dependencies with breaking changes
[IMPROVEMENT] NPC Tracker System Overhaul
[NEW CHECK] Anti ElytraBooster (Superfirework)
- NPC now maintains the exact configured distance behind the player at all times, even during firework rocket boosts or elytra speed hacks. Previously, the NPC would fall 3-4 blocks behind during high-speed flight.
- NPC names are now sourced from a pool of 15,000+ real Minecraft usernames fetched from NameMC at startup. NPCs are no longer identifiable by fake-looking names.
- Added name rotation system: NPC name changes periodically (configurable interval) by destroy+respawn cycle, preventing players from adding NPC names to their friend list.
- Added required-consecutive-hits setting (default: 2). Players must hit the NPC multiple times within a time window before being flagged, preventing accidental single-hit false positives.
- NPC now stays in the tab list while active, bypassing client-side antibot tab-based detection systems.
- Removed add-to-tablist and tab-remove-delay config options (no longer needed).
- Fixed NPC appearing inside the player during name rotation. NPC now recalculates its position from the player's current location on each rotation instead of reusing the old NPC's stale position.
- Improved NPC height positioning: default npc-height-offset reduced from 1 to 0 for more natural placement behind the player.
- Tested against the bot modules of the following clients, none of which were able to bypass the NPC system: Catlean, Nursultan, Dimasik, Catlavan, ExosWare, System-DLC, Haruka, Nuclear Client, Moonward, and Expensive.
[NEW CHECK] Flight Reversal
- Detects abnormally fast elytra flight caused by SuperFirework / ElytraBoost cheats. These cheats multiply motion vectors every tick, sustaining speeds far beyond vanilla limits.
- Uses sustained-speed analysis: natural gravity dives produce brief speed spikes that decay, cheats maintain constant high velocity.
- Fully customizable in config file
[NEW] Delayed Punishment
- Detects hit-rotate-firework-return bounce loop used by elytra target. Hit → 180° turn → firework boost away → return → hit same target.
- Fully customizable in config file
[IMPROVEMENT] The hit block system has been converted from an event-based system to a packet-based system
- When a player drops the maximum flag, a punishment command is executed against the player after the time specified in the config
- The feature is fully customizable.
[FIX] NPC Tracker Self-Ban Prevention
- When a player is flagged, hits are blocked for a certain period of time. Previously, this blocking system was prevented by calling
event.setCancelled(true)which caused other players to notice that the hits were blocked. Now, blocking is handled via packets, so other players won’t be notified that the hits are blocked and won’t be bothered by it.
[IMPROVEMENT] Addedhit-block-duration: 100setting to configuration file
[PATCH] Config Version Bumped to 1.0.4 (Config file is updated too much.)
[PATCH] Language Versions Bumped to 1.0.4
[MAJOR] Migrated project from Maven to Gradle (Kotlin DSL)
[MAJOR] Multi-Version NMS Support (1.16.5 - 1.21.11)
- Adopted paperweight-userdev for NMS compilation and reobfuscation
- Switched from Spigot API to Paper API
[NEW FEATURE] NPC Tracker Anti-KillAura System
- Supported: Between 1.16.5 and 1.21.11
[NEW FEATURE] Server Health Monitor (Lag Protection)
- Fake PlayerNPC spawns behind gliding players and follows them
- If a player targets the NPC, they are instantly flagged
- NPC is not bypassable by client-side anti-NPC modules (packet-level interception)
- Randomized armor and sword equipment to prevent "naked NPC" bypass
- Configurable invisible mode, tab list behavior, nametag visibility
- FOV protection: NPC teleports behind instantly if player turns around
- Dynamic names from randomized name pool
- Configurable spawn delay, distance, height offset, update interval
[IMPROVEMENT] Folia Support
- Real-time TPS monitoring
- Per-player ping monitoring
- Configurable min TPS, max ping, grace period multiplier
- skip-high-ping: skip detection for high-ping players (default: false, prevents ping spoof bypass)
- skip-low-tps: skip detection during low TPS (default: true, prevents false flags)
[IMPROVEMENT] Deep Performance Optimization
- Console commands now dispatch via GlobalRegionScheduler instead of EntityScheduler
- Fixes commands like "lban" failing on Folia servers
[IMPROVEMENT] Language Files Updated
- Alert recipient caching with 3-second TTL
- Alert message template caching
- Indexed for-loops instead of iterators
[IMPROVEMENT] Default configuration file edited for better checks
- Alert messages show warnings as %count%/%count_max%x
- Standardized professional color scheme
- Updated language files
- Added new messages in language files
- Geyser players were bypassed due to false flags in slot and movement controls.
- [IMPROVEMENT] Slot checks has been improved
- [IMPROVEMENT] Movement checks has been improved
- [IMPROVEMENT] Reload function has been improved
- [IMPROVEMENT] License verification has been removed for each command usage
- [IMPROVEMENT] License verification functions has been improved
- [NEW] Added auto config updater
- [NEW] Folia Support
- [NEW] Update Checker
- [NEW FEATURE] Anti Firework Macro: If it exceeds the speed limit set within a millisecond, it will block it.
- [NEW FEATURE] Rocket Attack Blocker: Block the player attacking with a rocket in their hand
- [FIX] While flying with a firework in hand, the false flag falling when the firework runs out has been fixed.
- [FIX] Fixed an issue where attempting to place fireworks using Shift + left click in Offhand Protection feature was being blocked.
- The offhand protection system has been recoded.
- Some changes have been implemented in the licensing system.
- License check removed when each command is used
- The movement check has been improved
- The firework check has been improved
- Performance improvements
- Caches are now cleared on reload.
