FinderTools (Файндер тулс)

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

Возможности

• Поиск блоков и мобов по их идентификатору.
• Сканирование всего мира, выбранного региона или только загруженных чанков.
• Приостановка, продолжение и остановка задания.
• Вывод хода работы в консоль и игроку с заданным шагом в процентах.
• Отчёты в формате YAML со статистикой, координатами найденных объектов и обработанными чанками.
• Контроль памяти, числа потоков и нагрузки на потоки.

Команды

Основной формат: /findertools find <block|entity> <id> <world> [options].

• /findertools find block diamond_ore world — ищет алмазную руду в мире.
• /findertools find entity villager world — ищет жителей в мире.
• /findertools find block stone world{type='enabled'} — ищет камень только в загруженных чанках.
• /findertools find block gold_ore world{region='0,0'} — сканирует указанный регион.
• /findertools stop, /findertools pause, /findertools start или /findertools resume — управление текущим сканированием.
• /findertools status — состояние задания.
• /findertools reload — перезагрузка конфига.
• /findertools help — справка.

Права

• findertools.command — базовое использование команд.
• findertools.command.find — запуск поиска.
• findertools.command.reload — перезагрузка настроек.
• findertools.command.state — управление заданиями.

По умолчанию права доступны операторам.

Настройка

Конфиг расположен по пути plugins/FinderTools/config.yml.

• scan.chunk-interval — интервал сканирования чанков в тиках.
• scan.write-interval — период записи отчёта по числу чанков.
• threading.max-threads — максимальное число потоков.
• threading.max-thread-usage — предельная нагрузка на поток.
• memory.max-memory-mb и memory.gc-threshold — пороги контроля памяти.
• report.output-directory — папка отчётов; report.detailed включает подробные сведения.
• progress.output-interval, progress.console-output и progress.player-output управляют выводом прогресса.

При медленном поиске можно увеличить threading.max-threads или уменьшить scan.chunk-interval. Если сервер лагает, сократите число потоков, увеличьте интервалы либо уменьшите threading.max-thread-usage.

Требования

Нужен сервер Paper и Java 8 или выше.