Plan | Player Analytics

Что такое Plan | Player Analytics

Plan | Player Analytics - серверный плагин для Minecraft Java Edition, который собирает статистику игроков и сервера, а затем показывает её во встроенной веб-панели. Это не мод для клиентов и не игровой контент: игрокам не нужно устанавливать дополнительные файлы, если администратор настроил Plan только на сервере.

Проект пригодится владельцам выживания, мини-игровых сетей и больших серверов, где одного списка текущего онлайна уже мало. Plan помогает понять, когда игроки заходят, сколько проводят времени в игре, как меняется аудитория и не проседает ли производительность сервера. По сути, это бесплатная self-hosted аналитика для Minecraft без передачи статистики на сторонние сервисы.

Plan уже используется более чем на 5000 серверов. В классификации это инструмент управления и администрирования, а не плагин для PvP или строительства. Он особенно полезен там, где нужно принимать решения по реальным данным, а не угадывать по ощущениям администрации.

Какие данные показывает Plan

Веб-интерфейс собирает информацию из разных частей серверной работы. Набор доступных показателей зависит от платформы, версии и установленных интеграций, но в целом администратор получает следующие разделы:

• Онлайн и активность - кто сейчас находится на сервере, когда игроки обычно заходят и в какие периоды онлайн растёт или падает.
• Сессии - время входа и выхода, продолжительность игровых сессий и общая игровая активность.
• Профили игроков - статистика отдельных пользователей, история их присутствия и доступные игровые показатели.
• Состав аудитории - новые и вернувшиеся игроки, динамика базы пользователей и изменения за выбранный период.
• Производительность - нагрузка на сервер, показатели MSPT и другие метрики, помогающие заметить проблемы с тиками.
• Сетевые данные - информация, полезная при анализе подключений и работы серверной сети.
• История изменений - выбор временного диапазона позволяет сравнить разные дни, недели или месяцы, а не смотреть только на текущий момент.

В ветке 5.8 появились MSPT Jitter, обновлённые метрики производительности, переработанные вкладки сессий и выбор диапазона дат. Это удобно, когда нужно отделить разовый лаг от постоянной проблемы. Например, кратковременный скачок нагрузки выглядит совсем иначе, чем регулярное ухудшение TPS каждый вечер.

Зачем аналитика нужна серверу Minecraft

Без статистики администрация часто видит только внешнюю картину: игроки жалуются на лаги, онлайн вроде бы падает, а новые пользователи быстро уходят. Plan раскладывает такие ситуации по цифрам.

С его помощью можно проверить, действительно ли сервер проседает в часы пик, какие игровые периоды удерживают аудиторию и сколько игроков возвращается после первого входа. Это полезно и для небольшого сервера друзей, и для крупной сети с несколькими прокси. В последнем случае важны не только данные по отдельному серверу, но и общая картина по всей инфраструктуре.

В Minecraft такая аналитика помогает находить узкие места без догадок. Если после установки нового плагина вырос MSPT, это будет заметно по истории производительности. Если игроки заходят, но почти сразу выходят, стоит искать причину в игровом режиме, настройках или проблемах подключения, а не просто добавлять новые функции.

Поддерживаемые платформы

Plan работает как серверный плагин или модуль на нескольких популярных платформах. Поддерживаются:

• Paper
• Spigot
• Purpur и другие производные Bukkit-платформы
• Sponge и SpongeForge
• Fabric
• BungeeCord и Waterfall
• Velocity
• Folia
• Cauldron
• NukkitX

Список совместимости зависит от конкретной сборки. Для прокси Plan устанавливается отдельно от серверов Minecraft, если требуется собрать статистику сети и нескольких backend-серверов. На обычном Paper или Spigot достаточно установить подходящую версию серверного плагина и проверить права доступа к веб-панели.

Актуальная ветка 5.8 рассчитана на Minecraft 1.12.2 и более новые версии, включая современные ветки 1.21.x и версии, указанные в каталоге проекта. Поддержка конкретной версии определяется выбранной сборкой Plan и платформой, поэтому перед установкой на старый сервер нужно сверить требования самого файла.

Требования к Java и старым версиям

Для актуальной версии Plan требуется Java 11 или новее. Это важно учитывать на старых сборках Minecraft, где сервер всё ещё запускается на Java 8.

Для версий Minecraft 1.7.x - 1.12.2, если обновить Java нельзя, используется Plan 5.4 build 1722. Не стоит бездумно ставить новую сборку на старую связку: плагин может не запуститься, а ошибки в консоли будут связаны не с конфигурацией Plan, а с неподходящей версией Java.

Следующая ветка 5.9 потребует Java 17. Поэтому владельцам старых серверов лучше заранее проверить версию Java, загрузчик и остальные плагины, особенно если сервер работает на устаревшем ядре.

Интеграции с другими плагинами

Plan умеет получать дополнительные сведения из популярных серверных инструментов. Среди поддерживаемых интеграций есть:

• LuckPerms
• DiscordSRV
• EssentialsX
• PlaceholderAPI
• Vault
• ViaVersion
• Floodgate и Geyser
• Tebex
• mcMMO
• Jobs Reborn
• LiteBans

Благодаря интеграциям статистика не ограничивается простым временем входа. Например, можно сопоставлять активность с группами LuckPerms, игровыми данными mcMMO или работой нескольких версий клиентов через ViaVersion. Для серверов с Bedrock-подключениями полезна связка с Floodgate и Geyser, а для экономики и привилегий доступны соответствующие расширения.

У Plan есть API. Через него сторонние плагины могут добавлять собственные показатели в базу аналитики, а другие инструменты, наоборот, могут читать данные Plan. Это пригодится разработчикам серверных систем, которым нужна единая панель статистики, а не отдельные команды и логи для каждого плагина.

Веб-панель и безопасность

Встроенный веб-сервер показывает собранные данные через браузер. После установки нужно внимательно настроить доступ к панели, права пользователей и сетевую защиту. Для публичного доступа рекомендуется использовать HTTPS и авторизацию, иначе статистика игроков и административные данные могут оказаться открытыми для посторонних.

Не выставляйте веб-панель напрямую в интернет без проверки настроек доступа. Лучше ограничить доступ через обратный прокси, firewall или VPN, а также использовать отдельную учётную запись с минимально необходимыми правами. Администратору важно помнить: аналитика содержит историю активности игроков, поэтому её защита относится не только к удобству, но и к безопасности сервера.

Важное предупреждение о заражённой сборке

Если Plan был скачан с этой страницы в период с 15 февраля по 11 марта 2025 года, файл мог быть размещён злоумышленником, выдававшим себя за автора проекта. Такие версии распространяли вредоносную программу Opium Backdoor.

Если в этот период вы устанавливали Plan на сервер, считайте сервер полностью скомпрометированным. Недостаточно просто удалить плагин или заменить файл. Нужно остановить сервер, сохранить только необходимые данные мира, проверить права и учётные записи, удалить подозрительные файлы, сменить пароли и токены, а затем развернуть сервер из чистой среды. Также стоит проверить плагины, скрипты запуска и доступы к панели управления.

Заражённая страница и проект злоумышленника были удалены, после чего оригинальный автор восстановил проект при участии команды площадки. Само предупреждение всё равно остаётся важным для тех, кто устанавливал старые файлы в указанный период.

Лицензия и назначение проекта

Plan распространяется по лицензии LGPL-3.0-or-later. Исходный код, API и система расширений делают проект удобным не только для обычного владельца сервера, но и для разработчиков собственной инфраструктуры.

Это не инструмент для изменения игрового мира и не добавка с новыми предметами. С точки зрения игрока Minecraft почти не меняется: Plan работает в фоне и собирает данные. Изменения заметны прежде всего администрации, которая получает историю онлайна, статистику сессий, показатели производительности и сведения об интегрированных плагинах в одном месте.

Кому подойдёт Plan

Plan стоит рассматривать, если сервер уже перерос обычные логи и нужно понимать, что происходит с аудиторией. Он хорошо подходит для:

• серверов выживания с постоянными игроками;
• сетей на BungeeCord или Velocity;
• проектов с несколькими игровыми режимами;
• серверов, где нужно отслеживать производительность;
• администраций, использующих LuckPerms, Geyser, mcMMO, Jobs Reborn и другие интеграции;
• разработчиков, которым нужна API-аналитика для собственных плагинов.

Для маленького приватного мира Plan может оказаться избыточным. Но если сервером пользуются десятки или сотни игроков, история активности быстро становится полезнее разрозненных логов. Особенно когда нужно понять не только кто находится онлайн сейчас, но и почему аудитория меняется со временем.