Advanced-AntiFreecam

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