Get started

Free trial Try any game free for 3 days. No card needed. Start a free trial Start a free trial

Game servers

All games
Compare all games Try any game free for 3 days

Guides / Project Zomboid / Basics

Connect a Project Zomboid server to Discord

Show your Project Zomboid server in a Discord channel, post its events there, and bridge in-game chat to Discord with the game's own bot setting.

Updated , checked on Project Zomboid Build 42.21

There are two separate ways to link a Project Zomboid server to Discord. The Discord page shows the server’s status in a channel and posts events such as a start or a crash. The game’s own chat bridge, in the Config Editor, copies in-game chat to a channel. Use either or both. More about the game: Project Zomboid servers.

Show the server’s status in a channel

The panel’s bot keeps one message in a channel up to date: whether the server is up and how many players are on. It can also rename the channel.

  1. Open the Discord page.
  2. In Status in Discord, choose Add the bot (1) and add it to your Discord server.
  3. Follow the step “Link your Discord account”. The panel uses it to check that you run that Discord server.
  4. In Discord, right-click the channel and choose Copy Link.
  5. Back in the panel, choose Link a channel (2) and paste the link into Channel link or ID.
  6. Choose what the message shows. Show mods button adds a button with the full mod list. Show the join address shows the address.
  7. Choose Link channel.

The message is posted at once and updates every minute.

Not checked live on 18 October 2026: the Link a channel box and a test post.

The Discord page with Add the bot and Link a channel in the status card, and the Event posts card below
  1. Add the bot
  2. Link a channel
  3. Event posts
  4. Webhook URL

The message shows the map, the players, the number of mods, the status and the session uptime. For Project Zomboid it uses the server’s name from the Config Editor (Server name). The status also says “password protected” if a join password is set, “whitelist only” if Anyone can make an account is off, and “PVP off” if players cannot hurt each other.

Rename the channel to show the server puts an icon, the server’s name and the player count in the channel name. Discord allows two renames in ten minutes, so it changes every 11 minutes at most. The bot needs the Manage Channels permission.

Use Update now to refresh a message, Edit to change it and Unlink to remove it. Unlinking deletes the status message.

Post events to a channel

The Event posts card posts when the server starts, stops, crashes or finishes a backup. It uses a webhook from your own Discord. No bot is needed.

  1. In Discord: channel settings, Integrations, Webhooks, New Webhook, Copy Webhook URL.
  2. On the Discord page, find Event posts and paste the address into Webhook URL. It starts with https://discord.com/api/webhooks/.
  3. Under “Post when the server”, tick Starts, Stops, Crashes or Finishes a backup. An AI assistant request is also on the list.
  4. Choose Save, then Send a test and check the channel.

The picture above shows the Event posts card and Webhook URL. Events are posted within 20 seconds. Remove stops the posts. The webhook stays in your Discord until you delete it there.

Bridge in-game chat to Discord

The game has its own Discord bridge. The game’s bot posts everything written in the global chat (/all) to a Discord channel. Messages in Discord that mention the bot with @, or reply to it, are posted into the global chat. This needs a bot of your own.

Make the bot

  1. Log in to the Discord Developer Portal and choose New Application. Name it and accept the terms.
  2. Open the Bot section. Choose Reset Token and copy the token. Discord cannot show it again. Keep it private: anyone with it controls the bot.
  3. Open OAuth2. Under scopes tick bot, and under bot permissions tick Send Messages.
  4. Copy the generated address and open it in a browser. Pick your Discord server and choose Authorize. You need the Manage Server permission there.

Set it up on the server

  1. Open the Config Editor and find the group Discord.
  2. Switch on Discord chat bridge (1).
  3. Paste the token into Discord bot token (2).
  4. In Chat channel (3), type the name of the channel for chat both ways.
  5. In Log channel (4), type the name of the channel for joins and deaths.
  6. Save and restart the server. Saved changes apply after a restart.
The Discord rows in the Config Editor
  1. Switch the bridge on
  2. Paste the bot token
  3. Chat channel
  4. Log channel
  5. Command channel, locked

Not checked on Build 42.21 as of 18 October 2026: using a channel ID in place of the name, what else the bot needs to read Discord messages, and what the Log channel posts besides joins and deaths.

Why there is no Command channel

The Command channel row is locked and stays empty (5). The game runs every message in that channel as a server console command. Anyone who could post there would then be an admin of your server. So the panel empties it at every start. To run commands, use the Console page.

By hand

Edit the server’s .ini file in Files (in the .cache/Server folder). The keys are:

DiscordEnable=true
DiscordToken=
DiscordChatChannel=
DiscordLogChannel=

Add your token and the channel names, then restart. Leave DiscordCommandChannel= empty.

If it does not work

  • No messages reach Discord. Check that the bot is in your Discord server and that it may send messages in that channel. Check the channel name for typos, and that Discord chat bridge is on.
  • The bot posts twice, or only one way. The game had these faults on Build 41, and The Indie Stone planned a fix for Build 42. A restart cleared them on Build 41.
  • The Discord page says the panel cannot check who runs a Discord server. Ask support to link a channel for you.
  • The webhook is refused. It must start with https://discord.com/api/webhooks/. If posting stopped, save a working address to start again.

Sources: pzwiki.net: Discord, pzwiki.net: Server settings, discord.com: Developers

Project Zomboid serversAll Project Zomboid guides