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 .ini | What it does |
|---|---|
BadWordListFile | The file with the banned words, one word per line. Blank by default. |
GoodWordListFile | A second file of words that stay allowed even when they contain a banned word, one per line. |
BadWordPolicy | What happens to the sender: 1 ban, 2 kick, 3 record the violation in the database, 4 mute. The default is 3. |
BadWordReplacement | The 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.
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.
Set it up
- Make a plain text file with your banned words, one per line, and a second one for allowed words if you need it.
- Open the File Manager and go to the
.cache/Serverfolder, where the server's settings file lives. Upload both files there. How to manage your server files covers uploading. - 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. - Open
<world>.iniand fill in the lines. Use the path of your word file as the game expects it:BadWordListFile=/home/container/.cache/Server/badwords.txt - Set
BadWordPolicyand, if you want,BadWordReplacement. Save the file. - 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
- Join with a second account.
- Type one of your banned words in chat.
- Look in the second account's chat window. The server sends your
BadWordReplacementtext 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
BadWordListFileisn'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.
Related guides
Project ZomboidConnect Project Zomboid to Discord
Link Project Zomboid's built-in Discord bot to your server: make the bot, paste its token and the chat channel's name in the Discord tab, and restart.
Updated 15 Nov 20264 min read
Project ZomboidProject Zomboid anti-cheat settings
Set each of the ten anti-cheat checks to ban, kick, log or disabled, and check Steam VAC and the file checksum on your server.
Updated 21 Nov 20263 min read
Project ZomboidZomboid combat and firearm damage rules
Turn on multi-hit, choose chance-to-hit or chance-to-damage for guns, and set PvP melee and firearm damage on your Project Zomboid server.
Updated 21 Nov 20264 min read