Obscura's Eye AFK Watchdog

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

1. Drop the mod on the server (client optional unless you want the manage/captcha UI visuals).
2. Edit obscuraseye-server.toml to match your policy (timeouts, smart detection, messages).
3. 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.