Skip to content

Default config

YouHaveTrouble edited this page Jun 27, 2026 · 3 revisions
# Should server operators bypass the filters?
op-bypass: true

# Should players be denied to join if their name contains bad words?
kick-on-bad-name: true

# Which events should be checked for bad words?
checks:
  chat: true
  sign: true
  book: true
  command: true
  anvil-name: true
  nametag-use: true

# Should detections that contain filtered words be logged in console
log-detections: true

# Should detections that contain filtered words be sent to players
notify-detections: true

# Commands of which arguments should be checked.
# It's recommended to list all private message commands and their aliases
# and every command that allows changing item name etc.
filtered-commands:
  - msg
  - w
  - say
  - me

# filter messages based on characters they contain. If a message contains characters not
# present in regex, it will be canceled.
prefilter:
  enabled: false
  regex: "[\\p{L}0-9\\s;.\\/<>()!@#$%^&*|:~+=\\-_,?\"'\\[\\]]+"
  failed: "Censura - Your input contained disallowed characters."

# These characters are replaced by the character on the right before processing.
replacements:
  '0': o
  '1': i
  '3': e
  '4': a
  '5': s
  '7': t
  '9': g
  '$': s
  '@': a

# Check if the current chat message is similar to the messages sent before
similarity:
  # Should the feature be enabled?
  enabled: false
  # How many previous messages to check
  messages-to-check: 3
  # Minimum number of similar previous messages required to block
  max-similar-messages: 1
  # Percentage of how similar messages should be to be flagged as similar to previous ones
  threshold: 80
  actions:
    - "message: Censura - Stop sending spammy messages, %player%!"

##### FILTERS
# Filters are processed in order from top to bottom
# You can have an unlimited number of filters.
###############################################################
# Each filter has a list of "matches". These are words that are checked for the filter.
# Types of matches:
#   - "fullword" Checks if the sentence contains this word. It must be surrounded by spaces.
#                Besides that, the filter is smart and will ignore any characters in between the word.
#                You can use the * character to bypass the limitation of needing a space: "test*" will match on "testsomething"
#   - "contain"  Checks if the sentence contains the string, the string may be part of another word.
#                Will ignore spaces inside the word unless they're used in an obviously spammy way.
#   - "regex"    Match a simple regex on the string. No smartness involved.
# By default the "fullword" match type is used.

###############################################################
# Each filter can have an unlimited number of "actions". Possible "action" types:
#   - "message: <message>" - sends a message to player who triggered the filter
#   - "command: <command>" - executes command as console.
# Placeholders available for all actions:
# %player% - name of the player who triggered the filter

filter:
  severe:
    action:
      - "command: ban %player% Censura - Using offensive words."
    match:
      - nigger
      - nibber
      - niga
      - niba
      - hitler did nothing wrong
      - heil hitler
  normal:
    action:
      - "command: kick %player% Censura - Stop using curse words!"
    match:
      - fuck: "contain"
      - bitch
      - faggot
      - tranny
      - trannie
      - gay is a sin
      - gay is sin
  light:
    action:
      - "message: Censura - Stop using bad words, %player%!"
    match:
      - sex
      - porn: "contain"
      - shit: "contain"
      - fag: "contain"
      - nigg: "contain"

# Messages used by the plugin
messages:
  no-permission: "Censura - &cYou don't have permission to do this."
  no-such-command: "Censura - &cThere is no such command."
  config-reloaded: "Censura - &aConfiguration reloaded."
  kick-bad-name: "Censura\n&cYour name contains bad words!"
  # Placeholders: %player%, %message%, %snippet%, %check%
  detection: "&c%player% &7wrote &4\"%message%\" &7containing: &4\"%snippet%\" &7in: &c%check%"
  notification-enabled: "Censura - &aNotification enabled."
  notification-disabled: "Censura - &cNotification disabled."
  notification-status: "Censura - &7Your notifications are currently %status%&7."
  notification-status-enabled: "&aenabled"
  notification-status-disabled: "&cdisabled"

Clone this wiki locally