Skip to content
kahlen-tech edited this page Nov 4, 2026 · 1 revision

Description

A safety net for when you're away from the keyboard. It runs in the background and logs you out of the game when things go wrong: your vitality or spirit drops below health_threshold, you die, you get in trouble with the law too often, or you're stuck in the junk yard. It also stops you being logged out for idling, and sorts out a few things that can stall your scripts.

It isn't stopped by ;kill all or paused by ;pause all; use ;kill afk.
When it starts, it waits 10 seconds, then until your vitality and spirit are 20 above health_threshold (or full).
With slack_username set, each logout message is also sent to you on Slack.

Settings

YAML Settings

health_threshold: 50
depart_on_death: false
depart_type: item
afk_justice_threshold: 4
slack_username:
Setting Default Purpose
health_threshold 0 Set this. Log out when your vitality or spirit drops below it. Halfway between this and 100, it warns you: "Afk - approaching low vitality/spirit threshold".
depart_on_death false When you die, DEPART before logging out.
depart_type item How to depart, e.g. item, coins or full.
afk_justice_threshold 4 Log out after this many run-ins with the law.
slack_username Your Slack name, for the logout messages.

What it does:

When It
Your vitality or spirit is below health_threshold Checks HEALTH, turns off your avoids with AVOID ALL, and logs out: "Detected low vitality/spirit health".
You die Counts down 3 minutes, departs if you set depart_on_death, and logs out: "You died!"
A mob calls for you to burn, or the authorities want you for endangering the public Releases any spells that break the law. After more than afk_justice_threshold of these, logs out: "It looks like you've run into trouble with the law too many times".
You land in the junk yard Logs out after 60 seconds, unless you leave first.
You've been idle too long, or neither you nor a script has sent anything for 6 minutes Sends TDP, TIME or AGE.
You must empty your hands, or there are items at your feet Empties your hands, or stows what's at your feet, and stops go2.
You're stuck in the Skeletal Claw Stands up and goes out.

Argument Settings

None.

Usage

;afk

Autostart

Add it to the autostarts: list in your setup YAML:

autostarts:
  - afk

Clone this wiki locally