FinderTools
Когда нужно отыскать редкие руды, посчитать мобов или проверить генерацию структур на сервере Minecraft, ручной облёт мира занимает часы. FinderTools решает эту задачу иначе — это высокопроизводительный асинхронный плагин, который сканирует мир в фоне, не нагружая основной поток сервера. Вы просто задаёте цель, а через несколько секунд получаете точный отчёт в YAML-формате.
Что умеет FinderTools
Плагин создан для серверов на Paper 1.20.1 и работает с Java 8 и выше. Он одинаково хорошо справляется с поиском блоков и сущностей, поддерживает гибкие фильтры по регионам и чанкам, а также следит за собственной производительностью, чтобы не мешать игровому процессу.
🔍 Асинхронное сканирование
FinderTools запускает поиск в отдельных потоках, не затрагивая главный поток сервера. Это значит, что даже при полном сканировании огромного мира игроки не заметят просадок TPS. Плагин сам регулирует нагрузку через настройки пула потоков и интервалы между проверками чанков.
🌍 Гибкий выбор области
Можно просканировать весь мир, только загруженные чанки или конкретный регион. Например, команда /findertools find block diamond_ore world{region='0,0'} проверит лишь центральный регион, а world{type='enabled'} ограничит поиск активными чанками. Это экономит время и ресурсы, когда не нужно обрабатывать всю карту.
📊 Умная работа с памятью
FinderTools автоматически отслеживает использование памяти и принудительно запускает сборку мусора, если порог превышен. Периодическая запись промежуточных результатов в отчёт также снижает нагрузку на RAM. Вы можете задать лимит памяти в мегабайтах и интервал записи, чтобы плагин подстраивался под возможности вашего сервера.
📈 Отчёты и прогресс в реальном времени
Каждые 10% выполнения задачи плагин выводит текущий прогресс в консоль и, опционально, игроку, запустившему сканирование. После завершения формируется YAML-файл с полной статистикой: количество найденных объектов, обработанных чанков, время сканирования и точные координаты каждой находки. Отчёт сохраняется в папку plugins/FinderTools/reports с уникальным именем, включающим дату и случайный идентификатор.
🔒 Безопасность и управление задачами
Все команды защищены системой прав. Администратор может разрешить или запретить использование поиска, перезагрузку конфигурации и управление задачами отдельным группам игроков. Текущий скан можно поставить на паузу, возобновить или полностью остановить — это удобно, если внезапно потребовалось освободить ресурсы сервера.
Как установить FinderTools
Установка плагина проста и не требует специальных знаний. Скачайте FinderTools с официального репозитория или воспользуйтесь лаунчером foxygame.net, где дополнение доступно в каталоге и устанавливается в один клик — такой подход экономит время и исключает ошибки ручного копирования файлов. Если вы предпочитаете классический способ, просто поместите JAR-файл в папку plugins сервера и перезапустите его или выполните команду /reload. Плагин автоматически создаст конфигурационный файл и директорию для отчётов.
Основные команды
Управление плагином интуитивно понятно. Вот ключевые команды, которые стоит запомнить:
/findertools find <block|entity> <id> <world> [options]— запуск сканирования./findertools stop— остановка текущей задачи./findertools pause— приостановка сканирования./findertools startили/findertools resume— возобновление./findertools status— проверка состояния активной задачи./findertools reload— перезагрузка конфигурации./findertools help— справка по всем командам.
Примеры использования
FinderTools для Minecraft даёт администраторам мощный инструмент анализа мира. Например, чтобы найти все алмазные руды в обычном мире, достаточно ввести /findertools find block diamond_ore world. Для поиска жителей деревень в загруженных чанках: /findertools find entity villager world{type='enabled'}. Если нужно проверить конкретный регион на наличие коров, подойдёт /findertools find entity cow world{region='-1,2'}. Плагин мгновенно начинает асинхронный обход и через несколько секунд выдаёт результат.
Тонкая настройка под сервер
FinderTools позволяет гибко менять поведение через конфигурационный файл plugins/FinderTools/config.yml. Вы можете задать количество потоков, интервал между сканированием чанков, порог использования памяти и даже включить отладочный вывод. Например, если сервер испытывает лаги, уменьшите max-threads и увеличьте chunk-interval. Для ускорения поиска на мощных машинах — наоборот, поднимите число потоков. Плагин также поддерживает настройку интервала записи отчётов, что помогает балансировать между скоростью и потреблением памяти.
Производительность и оптимизация
FinderTools спроектирован так, чтобы не мешать работе сервера. Асинхронная загрузка и выгрузка чанков, умное определение состояния чанков и настраиваемые интервалы сканирования позволяют добиться минимального влияния на TPS. Встроенный мониторинг памяти автоматически запускает сборку мусора при превышении порога, а периодическая запись отчётов освобождает оперативную память. Если вы замечаете просадки, достаточно скорректировать параметры потоков и интервалов — плагин легко адаптируется под любую конфигурацию сервера.
Права и безопасность
FinderTools использует детальную систему разрешений. По умолчанию только операторы могут запускать сканирование, перезагружать конфигурацию и управлять задачами. Это предотвращает злоупотребления со стороны обычных игроков. При необходимости вы можете выдать отдельные права через любой плагин на управление правами, например, разрешить определённой группе только просмотр статуса сканирования.
Отчёты и аналитика
После завершения сканирования плагин генерирует структурированный YAML-отчёт. В нём содержится информация о времени генерации, версии плагина, параметрах запроса, общей статистике и списке всех найденных объектов с координатами, миром и типом. Такой формат удобен для автоматической обработки или ручного анализа. Вы можете использовать эти данные для планирования добычи ресурсов, мониторинга популяции мобов или проверки целостности мира.
Решение типичных проблем
Если сканирование кажется медленным, увеличьте max-threads и уменьшите chunk-interval. При лагах сервера — сделайте наоборот: уменьшите потоки и увеличьте интервалы. Высокое потребление памяти лечится снижением write-interval, чтобы плагин чаще сбрасывал данные в отчёт. Если не можете найти файлы отчётов, проверьте путь в report.output-directory и права на запись. Все эти параметры интуитивно понятны и подробно описаны в конфигурации.
FinderTools — это незаменимый помощник для администраторов Minecraft-серверов, который превращает многочасовой ручной поиск в быструю фоновую операцию. Скачать FinderTools можно уже сегодня, а благодаря лаунчеру foxygame.net установка дополнения становится ещё проще: каталог прямо в лаунчере предлагает FinderTools с автообновлением и полной совместимостью с Paper 1.20.1, избавляя от необходимости следить за версиями вручную. Попробуйте плагин в деле, и вы удивитесь, насколько прозрачнее становится управление миром.