Dosu Logo
Ask
Documents
README
README
Type
External
Status
Published
Created
Jun 17, 2026
Updated
Jun 17, 2026
Source
View

lst-bot#

Steam
Discord

English | 简体中文

lst-bot is a general-purpose IM bot for the LST player community.

LST logo

Let's Starve Together (LST) is a community formed around Don't Starve Together (DST). The repository contains the LST bot app and an embedded async bot framework. app/ holds the current bot behavior, while src/lst_bot/ handles OneBot ingress, event dispatch, dependency injection, scheduled jobs, and action execution.

What It Does#

  • Connects through NapCat / OneBot 11.
  • Looks up DST versions, Klei lobbies, room details, and online players.
  • Manages local DST rooms for the LST group: save, rollback, restart, and regenerate.
  • Sends scheduled active-room reports to an IM group.
  • Answers DST questions with Gemini + Dosu MCP.

Architecture#

Loading diagram...

Layout#

  • app/: bot entrypoint, runtime settings, DST question agent, and systemd files.
  • app/systemd/: NapCat container and lst-bot service units.
  • src/lst_bot/: embedded bot framework.
  • src/lst_bot/clients/: Klei, local DST control, Hitokoto, and related clients.
  • tests/: protocol, routing, gateway, and client tests.

Configuration#

The app reads .env from its working directory. Development and deployment both run from app/, so the usual location is app/.env.

Core settings:

NamePurpose
ONEBOT_WS_URLNapCat OneBot 11 WebSocket URL
ONEBOT_ACCESS_TOKENOneBot access token
BOT_ADMINAdmin account IDs
BOT_CMD_PREFIXESCommand prefixes
REPORT_GROUP_IDIM group for scheduled reports
KLEI_ACCESS_TOKENKlei lobby/read token
KLEI_HOST_IDDST host ID managed for the LST group
GEMINI_API_KEYGemini question answering
DOSU_MCP_ENDPOINTDosu MCP endpoint
DOSU_API_KEYDosu access token
HTTP_PROXYProxy for outbound HTTP requests
LOG_LEVELLog level

Development#

  • just sync: sync dependencies and install hooks.
  • just dev: start the bot from app/main.py.
  • just check: run CI-style checks.
  • just test: run the full test pipeline.
  • just build: check and build the package.

Deployment#

The default paths are /srv/lst-bot and /srv/napcat.

app/systemd/napcat.container is a Podman Quadlet file. It generates napcat.service and stores NapCat config plus QQ data under /srv/napcat/config and /srv/napcat/ntqq.

app/systemd/lst-bot.service starts the bot from /srv/lst-bot/app after napcat.service.

Deployment checklist:

  1. Place the repository at /srv/lst-bot and run just sync.
  2. Enable the NapCat container and make sure its OneBot 11 WebSocket is reachable.
  3. Fill app/.env with OneBot, Klei, Gemini, Dosu, and report-group settings.
  4. For room management, provide local dst@<room>.service units.
  5. Make sure the service user can control lst-bot, NapCat, and DST room units.

If the paths change, update WorkingDirectory, ExecStart, and NapCat volumes in the systemd files.