HobbyBots

Add ZedBot and connect your Project Zomboid server.

This guide walks through invite, channel setup, server configuration, checks, Premium bridge controls, and the boundaries of what ZedBot does.

1. Gather Your Details

  • Decide which Discord channels ZedBot should use for status, chat bridge, and admin messages. You can let ZedBot create these for you during setup, or point it at channels you already have.
  • Set an RCON password and find your RCON port in your Project Zomboid server's servertest.ini file (or your host's control panel) — look for the RCONPassword and RCONPort settings.
  • If you're on a third-party host, your SFTP or FTP host, port, username, and password are usually listed in your hosting provider's control panel under something like "File Access" or "FTP Details."

2. Invite ZedBot

Use the Invite ZedBot button in the navigation.

Invite ZedBot
Recommended permissions: View Channels, Send Messages, Read Message History, Use Slash Commands, Embed Links, and Manage Channels if you want ZedBot to create channels during setup.

3. Run Setup And Explore The Panel

  • Run /zedbot setup in your Discord commands channel to start the guided flow.
  • Free servers can skip the RCON and SFTP/FTP steps — status and player count still work fine without them, and you can add RCON/SFTP later with Premium to enable the chat bridge.
  • Channels, Server, RCON, and SFTP/FTP buttons open each settings section; Find Logs Folder locates your remote log file automatically.
  • Config Review shows your saved values with secrets masked, and its Test RCON / Test SFTP/FTP buttons confirm those credentials actually work.
  • Players shows the live player count and Refresh updates the panel. Premium servers also get Start Bridge, Restart Bridge, Stop Bridge, and Diagnose.

4. Start The Bridge

After checks pass, Premium servers can start the live bridge.

  • Start Bridge button starts hosted log tailing and chat relay.
  • Stop Bridge button stops the bridge.
  • Restart Bridge button restarts the bridge.

What ZedBot Does

  • Connects one Discord server to one Project Zomboid server.
  • Creates or stores Discord channel selections.
  • Stores server, query, RCON, SFTP, and logs settings.
  • Tests SFTP, remote logs, RCON, and query/status access.
  • Relays Discord chat into the game through RCON.
  • Relays game chat back to Discord from hosted log tailing.
  • Shows status, diagnostics, player counts, plan state, and command help.

What ZedBot Does Not Do

  • It does not replace your game host control panel.
  • It does not bypass blocked provider ports or network restrictions.
  • It does not guarantee every host exposes query responses publicly.
  • It does not manage Project Zomboid mods or world settings.
  • It does not start a stopped remote server unless your host exposes that through supported RCON behavior.
  • It does not need users to run a local EXE for the hosted app flow.

Troubleshooting

Slash Commands Do Not Show Up

Kick and re-invite the bot with the applications.commands scope, then wait for Discord to refresh commands. Local test servers may sync faster than global production commands.

Query Times Out

Some managed hosts let players join but do not expose Steam-style query responses. SFTP, RCON, and bridge features can still work.

SFTP Times Out

Check the exact SFTP host, port, username, and password from the host panel. Test the same values in WinSCP or FileZilla.

Bridge Cannot Post In Discord

Use /zedbot channels to confirm saved channels, then grant ZedBot View Channel and Send Messages permission in those channels.

Premium Did Not Update

Run /zedbot plan. ZedBot checks Stripe before showing the plan, so this can refresh a delayed checkout, cancellation, or refund update.