How jonnyptn/zomboi works
Zomboi is a Discord slash-command bot that manages a local Project Zomboid dedicated server and turns its log files into Discord notifications and player records. Users issue server, mod, and player commands; separately, file watchers parse server logs to update player and skill state or mirror chat. The graph includes the documented install/create/start/stop and reporting capabilities, plus log parsing and notification layers. Some command and server internals were not excerpted, so their documented links cite the README; unsampled implementation details are not inferred.
Main entry points: Server.cs Server control · Playerlistener.cs Player listener · PerkListener.cs Skill listener · Zomboi.cs Bot startup
Components 25
Discord interface
- Bot startup
src/Zomboi.cs - Interaction handler
src/InteractionHandler.cs - Server commands
src/ServerCommandModule.cs - Mod commands
src/ModCommandModule.cs - Player commands
src/PlayerCommandModule.cs - Channel lookup
src/Channels.cs - Discord errors
src/DiscordError.cs - Invite link
src/Invite.cs - Logger
src/Logger.cs
Server management
- Server control
src/Server.cs - Server config lists
src/ConfigList.cs
Log ingestion
- Log file watcher
src/LogFileListener.cs - Log line parser
src/LogLine.cs - Log field parser
src/LogFields.cs - Chat listener
src/ChatListener.cs - Player listener
src/Playerlistener.cs - Skill listener
src/PerkListener.cs
Player records and notifications
- Player state
src/Player.cs - Skill state
src/Perk.cs - Map links
src/Map.cs - Survival time
src/Survival.cs
Other components
- Discord user
- Discord
- SteamCMD
- Dedicated server
Connections 36
- Discord user → Interaction handler: issues commands
README.md - Interaction handler → Discord: registers commands
- Bot startup → Interaction handler: initializes
src/Zomboi.cs - Bot startup → Server control: attaches or starts
src/Zomboi.cs - Bot startup → Chat listener: sets channel
src/Zomboi.cs - Bot startup → Player listener: sets channel
src/Zomboi.cs - Bot startup → Skill listener: sets channel
src/Zomboi.cs - Server commands → Server control: controls server
README.md - Server commands → SteamCMD: installs with
README.md - Mod commands → Server control: edits mod lists
src/ModCommandModule.cs - Player commands → Server control: reads player data
src/PlayerCommandModule.cs - Server control → Server config lists: uses config lists
src/Server.cs - Server control → Dedicated server: starts and stops
README.md - Log file watcher → Log line parser: parses lines
src/LogFileListener.cs - Chat listener → Log file watcher: watches chat log
src/ChatListener.cs - Player listener → Log file watcher: watches player log
src/Playerlistener.cs - Skill listener → Log file watcher: watches perk log
src/PerkListener.cs - Chat listener → Server control: checks news window
src/ChatListener.cs - Chat listener → Log field parser: extracts chat fields
src/ChatListener.cs - Chat listener → Discord: mirrors via webhook
README.md - Player listener → Server control: updates connections
src/Playerlistener.cs - Player listener → Log field parser: extracts player fields
src/Playerlistener.cs - Player listener → Map links: formats locations
src/Playerlistener.cs - Player listener → Survival time: describes survival
src/Playerlistener.cs - Skill listener → Server control: updates player records
src/PerkListener.cs - Skill listener → Log field parser: extracts skill fields
src/PerkListener.cs - Skill listener → Player state: updates player
src/PerkListener.cs - Skill listener → Skill state: updates skills
src/PerkListener.cs - Player commands → Player state: reports players
README.md - Player commands → Map links: provides map links
src/PlayerCommandModule.cs - Player commands → Survival time: reports survival
src/PlayerCommandModule.cs - Chat listener → Channel lookup: resolves channel
src/ChatListener.cs - Player listener → Channel lookup: resolves channel
src/Playerlistener.cs - Skill listener → Channel lookup: resolves channel
src/PerkListener.cs - Bot startup → Invite link: offers invite link
src/Zomboi.cs - Discord errors → Logger: logs failures
src/DiscordError.cs