Filter

You can filter specific words in the chat to prevent players from using inappropriate or offensive language. For each filtered word, you can choose from the following actions:

• ✅ Replace the word with a custom string

• 🚫 Cancel the message entirely

• 📢 Notify staff about the incident

• 🔨 Punish the player using a command

---

🧾 Example Configuration

fuck:
  variations:
    - "f*ck"
    - "f1ck"
    - "fk"
    - "fuck"
  punishment:
    enabled: false
    command:
      - warn %player% Bad word
  replacement:
    enabled: true
    replace: "****"
  cancel:
    enabled: false
    message:
      - "&cYou cannot say that!"
      - "&cIf you say that again, you will be punished!"
  notify-staff:
    enabled: false
    message:
      - "&b[Staff] &f%player% &btriggered the filter by saying &e'%word%'"
      - "&bMessage: &e%message%"

---

⚙️ Configuration Breakdown

Option	Description
variations	List of possible ways the word might be typed (e.g., filtered versions).
punishment	Enables punishment commands. Commands are executed by the console.
replacement	Replaces the word in the message with a custom string (e.g., ****).
cancel	Completely cancels the message. You can also send a custom message.
notify-staff	Sends an alert to staff with easystaff.filter.notify permission.

---

🔍 In-Game Tools

You can check if a word is currently filtered using the following command:

/chatfilter check (word)

This will return all filter-related info for that word.