SomeFreeze

# SomeFreeze A cheat-check (freeze) plugin for **Paper 1.16.5**. Moderators can summon suspected players for a timed review, communicate in a private check chat, detect AnyDesk IDs, track AFK activity, and record outcomes with optional MySQL storage. ## Requirements - **Paper 1.16.5** (or compatible Spigot fork) - **Java 8+** - **(https://www.spigotmc.org/resources/protocollib.1997/)** (optional, recommended) — improves AFK detection via client look packets. Place `ProtocolLib.jar` in `libs/` before building, or install it on the server at runtime. ## Build ```bash mvn clean package ``` Output: `target/SomeFreeze-1.0.1.jar` ## Commands Main command: `/freeze` Aliases: `/sfreeze`, `/проверка` | Command | Description | Permission | |---------|-------------|------------| | `/freeze <player>` | Start a cheat check on a player | `somefreeze.use` | | `/freeze` | End the active check with status **Clean** | `somefreeze.use` | | `/freeze <player>` *(again)* | If you are already checking that player, ends the check as **Clean** | `somefreeze.use` | | `/freeze checkafk ` | Check whether a player is AFK (defaults to your current check target) | `somefreeze.checkafk` | | `/freeze history <player>` | Show the last 15 check records for a player | `somefreeze.history` | | `/freeze finish <reason>` | End the check with a configured reason (runs associated commands) | `somefreeze.finish` | | `/freeze time stop` | Pause the ban countdown (e.g. after AnyDesk is shared) | `somefreeze.time` | | `/freeze time start` | Resume the ban countdown | `somefreeze.time` | ## Permissions | Permission | Description | Default | |------------|-------------|---------| | `somefreeze.use` | Start/end checks | op | | `somefreeze.checkafk` | Use `/freeze checkafk` | op | | `somefreeze.history` | View check history | op | | `somefreeze.finish` | Finish checks with a reason | op | | `somefreeze.time` | Pause/resume the timer | op | | `somefreeze.notify` | Receive check notifications | op | | `somefreeze.bypass` | Ignore freeze restrictions (movement, inventory, etc.) | false | | `somefreeze.admin` | Grants all permissions above | op | ## How a check works 1. **Start** — A moderator runs `/freeze <player>`. The suspect is frozen in place, teleported to the configured check location (optional), and linked to that moderator for the session. 2. **Restrictions** — While frozen, the player cannot move, open inventories, interact, drop items, take damage, or run most commands (except chat-related commands and `/freeze`). Players with `somefreeze.bypass` are unaffected. 3. **Timer** — A countdown runs (default 7 minutes). The moderator sees a **BossBar** with time remaining. When it reaches zero, configurable commands run (e.g. ban) via `on-time-expire`. 4. **Reminders** — On a configurable interval, the suspect receives chat instructions, an optional clickable **AnyDesk** link, and a title/subtitle overlay. 5. **AnyDesk** — If the suspect posts a 9–10 digit ID in chat (regex-configurable), the moderator is notified and activity is recorded. 6. **Private chat** — Public chat is cancelled during a check; messages between moderator and suspect are routed privately, with an optional **copy-to-clipboard** button. 7. **Timer control** — `/freeze time stop` pauses the countdown (useful after screen sharing); `/freeze time start` resumes it. 8. **End** — `/freeze` or `/freeze <same player>` marks the player **Clean**, restores their saved location, and saves history. `/freeze finish <reason>` applies a configured outcome and commands. 9. **Disconnect** — If the suspect quits during an active check, `reasons.left` commands run automatically (e.g. ban for leaving). ## AFK detection The plugin tracks player activity globally: - Inventory clicks, drags, and closes - Hotbar slot changes - Camera rotation (movement without position change) - **ProtocolLib** look packets (when enabled) Settings: - `settings.afk-threshold-seconds` — inactivity time after which `/freeze checkafk` reports AFK (default 30s) - `settings.freeze-block-afk-seconds` — players inactive longer than this cannot be called for a check (default 180s / 3 min) During an active check, inactivity is tracked per session as well. ## Check history Every completed check is logged with target, moderator, status, reason, and timestamp. - **YAML** (default): `plugins/SomeFreeze/history.yml` - **MySQL**: enable in config; uses HikariCP (shaded into the JAR) View with `/freeze history <player>` (last 15 entries). ## Configuration ### Settings (`settings`) | Key | Description | Default | |-----|-------------|---------| | `check-duration-seconds` | Time until auto-action on expiry | `420` (7 min) | | `reminder-interval-seconds` | Interval for chat/title reminders | `5` | | `teleport-on-freeze` | Teleport suspect to check coords | `true` | | `world`, `x`, `y`, `z`, `yaw`, `pitch` | Check room location | `world` @ `0.5, 100, 0.5` | | `restore-location` | Return player