Limited AFK

A fairly straight-forward server-sided mod to limit how much your players can AFK and tracks all players' playtime.

This mod should only be installed on a server.

Player Commands

• /playtime Tells the player how much real-time they have played and AFK'd on the server
• /afklist Lists the players online and who is/isn't AFK

Admin Commands & Configuration

Configuration can be done through the properties file generated when loaded on a server or through commands.

• /playtime <player> Gets the playtime of the specified player
• /playtime all Gets the playtime of all players who have logged on the server. Dumps to console and gives a clipboard copy to the admin.
• /playtime actions <player> Gets the amount of time since a player has performed one of the actions tracked by the AFK algorithm.
• /limitedafk Gets the current configuration settings
• /limitedafk enabled <true/false> Enables/disables the AFK tracker
• /limitedafk ignoreCreativeAndSpectator <true/false> Sets whether the AFK tracker should mark Creative and Spectator players as AFK
• /limitedafk allowedAfkPercentage <0-100> Sets the percentage of a player's playtime can be spent AFK before kicking them
• /limitedafk announceAfk <true/false> Sets whether a chat message is announced when a player goes AFK or comes back from AFK
• /limitedafk afkTimer <60+> Sets how many seconds of inactivity it takes until a player is marked as AFK
• /limitedafk defaultAfkDetectionLevel <LOW/MEDIUM/HIGH> Sets how aggressive the AFK detection is by default (LOW and MEDIUM require various levels of activity, and HIGH requires a captcha)
• /limitedafk captchaTimer <120+> Sets the interval between when someone suspected of being AFK is given a captcha (in seconds)
• /limitedafk logCommandUsage <true/false> Sets whether successful command executions are logged to the server console
• /afklevel get <player> Gets the modified (or default) AFK detection level required for the specified player
• /afklevel set <player> <LOW/MEDIUM/HIGH> Sets the modified AFK detection level required for the specified player
• /afklevel reset <player> Resets the modified AFK detection level required for the specified player to the default value

Permission Nodes

LimitedAFK uses the Fabric Permissions API for command permissions. Each node has a fallback vanilla permission level for servers without a permissions mod.

General

Node	Default	Description
limitedafk.afklist	ALL	Use /afklist to see who is AFK
limitedafk.playtime	ALL	Use /playtime to check your own playtime
limitedafk.playtime.others	GAMEMASTERS	Use /playtime <player> to check another player's playtime
limitedafk.playtime.all	GAMEMASTERS	Use /playtime all to dump playtime for all players
limitedafk.playtime.actions	GAMEMASTERS	Use /playtime actions <player> to check a player's action timestamps
limitedafk.afklevel.get	GAMEMASTERS	Use /afklevel get <player> to read a player's AFK detection level
limitedafk.afklevel.set	GAMEMASTERS	Use /afklevel set <player> <level> to change a player's AFK detection level
limitedafk.afklevel.reset	GAMEMASTERS	Use /afklevel reset <player> to reset a player's AFK detection level to default

Config

Config commands are generated automatically by BorisLib per config value.

Node	Default	Description
limitedafk.config	GAMEMASTERS	List all config values via /limitedafk
limitedafk.config.<name>.get	GAMEMASTERS	Read a specific config value
limitedafk.config.<name>.set	GAMEMASTERS	Change a specific config value

Try My Other Mods!

All server-side Fabric mods — no client installation required.

	Mod	Description	Links
	Arcana Novum	Minecraft's biggest server-only full-feature Magic Mod! Adds powerful items, multiblocks and bosses!
	Ancestral Archetypes	A highly configurable, Origins-style mod that lets players pick a mob to gain unique abilities!
	Ender Nexus	Highly configurable /home, /spawn, /warp, /tpa and /rtp commands all in one, and individually disablable.
	Fabric Mail	An in-game virtual mailbox system for sending packages and messages between online and offline players.
	Fabric Trade	Adds /trade, a secure player-to-player trading interface.
	Limited AFK	AFK detection and management with configurable kick thresholds for servers.
	Links in Chat	Makes URLs posted in chat clickable.

LICENSE NOTICE

By using this project in any form, you hereby give your "express assent" for the terms of the license of this project, and acknowledge that I, BorisShoes, have fulfilled my obligation under the license to "make a reasonable effort under the circumstances to obtain the express assent of recipients to the terms of this License.