AltDetector

Если ты админишь сервер Майнкрафт, то наверняка сталкивался с ситуацией, когда забаненный игрок возвращается через альт-аккаунт. AltDetector как раз решает эту проблему - он отслеживает IP-адреса и сообщает, когда с одного и того же IP заходит несколько разных игроков. Никакой лишней мороки: просто кидаешь плагин в папку plugins, перезапускаешь сервер - и он уже работает. По умолчанию история IP хранится 60 дней.

Важный момент: плагин не банит и не наказывает игроков. Если два брата живут в одном доме и играют с одного IP - они будут отмечены как потенциальные альты, но это просто информация для админа. Некоторые провайдеры (например, Starlink) используют CGNAT, когда один IP выдается сотням пользователей - тут тоже возможны ложные срабатывания. AltDetector нужен именно для отслеживания, а не для наказания.

Если у тебя стоят SuperVanish или PremiumVanish, AltDetector подхватит их иерархию скрытых игроков - оповещения будут видны только тем, кому они доступны по правам.

Команды

• /alt [игрок] - показывает список потенциальных альтов для указанного игрока. Если игрок не указан - выводит альтов для всех онлайн-игроков.
• /alt delete <игрок> - удаляет все записи об игроке из базы.

Про оффлайн-игроков: если ввести /alt для игрока, которого нет на сервере, плагин найдет его последние IP и сделает проверку по ним. Если игрок заходил с разных IP, результаты могут быть несимметричными (например, A показан как альт B, а B как альт A - нет). Это не баг, а особенность работы с несколькими IP.

Права (Permissions)

• altdetector.alt - доступ к команде /alt (по умолчанию у операторов).
• altdetector.alt.seevanished - видеть сообщения о скрытых игроках (по умолчанию у операторов).
• altdetector.alt.delete - доступ к /alt delete (по умолчанию у операторов).
• altdetector.exempt - исключает игрока из обработки плагином (по умолчанию false).
• altdetector.notify - получать уведомления об обнаружении альтов (по умолчанию у операторов).
• altdetector.notify.seevanished - получать уведомления об альтах для скрытых игроков (по умолчанию у операторов).

Настройка (необязательно)

Плагин работает из коробки, но если хочешь покопаться - в config.yml есть параметры:

• expiration-time - срок хранения данных в днях (по умолчанию 60). IP старше этого удаляются при старте сервера. Можно уменьшить, если IP игроков часто меняются.
• database-type, mysql, convert-from, sql-debug - по умолчанию используется SQLite. Если хочешь MySQL - настройки ниже.
• join-player-prefix, join-player, join-player-list, join-player-separator - строки для сообщения при входе игрока.
• altcmd-player, altcmd-player-list, altcmd-player-separator - строки для вывода команды /alt.
• altcmd-playernoalts, altcmd-noalts, altcmd-playernotfound, altcmd-paramerror, altcmd-noperm - ответы команды /alt.
• delcmd-removedsingular, delcmd-removedplural - ответы /alt delete.
• placeholder-enabled, placeholder-separator - для PlaceholderAPI.
• discord - настройки вебхука в Discord. Укажи mc-server-name - имя, которое будет отображаться в сообщениях.

MySQL

Если хочешь использовать MySQL вместо SQLite:

1. Запусти плагин, чтобы создался config.yml.
2. Измени database-type на mysql, заполни данные для подключения.
3. jdbcurl-properties - сюда можно добавить параметры соединения.
4. Перезапусти сервер.

Переключение между базами без потери данных:

• В config.yml укажи database-type - база, в которую конвертируешь.
• convert-from - база, из которой конвертируешь.
• Заполни данные для MySQL (если нужно).
• При перезапуске данные конвертируются автоматически. Это может занять время, особенно при конвертации в MySQL.
• Важно: перед конвертацией удали старые данные в целевой базе. Для SQLite - удали altdetector.db, для MySQL - удали таблицы altdetector_iptable и altdetector_playertable.

Поддержка Geyser/Floodgate

Если на твоем сервере Bedrock-игроки заходят через Geyser, обязательно поставь Floodgate - иначе AltDetector не сможет правильно идентифицировать их альт-аккаунты.

PlaceholderAPI

AltDetector поддерживает плейсхолдеры: %altdetector_alts_<ник>% (регистр важен). Разделитель между альтами настраивается в конфиге.

Плагин использует bStats для анонимной статистики использования. Отключить можно в plugins/bStats/config.yml.