AfkDetector

🛡️ AfkDetector

AfkDetector is a lightweight, low-impact AFK detection plugin for Hytale servers.

It monitors player activity using horizontal movement sampling, marks players as AFK after a configurable idle period, optionally warns them, and can safely kick idle players using the server’s native command system.

Designed to be:

⚡ Performant

🔄 Reloadable

🧰 Admin-friendly

✨ Features

Detects AFK players based on player movement

Seconds-based configuration (no millisecond spam)

Live config reload (/afk reload)

AFK status command (/afk)

Reset AFK timer (/afk reset)

List AFK players (/afk whois)

Optional automatic kicking

Permission-based bypass (no kicks for admins)

Reload-safe scheduling (no server restart required)

📦 Installation

Build the plugin JAR

Place the JAR into your server’s mods/ directory

Start the server

Edit config.json in the plugin data folder

Reload the plugin with: /afk reload

⚙️ Configuration (config.json)

All values are seconds-based for readability and minimal server impact.

{ "checkEverySeconds": 5, "afkAfterSeconds": 180,

"kickEnabled": false, "kickAfterSeconds": 600, "warnBeforeKickSeconds": 30,

"moveEpsilon": 0.08,

"afkMessage": "[AFK] You are now AFK.", "backMessage": "[AFK] Welcome back!", "warnMessage": "[AFK] Move or you will be kicked soon.", "kickMessage": "Kicked for being AFK too long.",

"bypassPermission": "afk.bypass", "reloadPermission": "afk.reload",

"enableCommand": true }

⌨️ Commands

Command Description

/afk Shows your AFK status

/afk reset Resets your AFK timer

/afk reload Reloads config.json

/afk whois Lists all AFK players

/afk whois <name> Shows AFK status for a specific player

Permissions

Permission Description

afk.bypass Exempt from AFK kicks

afk.reload Allows /afk reload and /afk whois

How It Works

Players are checked at configurable interval (default 5 seconds)

Horizontal Movement beyond a small threshold counts as activity

After being idle long enough, players are marked AFK

Optional warnings and kicks use the native server command

All logic runs safely on the world thread

Comparability & Design

Designed for modern Hytale server builds

Avoids fragile API dependencies

Uses reflection where APIs differ between version

Safe to reload without restarting server.