### New - Bedrock players (Geyser/Floodgate) are now automatically bypassed from translation-based detection checks. Bedrock clients don't have Java's language system, so those checks could never get a meaningful answer from them - they'd just open a sign and time out every time. - Detects Floodgate automatically if installed - no hard dependency, no extra setup required. Toggleable and independent from the regular bypass whitelist. - `/caf status` now shows whether Floodgate was detected and whether the Bedrock bypass is active. > config.yml automatically picks up this new setting on first start after updating - nothing you've already configured gets touched or reset.

### New - Built-in update notifications for staff on join. - `config.yml` now automatically picks up new settings on update, without resetting anything you've already configured. ### Improvements - Reduced false-positive risk for multi-purpose client mods - detections that only prove a mod is installed (rather than actively misused) now alert staff for manual review instead of auto-punishing. - General stability and performance cleanup.

### New - **Tweakeroo Freecam detection**: three new checks detect Tweakeroo's "Free Camera" feature (separate detection group from Meteor/Freecam). Keys verified against the actual Tweakeroo 1.21.1 source. ### Bugfixes - A config load failure (broken/invalid `config.yml`) is now reported loudly in the console again, instead of only showing up as blank chat messages. - Missing or unloadable message templates now show a clear error in chat instead of a silent, empty prefix. > Existing `config.yml` files are not auto-updated. To use the new Tweakeroo checks, manually add the three new entries to your own `checks:` list (see the bundled `config.yml` for the exact blocks).

## Improvements - Improved Freecam detection accuracy. - Dedicated Freecam detections are now handled separately from Meteor detections. - A confirmed Freecam translation key now results in an immediate detection. - Detection messages now correctly identify Freecam instead of Meteor where appropriate. ## Fixed - Removed the Action Prevention system. - Fixed false positives that could incorrectly block legitimate player interactions. - Removed unnecessary gameplay restrictions caused by preventive interaction checks. - Improved detection consistency and logging. This update focuses on reliability by eliminating false interaction blocks while keeping the translation-based detection system intact.

### Bugfixes - **Fixed false-positive kicks caused by keystrokes:** a movement key (e.g. `W`) pressed right as the internal translation check ran on join could be misread as a suspicious answer and trigger an instant kick. Answers that are just one stray keystroke away from the fallback text are now correctly treated as "no result", and the check is automatically retried once. - **Restored language-independent detection:** non-English clients (e.g. German *"Freecam Umschalten"* instead of *"Toggle Freecam"*) are now correctly recognized as a confirmed hit again, instead of only being reported as an uncertain match. ### Detection engine - New **confirmed/unconfirmed scoring**: only confirmed hits can trigger automatic punishment (kick/commands). Ambiguous answers only contribute a reduced score and, once the threshold is reached, raise a staff notification for manual review instead of an automatic kick. ### New config options (`settings:`) - `fallback-noise-tolerance` - `expected-match-tolerance` - `unconfirmed-score-factor` - `require-confirmed-for-punishment` - `messages.escalation` > Existing `config.yml` files are not auto-updated. Safe defaults apply if the options are missing - add them manually to tune (see the bundled `config.yml`). ### Misc - Internal per-player state is now cleaned up on player quit (memory hygiene).

# Version 1.3.0 ## Smarter Detection System & Reduced False Positives This update focuses on improving detection reliability while significantly reducing false positives on legitimate players. ## What's New * Improved translation-based detection accuracy * Reduced false positives on legitimate clients * Added score-based detection groups for more reliable results * Improved compatibility with different client languages * Added configurable commands for every detection group * Improved handling of uncertain translation responses * Cleaner and more flexible configuration system * General stability and performance improvements ## Important Please compare or regenerate your `config.yml` when updating from an older version to ensure all new settings are available. Thank you for using CouchAntiFreecam! If you enjoy the plugin, please consider leaving a review. Your feedback helps improve future updates.

# CouchAntiFreecam A lightweight anti-freecam and client detection plugin for Paper servers. CouchAntiFreecam uses translation-key detection similar to methods used on large SMP networks to detect Freecam, Meteor and custom client modifications. ## Features - Translation-Key Detection - Freecam Detection - Meteor Detection - Custom Translation-Key Checks - Staff Notifications - Configurable Punishments - Configurable Detection Reasons - Through-Wall Interaction Protection - Reach Interaction Protection - Bypass System - ProtocolLib Support ## Requirements - Paper 1.21+ - ProtocolLib ## Commands /caf reload /caf test <player> /caf debug /caf status /caf bypass ## Permissions couchantifreecam.admin couchantifreecam.reload couchantifreecam.test couchantifreecam.debug couchantifreecam.notify couchantifreecam.bypass checks: - name: Freecam enabled: true key: key.freecam.toggle reason: Freecam detected - name: Meteor enabled: true key: key.meteor-client.open-gui reason: Meteor Client detected