Vintage AFK

VintageAFK – Enhanced AFK System for Vintage Story

Note: WORK IN PROGRESS. Should work in multiplayer and singleplayer, may have some small bugs. Please report issues or suggest ideas in the tracker!

VintageAFK is a customizable AFK management mod for Vintage Story, supporting both single-player and multiplayer with features including:

• AFK Player List Menu (Default: Hold P) – Displays online players and their AFK status with time spent AFK (in minutes). (Note: P key is changeable in client keybind settings screen)
• Visual AFK Countdown Timer – Displays a countdown in the bottom-right corner until the player becomes AFK.
• Skyrim-style AFK Camera Spin – Third-person camera animation during AFK.
• Invincibility While AFK – Prevents damage and hunger drain (hostile mobs ignore the player).
• No Hunger Drain While AFK – Stops food depletion (hostile mobs remain aware).

Configuration & Features

Server Configuration (VintageAFKServerConfig.json)

• TimeUntilAFK (default: 300s) – Time before a player is marked AFK.
• OverrideClientConfig – Force client settings for consistency.
• AFKGivesInvincibility – Grants invincibility while AFK.
• AFKDisablesHunger – Stops hunger drain while AFK.
• UseVisualAFKSystem – Displays the AFK timer and countdown.
• KickedWhenAFK (default: false) – Enables automatic kicking for prolonged AFK.
• TimeUntilKickedWhenAFK (default: 300s) – Kick time after entering AFK mode.
• AfkCommandHostileRadius (default: 15 blocks) – Prevents AFK mode if hostile mobs are nearby.
• PreventAFKOnChat / Mouse Move / Mouse Click – Stops AFK mode if these actions occur.

Client Configuration (VintageAFKClientConfig.json)

• UseVisualAFKSystem – (default: true) – Displays a countdown timer to AFK in the bottom-right corner.
• DisplayPlayerAFKMenu (default: true) – Enables the player AFK list menu.
• AfkCameraSpin – Activates the cinematic camera spin.
• AfkCameraSpinSpeed – Sets camera spin speed.

Commands & Permissions

• /afk (Requires VAFKCommand) – Manually enter AFK mode.
• /afk kick <playername> (This and below require VAFKAdmin) – Kick an AFK player.
• /vafkconfig time <seconds>  – Set AFK timeout duration.
• /vafkconfig kicktime <seconds> – Set AFK auto-kick duration.

Permissions:

• VAFKCommand – Required for /afk.
• VAFKAdmin – Required for admin commands.

Server-Side Controls & Anti-Abuse Measures

• Hostile Mob Radius Protection – Prevents AFK command useage if hostile mobs are nearby (15 blocks default).
• Client Config Override – Ensures consistent behavior across clients.
• AFK Auto-Kick – Optional kick feature for prolonged AFK users.