Obscura’s Eye – AFK Watchdog
Keep your server alive and fair with a lightweight AFK protection layer. Obscura’s Eye watches for real player activity, blocks AFK farms, and gently challenges idle players with a short captcha before they hog your slots.
What it does
- Tracks player activity server-side; no client mod required for enforcement.
- Smart AFK detection: small-area camping, repetitive movement/rotation, and “fake activity” patterns are ignored.
- AFK countdown & caching: players can pause/resume their AFK timer; cached time survives cancellation.
- Admin tooling: /afk manage shows remaining, used, and cached time; ops can cancel or trigger captcha.
- Captcha flow: quick numeric captcha when AFK timeout hits; configurable duration and digits.
- Configurable everything: timeouts, thresholds, cooldowns, kick messages, smart detection toggle.
- Performance friendly: runs once per second; negligible load even on large modpacks.
Ideal for
- Survival and SMP servers that want fair play without punishing legit short breaks.
- Heavy modpacks where performance overhead must stay near-zero.
Getting started
- Drop the mod on the server (client optional unless you want the manage/captcha UI visuals).
- Edit obscuraseye-server.toml to match your policy (timeouts, smart detection, messages).
- Restart the server. Use /afk to start an AFK session; use /afk manage (ops) to oversee players.
Defaults (sane, not annoying)
- AFK timeout: 10 minutes (configurable)
- Captcha: 20 seconds to solve, 6 digits
- /afk duration: 2 hours, 24h cooldown
- Smart detection: on by default; can be disabled on low-end hosts
Notes
- Client UI is optional; core enforcement is server-side.
- Designed to stay invisible in normal play and only intervene when players truly go idle.
