Skip to content

Status Monitor Settings

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

Description

Watches for game messages that look like a staff member checking on you. It runs in the background and learns which lines are normal: anything from players or NPCs in the room, lines in base-filters.yaml, and lines it has seen before are ignored. When several new, unfamiliar lines arrive close together, it treats that as a check: it beeps, does any game command written in capitals in the message (such as JUMP), can answer for you, sends you a Slack message, and can log you out.

It isn't stopped by ;kill all or paused by ;pause all; use ;kill status-monitor.
It shows a small window with your health and the lines it flagged, unless you turn the window off. The window needs Lich with GTK.
The lines it has learned are saved between runs, in seen_messages_<character>.dat in your Lich folder.
In the window, your health bar can't turn red: a typo in the script raises an error when your health drops below 75%. Use nowindow to avoid it.

Settings

YAML Settings

status_monitor_no_window: false
status_monitor_respond: false
quit_on_status_warning: false
unique_line_threshold: 4
line_frequency_threshold: 6
line_similarity_percentage: 70
slack_username:
Setting Default Purpose
status_monitor_no_window false Don't open the window.
status_monitor_respond false Answer a check by saying "Hmmm?", "Yes" or "Ok?".
quit_on_status_warning false Log out when it sees a check.
unique_line_threshold 4 A check when one new line repeats more than this many times among the last 20.
line_frequency_threshold 6 A check when this many similar, but not identical, new lines arrive within 90 seconds.
line_similarity_percentage 70 How alike two lines must be, in percent, to count towards line_frequency_threshold.
slack_username Your Slack name, for the alerts.

Argument Settings

Argument Purpose
nowindow Don't open the window.
debug Write each flagged line to status-monitor-debug-<character>.txt.

Usage

;status-monitor

;status-monitor nowindow

Autostart

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

autostarts:
  - status-monitor

Clone this wiki locally