Limited AFK

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.