FluxBans

# ─────────────────────────────────────────────────────────────
#  FluxBans — Основная конфигурация
#  Документация: https://github.com/sneakywrld/fluxbans/wiki
# ─────────────────────────────────────────────────────────────

# ── База данных ───────────────────────────────────────────────
database:
  # Тип бэкенда: sqlite | mysql | mariadb | postgresql
  type: sqlite

  # SQLite — путь к файлу относительно папки данных плагина
  file: fluxbans.db

  # Настройки подключения MySQL / MariaDB / PostgreSQL
  host: localhost
  port: 3306
  name: fluxbans
  username: root
  password: ""

  # Дополнительные свойства JDBC (ключ: значение)
  properties: {}

# ── Общие ──────────────────────────────────────────────────────
general:
  # Название сервера, отображаемое в записях наказаний и веб-интерфейсе
  server-name: "Survival"

  # Логировать все наказания в консоль
  log-to-console: true

  # Оповещать о наказании всех онлайн-модераторов (право fluxbans.notify)
  broadcast-to-staff: true

  # Оповещать о наказании всех онлайн-игроков
  broadcast-globally: true

  # Сколько записей показывать на странице в /history, /banlist и т.д.
  page-size: 10

  # Интервал синхронизации (секунды) — как часто получать обновления
  # наказаний между серверами при использовании общей базы MySQL/MariaDB/PostgreSQL.
  # Установите 0, чтобы отключить (нужно только для мультисерверных сборок).
  sync-interval: 30

  # Скрывать IP-адреса из вывода /check для игроков без права fluxbans.seeip
  hide-ips: true

  # Включить бан по IP в дополнение к бану по UUID
  ip-banning: true

  # Если true, бан игрока по нику также банит его текущий IP
  ban-ip-on-ban: false

# ── Исключения ────────────────────────────────────────────────
exemptions:
  # Запретить модераторам наказывать игроков с более высоким весом в LuckPerms
  use-luckperms-weight: true

# ── ProtectCord ───────────────────────────────────────────────
protectcord:
  # Установите true при использовании ProtectCord на вашем прокси BungeeCord / Velocity.
  # FluxBans будет использовать реальный переданный IP вместо IP прокси.
  enabled: false

# ── Мут ────────────────────────────────────────────────────────
mute:
  # Команды, заблокированные для замученного игрока.
  blocked-commands:
    - /say
    - /me
    - /msg
    - /tell
    - /w
    - /r
    - /reply
    - /pm
    - /dm
    - /whisper

# ── Предупреждения ────────────────────────────────────────────
warnings:
  # Автонаказание при достижении определённого количества предупреждений.
  auto-punish:
    - count: 3
      action: mute
      duration: "1h"
      reason: "Накоплено {count} предупреждений"
    - count: 5
      action: ban
      duration: "1d"
      reason: "Накоплено {count} предупреждений"
    - count: 10
      action: ban
      duration: "perm"
      reason: "Накоплено {count} предупреждений — перманентный бан"

# ── Формат отображения даты/времени ────────────────────────────
date-format: "dd MMM yyyy HH:mm:ss"
timezone: "UTC"

# ─────────────────────────────────────────────────────────────
#  FluxBans — Конфигурация сообщений
#  Цветовые коды: &0-9 &a-f &k-o &r
#  Hex-цвета (1.16+): &#RRGGBB
#  Плейсхолдеры зависят от контекста — полный список см. в вики.
# ─────────────────────────────────────────────────────────────

prefix: "&8[&cFluxBans&8] &r"

# ── Баны ───────────────────────────────────────────────────────
ban:
  default-reason: "Вы забанены."
  temp-default-reason: "Временно забанен."
  ip-default-reason: "IP забанен."

  kick-message: |
    &c&lВы забанены на этом сервере.
    &7Причина: &f{reason}
    &7Длительность: &f{duration}
    &7Истекает: &f{expires}
    &7Обжалование: &b{appeal-url}
    &7ID бана: &f#{id}

  broadcast: "&c{operator} &7забанил &c{player} &7» &f{reason} &7[{duration}]"
  broadcast-silent: "&c{operator} &7тихо забанил &c{player} &7» &f{reason} &7[{duration}]"
  notify: "{prefix}&7{operator} забанил &c{player} &7» {reason} [{duration}]"
  ip-broadcast: "&c{operator} &7забанил по IP &c{player} ({ip}) &7» &f{reason} &7[{duration}]"

  banned: "{prefix}&aУспешно забанил &c{player}&a."
  already-banned: "{prefix}&c{player} &7уже забанен."
  unbanned: "{prefix}&aУспешно разбанил &c{player}&a."
  not-banned: "{prefix}&c{player} &7не забанен."

# ── Муты ───────────────────────────────────────────────────────
mute:
  default-reason: "Замучен."
  temp-default-reason: "Временно замучен."

  broadcast: "&c{operator} &7замутил &c{player} &7» &f{reason} &7[{duration}]"
  broadcast-silent: "&c{operator} &7тихо замутил &c{player} &7» &f{reason} &7[{duration}]"
  notify: "{prefix}&7{operator} замутил &c{player} &7» {reason} [{duration}]"

  muted: "{prefix}&aУспешно замутил &c{player}&a."
  already-muted: "{prefix}&c{player} &7уже замучен."
  unmuted: "{prefix}&aУспешно размутил &c{player}&a."
  not-muted: "{prefix}&c{player} &7не замучен."

  chat-blocked: |
    {prefix}&cВы замучены.
    &7Причина: &f{reason}
    &7Истекает: &f{expires}

# ── Кики ───────────────────────────────────────────────────────
kick:
  default-reason: "Кикнут."

  kick-message: |
    &c&lВы были кикнуты с сервера.
    &7Причина: &f{reason}
    &7Кем: &f{operator}

  broadcast: "&c{operator} &7кикнул &c{player} &7» &f{reason}"
  broadcast-silent: "&c{operator} &7тихо кикнул &c{player} &7» &f{reason}"
  notify: "{prefix}&7{operator} кикнул &c{player} &7» {reason}"
  kicked: "{prefix}&aКикнул &c{player}&a."

# ── Предупреждения ────────────────────────────────────────────
warn:
  default-reason: "Предупреждён."

  broadcast: "&e{operator} &7предупредил &e{player} &7» &f{reason}"
  broadcast-silent: "&e{operator} &7тихо предупредил &e{player} &7» &f{reason}"
  notify: "{prefix}&7{operator} предупредил &e{player} &7» {reason}"
  warned: "{prefix}&aПредупредил &e{player}&a."
  unwarned: "{prefix}&aСнял предупреждение #{id} с &e{player}&a."
  not-warned: "{prefix}&cПредупреждение #{id} не найдено."

  received: |
    {prefix}&eВам вынес предупреждение &c{operator}&e.
    &7Причина: &f{reason}
    &7Всего активных предупреждений: &c{count}

# ── История ────────────────────────────────────────────────────
history:
  header: "{prefix}&7История наказаний &c{player} &7(страница {page}/{pages}):"
  entry: " &8» &7[&c{type}&7] &f{reason} &7от &f{operator} &7— &f{date}"
  no-history: "{prefix}&7История наказаний &c{player} &7не найдена."

# ── Проверка ───────────────────────────────────────────────────
check:
  header: "{prefix}&7Статус &c{player}&7:"
  banned: " &7Бан: &cДа &7(#{id}) — {reason} — истекает {expires}"
  not-banned: " &7Бан: &aНет"
  muted: " &7Мут: &eДа &7(#{id}) — {reason} — истекает {expires}"
  not-muted: " &7Мут: &aНет"
  warnings: " &7Предупреждения: &e{count} активных"
  ip: " &7IP: &f{ip}"

# ── Список банов / мутов ───────────────────────────────────────
banlist:
  header: "{prefix}&7Активные баны &7(страница {page}/{pages}, всего: {count}):"
  entry: " &8» &c{player} &7от &f{operator} &7— {reason} &7[{duration}]"
  empty: "{prefix}&7Активных банов нет."

mutelist:
  header: "{prefix}&7Активные муты &7(страница {page}/{pages}, всего: {count}):"
  entry: " &8» &e{player} &7от &f{operator} &7— {reason} &7[{duration}]"
  empty: "{prefix}&7Активных мутов нет."

# ── Альты ──────────────────────────────────────────────────────
alts:
  header: "{prefix}&7Альт-аккаунты с тем же IP, что и &c{player}&7:"
  entry: " &8» &c{name} &7(последний вход: {date})"
  none: "{prefix}&7Альт-аккаунты &c{player} &7не найдены."
  shared-ip: " &7Общий IP: &f{ip}"

# ── Общие ошибки ───────────────────────────────────────────────
error:
  no-permission: "{prefix}&cУ вас нет прав на это действие."
  player-not-found: "{prefix}&cИгрок &f{player} &cне найден."
  console-only: "{prefix}&cЭту команду можно выполнить только из консоли."
  player-only: "{prefix}&cЭту команду может выполнить только игрок."
  invalid-duration: "{prefix}&cНеверная длительность: &f{input}&c."
  player-exempt: "{prefix}&c{player} &7имеет иммунитет к этому наказанию."
  self-punish: "{prefix}&cВы не можете наказать себя."
  database-error: "{prefix}&cПроизошла ошибка базы данных. Проверьте консоль."
  usage: "{prefix}&cИспользование: &f{usage}"
  unknown-command: "{prefix}&cНеизвестная команда. Введите &f/fluxbans help &cдля списка."

# ── Администрирование FluxBans ─────────────────────────────────
admin:
  reloaded: "{prefix}&aКонфигурация успешно перезагружена."
  import-start: "{prefix}&7Начинаю импорт из &c{plugin}&7..."
  import-done: "{prefix}&aИмпорт завершён. &7Импортировано записей: &c{count}&7."
  import-failed: "{prefix}&cИмпорт не удался: &f{error}"

# ── URL веб-обжалования ────────────────────────────────────────
appeal-url: "http://example.com:8080/appeal"

</details>

<details>
<summary><b>reasons.yml</b></summary>

```yaml
# ─────────────────────────────────────────────────────────────
#  FluxBans — Предустановленные причины
#
#  Персонал может использовать их так: /ban <player> #hacking
#  Префикс # запускает поиск предустановленной причины.
#
#  Поля:
#    display  — текст причины, отправляемый игроку и записываемый в БД
#    duration — необязательная фиксированная длительность (персонал не может изменить)
#    type     — необязательно: ban | mute | kick | warn
# ─────────────────────────────────────────────────────────────

hacking:
  display: "Читерство / использование запрещённых модов"
  duration: "30d"
  type: ban

xray:
  display: "X-Ray / злоупотребление ресурспаком"
  duration: "14d"
  type: ban

chat-spam:
  display: "Спам в чате"
  duration: "1h"
  type: mute

advertising:
  display: "Реклама других серверов"
  duration: "7d"
  type: mute

hate-speech:
  display: "Разжигание ненависти / дискриминация"
  duration: "30d"
  type: mute

griefing:
  display: "Гриферство"
  duration: "7d"
  type: ban

bug-abuse:
  display: "Использование багов / эксплойтов"
  duration: "7d"
  type: ban

inappropriate:
  display: "Неприемлемое поведение"
  type: warn

ban-evasion:
  display: "Обход бана"
  duration: "perm"
  type: ban

# ─────────────────────────────────────────────────────────────
#  FluxBans — Конфигурация веб-сервера
# ─────────────────────────────────────────────────────────────

web:
  enabled: true

  # IP для привязки. Используйте 0.0.0.0 для всех интерфейсов.
  bind: "0.0.0.0"

  port: 8080

  # Базовый URL для генерации ссылок, показываемых игрокам в сообщениях о кике.
  base-url: "http://example.com:8080"

  # ── SSL / HTTPS ──────────────────────────────────────────────
  ssl:
    enabled: false
    keystore-path: "ssl/keystore.jks"
    keystore-password: "changeme"
    port: 8443

  # ── Панель администратора ─────────────────────────────────────
  admin:
    # Смените это на что-то надёжное перед запуском.
    token: "CHANGE_THIS_SECRET_TOKEN"
    session-timeout: 60
    # Ограничить доступ к панели администратора определёнными IP (пусто = разрешить всем)
    allowed-ips: []

  # ── Ограничение частоты запросов ──────────────────────────────
  rate-limit:
    appeals-per-hour: 3
    searches-per-minute: 30

  # ── Тема и брендинг ───────────────────────────────────────────
  theme:
    mode: dark           # "dark" или "light"
    server-name: "My Minecraft Server"
    accent-color: "e74c3c"
    server-description: ""
    server-ip: ""
    logo-url: ""
    discord-url: ""
    website-url: ""

  # ── Приватность ───────────────────────────────────────────────
  privacy:
    anonymise-ips: true
    public-appeal-form: true

  entries-per-page: 20

  # ── SEO ──────────────────────────────────────────────────────
  seo:
    description: "Просматривайте активные баны, муты и подавайте апелляции для нашего Minecraft-сервера."
    keywords: "minecraft ban list, mute list, ban appeal, punishment history"
    allow-indexing: true
    og-image: ""
    twitter-site: ""

  # Идентификатор измерения Google Analytics 4 (например, "G-XXXXXXXXXX"). Пусто = отключено.
  analytics-id: ""

# ─────────────────────────────────────────────────────────────
#  FluxBans — Конфигурация вебхуков
#
#  Поддерживаемые типы: discord | generic
#
#  Доступные события:
#    ban, unban, mute, unmute, kick, warn,
#    appeal_new, appeal_resolved
# ─────────────────────────────────────────────────────────────

webhooks:
  - url: "https://discord.com/api/webhooks/YOUR_ID/YOUR_TOKEN"
    type: discord
    enabled: false
    events:
      - ban
      - unban
      - mute
      - unmute
      - kick
      - warn
      - appeal_new
      - appeal_resolved
    # Если true, тихие наказания НЕ будут вызывать этот вебхук
    skip-silent: true
    colors:
      ban: 15158332        # красный
      unban: 3066993       # зелёный
      mute: 15105570       # оранжевый
      unmute: 3447003      # синий
      kick: 10181046       # фиолетовый
      warn: 16776960       # жёлтый
      appeal_new: 3447003  # синий
      appeal_resolved: 3066993

  - url: "https://your-site.com/api/fluxbans-webhook"
    type: generic
    enabled: false
    events:
      - appeal_new
      - appeal_resolved
    # Необязательно — подписывает каждый запрос заголовком X-FluxBans-Signature: sha256=<hex>
    secret: ""

## Команда /fluxbans

Основная админ-команда. Требует `fluxbans.admin`.

/fluxbans reload Перезагружает все конфиги без перезапуска /fluxbans import Импортирует данные из базы другого плагина /fluxbans debug Выводит версию, статус базы и активные подключения

---

## Требования

Java 8 или новее. SQLite идёт в комплекте, так что для одного сервера база данных не нужна. ProtectCord, LuckPerms и Vault опциональны и подхватываются автоматически, если установлены.

---

<div align="center">

### Живая статистика

[![bStats](https://bstats.org/signatures/bukkit/FluxBans.svg)](https://bstats.org/plugin/bukkit/FluxBans/31262)

*FluxBans собирает анонимную статистику через [bStats](https://bstats.org/plugin/bukkit/FluxBans/31262). Отключить можно в `plugins/bStats/config.yml`.*

</div>