Zombot v0.6 Beta

Zombot is a Project Zomboid x Discord bot

What Zombot does

Zombot is built to handle a small, practical set of Discord-server tasks for a Project Zomboid server:

• Posts server status to a Discord status channel
• Updates Discord presence with player count or offline state
• Bridges in-game chat to Discord
• Bridges Discord bridge-channel messages into the game
• Supports a small set of Discord commands for admin/server use

What Zombot does not do

Zombot does not:

• manage or edit your Project Zomboid server configuration for you
• start or restart a remote hosted server from a provider panel
• replace your host control panel
• bypass host restrictions
• guarantee compatibility with every provider setup or custom server environment
• include setup automation beyond the values the launcher already supports

Editions

Zombot Local

Use Zombot Local when the game server and the bot are running on the same machine.

Local mode is designed to:

• use local Project Zomboid files
• detect local server configuration files
• use local log paths
• avoid SFTP setup entirely

Zombot SFTP

Use Zombot SFTP when the server is hosted remotely and chat logs must be read through SFTP.

SFTP mode is designed to:

• use launcher-entered server query values
• use launcher-entered RCON values
• use launcher-entered SFTP credentials
• read the remote Logs folder you provide

Required values

Local edition

You will typically need:

• Discord bot token
• Status channel ID
• Bridge channel ID
• Admin IDs, if you want user-ID-based command control
• Correct local Project Zomboid server setup on the same machine

SFTP edition

You will typically need:

• Discord bot token
• Status channel ID
• Bridge channel ID
• Admin IDs, if you want user-ID-based command control
• Server IP / Host
• Query Port
• RCON Host
• RCON Port
• RCON Password
• SFTP Host
• SFTP Port
• SFTP Username
• SFTP Password
• Remote Logs Dir

Commands

Zombot includes the following command set in this beta release:

• !help or !commands — show command list
• !players — show current player count
• !status — show mode and active query/chat source details
• !save — save the world
• !start — explains that startup is done from the launcher UI
• !restart <minutes> — save and quit after an optional delay; restart may still need to be done in the host panel
• !shutdown <minutes> or !stop <minutes> — save and quit after an optional delay
• !announce <text> — optional legacy broadcast command

Some commands require admin permission.

Permission model

Admin access is controlled by either:

• matching allowed Discord user IDs, or
• matching configured admin role names

If neither applies, admin-only commands are denied.

Notes for use

• Discord-to-game relay only works from the configured bridge channel.
• Command messages are not treated as normal relay messages.
• If your host does not allow a full remote restart over RCON, Zombot can still save and quit, but restart may need to be done in the provider panel.
• Remote-host setups depend on correct Query, RCON, and SFTP values.
• If your Remote Logs Dir is wrong, game-to-Discord relay will not work.

Beta release note

This is v0.6 Beta.

This release is intended to provide a clean, working first beta with a narrow feature scope. It is intentionally lean.

Support and licensing

Zombot Local and Zombot SFTP are licensed separately.

Use of either edition is governed by the included license. Commercial or organizational use beyond a standard personal license requires the proper commercial license or unlock.