Mods / Vintage AFK

Tags: #Tweak #Utility
Author: 3toor1
Side: Both
Created: Feb 6th at 7:32 PM
Last modified: Feb 14th at 9:58 PM
Downloads: 1169
Follow Unfollow 30

Latest file for Various v1.20.x:
VintageAFK 1.3.0.zip 1-click install


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.

 

Version For Game version Downloads Release date Changelog Download 1-click mod install*
v1.3.0 580 Feb 14th at 9:58 PM Show VintageAFK 1.3.0.zip Install now
v1.2.1 287 Feb 8th at 10:20 PM Show VintageAFK 1.2.1.zip Install now
v1.2.0 23 Feb 8th at 8:20 PM Show VintageAFK 1.2.0.zip Install now
v1.0.2 134 Feb 7th at 10:26 PM Show VintageAFK V1.0.2.zip Install now
v1.0.1 129 Feb 6th at 11:28 PM Show VintageAFK.zip Install now

18 Comments (oldest first | newest first)

💬 binmgus, Feb 28th at 3:25 PM

when i start my game, if i'm tabbed out i am automatically put into afk mode when the world fully launches and i can't exit it at all, camera rotating around my character/around fixed point if i change to first person and my movement trajectory is locked

💬 3toor1 , Feb 13th at 2:47 AM

Tehgarin Should have a 1.3.0 update by end of weekend. itll include a tab option whichll show everyone on the servers afk status + time afk. Additionally ill add that timer in bottom right.

💬 Tehgarin, Feb 11th at 11:22 PM

Hello, I enabled the UseVisualAFKSystem in the AFK json in modconfig and both players have enabled it on their side however we get NO visual trimer gui of any kind on the screen, in the chat or aywhere in game. Where is this supposed to show up..and how do we get it to work..

Thank You

Edit: I just saw a small symbol in lower right corner that says afk.?? However it is not a Timer. And others do not get to see how long Ive been or ourselves. Is this supposed to be the GUI (timer). If so why no time>?> If the spin is on We know we are afk already..Would be NICE to be able to see how long others are afk. An actual Timer. Maybe on mouse over onother player we see a timer would be nice.

Love the mod ty for your effort. Its been great help to have this in server. AND I agree I would love an AFK kick time also if afk for too long..

💬 3toor1 , Feb 9th at 5:49 AM

Mykeal That will be an addition in 1.3.0 update

💬 Mykeal, Feb 9th at 5:22 AM

Is there any way to add an afk kick timer to the mod?

💬 3toor1 , Feb 8th at 9:53 PM

mja00 I could add that, for now if it makes you sick, you could disable that. Ill push out an update for that in next 3 hours

Edit: done

💬 mja00, Feb 8th at 9:43 PM

Any chance we can get a config to change the rotation speed? For me it spins pretty fast (no idea if tied to framerate or what) and it makes me a little motion sick when tabbed out but can still see the game lol

💬 3toor1 , Feb 8th at 8:26 PM

Nahmy thanks! I added a feature so that the config file will auto update when new config settings are added, so next time you update you dont have to delete then regen those!

💬 Nahmy, Feb 8th at 4:45 PM

Regenerated my configs and the new lines appeared with the patch. Thanks for that!

💬 3toor1 , Feb 8th at 4:18 PM

Mawg good point, I will push out another update to include movment with mouse clicking, moving, etc.

💬 Mawg, Feb 8th at 9:19 AM

the /afk function triggered when i was standing still by the anvil processing iron blooms,  i was only moving the mouse and pressing the mose buttons and using "shift" 
it happened twice.

💬 3toor1 , Feb 7th at 5:48 PM

SalazarWindriver I see what youre saying. Originally I thought you meant hunger wouldnt keep working after unafking, but I see that when I am afk with 70% hunger then go unafk, my hunger is completely depreciated. I will work on a patch for this!

 

Nahmy Youre right as well. I will push out in the next patch those config options, theyll be on the server side.

💬 SalazarWindriver, Feb 7th at 11:35 AM

I don't know if it is just a graphical glitch or not but after using the /afk and moving again, my hunger stayed at 0%

💬 Nahmy, Feb 7th at 8:30 AM

In the mod config files I don't see a field for invincibility/hunger drain flags on either the client or server file, what flags would I need to set to turn those on or off?

💬 SalazarWindriver, Feb 7th at 3:33 AM

Mendall please consider this my upvote.

💬 3toor1 , Feb 6th at 11:29 PM

@mja00 good find, thanks. i normally zip up the debug path and it doesnt have that publish folder. re zipped and reuploaded!

💬 Mendall, Feb 6th at 10:01 PM

You know you have a well-developed mod community when there are even mods to improve your experience while NOT playing the game. :)

Now all I need is a vintage story mod to do my job for me so I can play VS at work. And still look productive.

💬 mja00, Feb 6th at 9:52 PM

The mod currently doesn't load. It looks like there's a "publish" folder in the zip with the same contents as the mod and it confuses it. If I unzip and rezip just the publish folder then the mod works. 

 (edit comment delete)