Skip to content

Get 25% OFF your first month on every game! 🎉

Outside Australia? Our international site shows prices in US dollars, with the location you choose.
Outside Australia? Our international site shows prices in US dollars, with the location you choose.

Project ZomboidSettings and admin

Set up a Project Zomboid chat filter

Ban, kick, mute or hide banned words in Project Zomboid chat with the game's own word-list filter, set in the server .ini with the File Manager.

Updated 3 min read

Project Zomboid has a built-in chat filter. You give the server a list of banned words, and it either hides each word in chat or punishes the player who typed it. The panel's Server Settings tab doesn't list these settings, so you set them in the server's .ini file with the File Manager. Checked against Build 42.21, October 2026.

What the filter settings do

Setting in the .iniWhat it does
BadWordListFileThe file with the banned words, one word per line. Blank by default.
GoodWordListFileA second file of words that stay allowed even when they contain a banned word, one per line.
BadWordPolicyWhat happens to the sender: 1 ban, 2 kick, 3 record the violation in the database, 4 mute. The default is 3.
BadWordReplacementThe text shown in chat in place of the banned word. The default is [HIDDEN].

Start with policy 3, which only records the violation. Policies 1 and 2 act on the sender, so test your word list before you use them.

Warning

Policy 1 bans the sender. Put the exceptions in the allowed-words file first, test with a second account, and only then think about 1.

Running your Project Zomboid server somewhere else?

Move it to Sydney and upload your world in the panel. From A$10 a month.

Set it up

  1. Make a plain text file with your banned words, one per line, and a second one for allowed words if you need it.
  2. Open the File Manager and go to the .cache/Server folder, where the server's settings file lives. Upload both files there. How to manage your server files covers uploading.
  3. Press Stop on the Console tab. The Server Options > Startup Parameters page shows your World / Save Name, and the settings file is named after it, such as Dedicated.ini.
  4. Open <world>.ini and fill in the lines. Use the path of your word file as the game expects it: BadWordListFile=/home/container/.cache/Server/badwords.txt
  5. Set BadWordPolicy and, if you want, BadWordReplacement. Save the file.
  6. Start the server from the Console tab.

The panel keeps lines it doesn't know about. Saving a card in Server Settings later rewrites only the settings you changed, so your filter lines stay.

Check that it works

  1. Join with a second account.
  2. Type one of your banned words in chat.
  3. Look in the second account's chat window. The server sends your BadWordReplacement text in place of the banned word, in global and local chat and to a linked Discord channel. Your own chat window still shows the word as you typed it.

To check without a second account, open .cache/Logs in the File Manager. The newest file ending in _chat.txt shows each message as the server sent it, with the replacement.

Other chat controls in Server Settings

The Chat & voice card has Global chat, which turns the server-wide channel off and leaves local, faction and safehouse chat. Two more chat settings are in the .ini only: ChatMessageCharacterLimit (default 200, from 64 to 1024) and ChatMessageSlowModeTime (default 3, from 1 to 30).

To remove a player who keeps breaking the rules, see Project Zomboid admin commands and access levels. To change the rest of the server's rules, see Project Zomboid server and sandbox settings.

Common problems

  • The filter does nothing. Check that BadWordListFile isn't blank, that its path matches where you uploaded the file, and that you restarted the server after the edit.
  • A safe word is hidden. The banned word is part of it. Add the safe word to the allowed-words file.
  • You edited the wrong file. Take a backup before you edit by hand, and restore it if the server won't start: How to create and restore backups.

Ready to launch your Project Zomboid server?

Aussie hardware, NVMe disks and DDoS protection, with the version and mod loader yours to change whenever you like.

See Project Zomboid plans