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.