Настройка

Всё лежит в plugins/FinExBans/config.yml. Видимых сообщений там нет — они в language_en.yml, language_ru.yml, language_uz.yml. После правок — /finexbans reload.

Язык

language:
  default: en          # en | ru | uz или свой language_xx.yml
  per-player: true     # каждый игрок видит язык своего клиента, если файл есть
appeal: 'discord.gg/yourserver'   # показывается на экране бана как {appeal}

Свой язык: скопируйте language_en.yml в language_de.yml, переведите, поставьте default: de. Недостающие ключи берутся из английского.

Хранилище

storage:
  type: sqlite         # sqlite | h2 | mysql | mariadb
  host: localhost
  port: 3306
  database: finexbans
  username: root
  password: ''
  table-prefix: 'finexbans_'

Для одного сервера хватит SQLite. Чтобы делить наказания между серверами — MySQL/MariaDB, см. Сети.

Муты

mute:
  ip-scope: true       # мут распространяется на другие аккаунты с того же IP
  blocked-commands: [msg, tell, w, r, me, say, ...]

ip-scope — то, что не даёт замученному говорить через альта. Побочный эффект: двое из одного дома получают мут вместе. Если это важнее — поставьте false.

Запись с пробелом, например clan chat, сравнивается со всей командной строкой — блокируется только /clan chat …, а не весь /clan.

Лестница предупреждений

ladder:
  enabled: true
  window: 30d          # предупреждения старше не считаются
  '3': 'MUTE 1h 3 warnings'
  '5': 'MUTE 1d 5 warnings'
  '7': 'BAN 7d 7 warnings'
  '10': 'BAN perm 10 warnings'

Срабатывает только точное число: третье предупреждение — мут на час, четвёртое ничего не добавляет, пятое — мут на сутки.

Лимиты

limits:
  ban: ''              # например 30d — персонал без finexbans.limits.bypass выше не выдаст
  mute: ''
  ipban: ''

Бессрочные наказания всегда требуют отдельного права (finexbans.ban.permanent и т. д.), независимо от лимитов.

Фильтр чата

chat-filter:
  enabled: true
  words: [examplecraft, othernetwork]
  commands: [msg, tell, w, r, me]
  notify-staff: true

Перед проверкой текст нормализуется: ꜱᴍᴀʟʟ ᴄᴀᴘꜱ и ˢᵘᵖᵉʳˢᶜʳⁱᵖᵗ становятся обычными буквами, кириллические двойники (а е о р с х) — латиницей, точки и пробелы между буквами убираются, цифры превращаются в буквы (3→e, 4→a, 0→o, 1→i, 5→s), повторы схлопываются. И m.i.n.e s t 4 x, и ᴍɪɴᴇꜱᴛᴀx становятся minestax.

WARNING

Не добавляйте короткие и частые слова — они находятся внутри других слов, и безобидные сообщения блокируются.

Работает в чате, перечисленных командах, книгах, на табличках и в наковальне. finexbans.filter.bypass отключает проверку.

Оповещения

broadcast:
  enabled: true        # false = все наказания тихие (только персоналу)
alerts:
  join-attempt-while-banned: true
  alt-accounts: true

Игроки, которые не заходили

unknown-players:
  lookup: true
  online-uuids: auto   # true, если сервер offline-mode за online-mode прокси

/ban Имя работает даже для ника, который никогда не заходил: online-mode сервер спрашивает UUID у Mojang, offline-mode — считает по offline-формуле.

Длительности

30s, 10m, 2h, 7d, 1w, 1mo, 1y, вместе 2h30m, или perm.