HobbyBots

Docs

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. Invite ZedBot

Use the Invite ZedBot button in the navigation. Discord will ask which server to add the app to. You do not need to enter a guild ID; Discord provides that automatically when ZedBot joins and when slash commands run.

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.

2. Open The Panel

  1. Run /zedbot panel in Discord.
  2. Choose whether ZedBot should create channels or use channels you select.
  3. Enter server name, server host, and query port.
  4. Enter RCON host, RCON port, and RCON password.
  5. Enter SFTP host, SFTP port, username, and password.
  6. Press Find Logs Folder, or paste the logs directory from WinSCP/FileZilla if your host blocks folder discovery.

3. Run Checks

Use the command list to confirm each connection before starting the bridge.

  • /zedbot test_query checks the Project Zomboid query/status port.
  • /zedbot test_rcon checks RCON login.
  • /zedbot test_sftp checks SFTP login and saved logs directory access.
  • /zedbot test_logs shows the file ZedBot will tail.
  • /zedbot players shows player count when the host answers query requests.

4. Start The Bridge

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

  • /zedbot bridge_start starts hosted log tailing and chat relay.
  • /zedbot bridge_stop stops the bridge.
  • /zedbot bridge_restart restarts the bridge.
  • /zedbot rcon runs an RCON command from Discord.

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.