Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

BadWordBlocker plugin logo


A Chat Filter which can block certain things

Plugin version PocketMine-MP API version Downloads on Poggit License Discord Website

Download BadWordBlocker plugin release BadWordBlocker plugin features

Description | Features | Usage | Contribution | License

πŸ“™ Description

BadWorkBlocker is a chat filter suitable for every server to keep the chat clean from swear words and spam (including ready-to-use lists). It can prevent swear words, sending the same message twice, sending too many messages and using caps lock. Additionally, it can filter messages that contain IP addresses, websites or e-mail addresses. Filtering is done at each aspect of the game, including the public server chat, private tell messages and text on signs. The plugin is highly configurable for nearly every needs.

🎁 Features

The main features of this plugin are:

  • SWEAR FILTER Block messages containing swear words (specified in the config file)
  • BLOCK SAME MESSAGES Show a warning to the player if he tries to send the same message twice
  • PREVENT SPAM Prevent spam by preventing the player to send messages in an interval shorter than specified in the config
  • ANTI CAPS Filter messages containing too much uppercase letters
  • BLOCK ADDRESSES Prevent sending IP addresses, websites/domains and e-mail addresses into the chat
  • IMPORT LISTS Import profanity word list from internet sources right into the plugin's config
  • ADVANCED FILTERING Not only check chat messages, but also private messages or text on placed signs

πŸ–± Usage

All settings can be changed in the config.yml-file, there are no commands:

# Language of the plugin messages
# Possible options are: en (English), de (German), fr (French), ru (Russian), tr (Turkish), id (Indonesian)
language: "en"

# Try to automatically detect the player's language and send translated messages for each player
# (language set above is used if player's language can't be detected)
autodetectlanguage: true

# List of the blocked words
  - "fuck"
  - "shit"
  - "bitch"

# Ignore spaces in messages when checking for swear words / spam
ignorespaces: true

# Show the player which word has been blocked
showblocked: false

# Minimum time between chat messages in seconds
waitingtime: 2

# Percentage of uppercase chars in a message required to trigger caps checker
uppercasepercentage: 0.75

# Minimum amount of chars in a message required to activate caps checker (to avoid blocking HI, OK, etc.)
minimumchars: 3

# Filter web addresses like IP addresses, domains, or email addresses
filter_web_addresses: true

# Check placed signs if they violate a filter
check_signs: true

# After how many violations against the chat filter, a player should be kicked/banned - set to 0 to disable
# Violations are reset after a server restart
  kick: 0
  ban: 0
  resetafterkick: true # reset violations after kick (this disables banning if kick-count is lower)

# Send a reminder message once per session if bypassing filters using ones permissions
send_bypassed_message: true

Read the full documentation πŸ“– β€’ Ask questions on Discord πŸ’¬

πŸ™‹β€ Contribution

Feel free to contribute if you have ideas or found an issue.

You can:

Please read our Contribution Guidelines before creating an issue or submitting a pull request.

Many thanks for their support to all contributors!

πŸ‘¨β€βš–οΈ License