Один из самых частых виновников лагов, которых находит spark, - плагин, который делает тяжёлую работу в главном потоке сервера. Запрос к базе данных, загрузка файла, обращение к сайту - всё это может занимать десятки и сотни миллисекунд. Пока это происходит, весь сервер стоит и ждёт. Разберёмся, почему так происходит и как писать плагины, которые не тормозят игру.
Как устроен главный поток
Сервер Minecraft работает тиками: двадцать раз в секунду он обрабатывает всё, что происходит в мире. На один тик у него есть 50 миллисекунд. Большая часть этой работы выполняется в одном главном потоке: движение мобов, действия игроков, работа плагинов.
Если какой-то плагин внутри тика ждёт ответа от базы данных 200 миллисекунд, тик длится в четыре раза дольше положенного. Для игроков это выглядит как резкий лаг: блоки появляются с задержкой, мобы дёргаются. А если такое происходит при каждом действии игрока, сервер начинает лагать постоянно.
Что считается тяжёлой операцией
Всё, что ждёт чего-то снаружи сервера. Запросы к базе данных, особенно к удалённой. Чтение и запись больших файлов. Запросы к сайтам и API: проверка лицензии, получение скина, отправка статистики. Сложные вычисления над большими объёмами данных.
Опасность в том, что на тестовом сервере всё работает быстро: база на том же компьютере, игрок один. На живом сервере база может отвечать медленнее, игроков сотни, и одна и та же операция внезапно начинает вызывать заметные лаги.
Асинхронность простыми словами
Асинхронность - это выполнение тяжёлой работы в отдельном потоке, параллельно с главным. Главный поток говорит: «сходи в базу и принеси данные игрока, а я пока продолжу работать», и не ждёт. Когда данные готовы, их передают обратно, и главный поток использует их в следующем тике.
В Paper для этого есть планировщик задач и удобные инструменты Java вроде CompletableFuture. Идея всегда одна: тяжёлая часть выполняется асинхронно, а результат обрабатывается в главном потоке.
Что нельзя делать асинхронно
Здесь самая частая ошибка начинающих. Почти всё, что меняет мир, нельзя делать из другого потока: ставить и ломать блоки, телепортировать игроков, менять инвентари, спавнить мобов. Мир Minecraft не рассчитан на одновременные изменения из нескольких потоков, и такие действия приводят к странным ошибкам, повреждению данных или падению сервера.
Поэтому схема всегда такая: асинхронно получаем или сохраняем данные, а все действия с игроками и миром выполняем, вернувшись в главный поток. Paper в последних версиях сам предупреждает в консоли, если плагин пытается изменить мир не из того потока.
Работа с базой данных правильно
При входе игрока данные лучше загружать асинхронно и хранить в памяти, пока игрок на сервере. Тогда во время игры не нужно обращаться к базе при каждом действии: всё уже под рукой. Сохранять изменения тоже стоит асинхронно - периодически и при выходе игрока.
Обязательно используйте пул соединений, например HikariCP. Открывать новое соединение с базой на каждый запрос - медленно, а пул держит несколько готовых соединений и раздаёт их по запросу.
Отдельно продумайте выключение сервера: при остановке плагин должен дождаться, пока все сохранения закончатся, иначе часть данных игроков потеряется.
Гонки и одновременные изменения
Асинхронность приносит новую проблему: два потока могут одновременно менять одни и те же данные. Например, игрок покупает что-то в магазине, а в это же время асинхронно сохраняется его баланс. Если не продумать порядок, можно потерять покупку или получить дюп.
Самое простое решение - не менять общие данные из нескольких потоков одновременно. Данные игрока меняются только в главном потоке, а асинхронно только читаются и записываются в базу копии. Для действительно общих структур используйте потокобезопасные коллекции Java.
Пример
На сервере вечером постоянно падал TPS. Spark показал, что больше трети времени тика уходит на плагин статистики: при каждом сломанном блоке он отправлял запрос в базу данных и ждал ответа. Разработчик переделал плагин: статистика копилась в памяти и раз в минуту асинхронно сохранялась пачкой. Нагрузка от плагина в профиле упала почти до нуля, а лаги вечером исчезли.
Как проверить свой плагин
Самый простой способ - снять профиль spark под нагрузкой, похожей на реальную, и поискать в главном потоке методы своего плагина. Если среди них есть обращения к базе, файлам или сети, это кандидаты на перенос в отдельный поток. Полезно и искусственно замедлить базу на тестовом сервере: если после этого лагает игра, а не только загрузка данных, значит, где-то запрос всё ещё выполняется в главном потоке.
Ещё один признак проблемы - лаги в моменты входа и выхода игроков. Если сервер подтормаживает, когда кто-то заходит, скорее всего, данные игрока загружаются синхронно. Перенос загрузки в отдельный поток обычно убирает такие рывки полностью.
Хорошая привычка при ревью кода - для каждого обращения к базе или сети задавать вопрос: в каком потоке это выполняется? Если ответ «не знаю», это первое место, которое стоит проверить.
Наш взгляд
Асинхронность - не сложная магия, а простое правило: всё, что ждёт, выполняется в отдельном потоке, всё, что меняет мир, - в главном. Плагины, которые соблюдают это правило, не появляются в отчётах spark и не превращают вечерний онлайн в слайд-шоу. Проверяйте это ещё на тестовом сервере с искусственно медленной базой - так проблемы видны задолго до того, как о них напишут игроки.
Находили у себя плагины, которые делают запросы в главном потоке?



