⭐️ ПРИВЕТСТВУЕМ НА HOSTING-MINECRAFT.PRO ⭐️
Сегодня в этой статье мы разберёмся, как правильно читать логи на серверах Paper & Spigot, а также на Forge & Fabric, и что вообще в них можно найти.
Первые симптомы обычно одинаковые: "что-то лагает", "выкинуло", "модпак упал с кодом -1". Логи - позволяют узнать что происходит, это как карта местности - кто пришёл, что загрузилось, где упало и почему.
Где лежат логи и какие смотреть в первую очередь?
- В файлах сервера папка logs находится в главной директории сервера. Главный файл - latest.log (свежий запуск), старые - с датами, часто сжаты .gz. Начинаем с latest.log.
- Краш-отчёты клиента/сервера находятся отдельно в папке crash-reports.
Как правильно читать строчку лога?
Типичная строка:
[20:15:32] [Server thread/WARN]: <сообщение>
- Server thread - поток (главный тикер). Если тут краснеет, внимательно читаем.
- INFO/WARN/ERROR - уровень важности.
- Сообщение - суть проблемы или подсказка (часто с именами плагинов/модов, путями, классами Java).
Paper & Spigot: разбор популярных проблемных сообщений.
1) Сервер сильно тормозит:
Can't keep up! Is the server overloaded?
Это индикатор просадки TPS.
Что в данной ситуации делать?
Установите плагин/мод Spark и выполните следующие шаги:
1. Введите в консоль команду spark profiler --only-ticks-over 50 .
2. Подождите минимум час. Чтобы провести правильную диагностику, проблема должна возникнуть в течение часа до написания команды ниже.
3. Введите spark profiler stop , вам выдаст ссылку.
4. Перейдите по выданной ссылке. Вверху страницы находятся вкладка "Mods" или "Plugins" (в зависимости от того, используется ли сервер с модами или с плагинами).
- Эти вкладки показывают нагрузку на сервер, которую создаёт каждый мод/плагин в процентах.
5. Если какой-либо мод или плагин использует слишком много ресурсов (например, более 30–40% нагрузки), рекомендуется:
- проверить его конфигурацию и оптимизировать.
- заменить на более лёгкий аналог.
- при отсутствии необходимости удалить.
6. Также на графике можно проанализировать общую производительность сервера:
- TPS (Ticks Per Second) - показатель стабильности работы сервера (идеально = 20 TPS).
- MSPT (Milliseconds per Tick) - время обработки одного тика (норма до ~50 мс, больше - значит сервер перегружен).
- Entities - количество сущностей (мобы, предметы на земле и т.д.), при большом числе (>2000–3000) они часто вызывают лаги.
- Players - количество игроков онлайн и их влияние на нагрузку.
2) Сервер не смог запустить плагин:
[Server thread/ERROR]: Could not load 'plugins/MyPlugin.jar'
Что делать:
- Скачивайте плагины только с проверенных источников (SpigotMC, Modrinth, Bukkit).
- Убедитесь, что версия плагина совпадает с вашей
- Установите дополнительные плагины (библиотеки), которые требуются.
3) Мир не загружается.
[Server thread/ERROR]: Could not load world
Что делать:
- Попробуйте открыть карту сначала в одиночной игре.
- Если важно сохранить - скачайте бэкап и протестируйте на той версии, где она создавалась.
- Если ничего не помогает - то мир поврежден либо же неправильно загружен.
4) Конфликты UUID или сущностей.
[Server thread/WARN]: Found duplicate UUID when loading chunk
Что делать:
- Попробуйте очистить лишних мобов (/kill @e[type=!player]).
- Если ошибка остаётся - восстановите мир из бэкапа.
Forge & Fabric: разбор частых и распространённых проблем.
1) Выявление главного виновника:
Caused by: java.lang.NullPointerException: Cannot invoke "BlockState.getBlock()" because "state" is null
at com.examplemod.SomeClass.onTick(SomeClass.java:42)
- Всегда идём снизу вверх по логу, доходим до самого первого Caused by:.
- Там будет указано, какой именно мод или библиотека стали причиной.
Здесь виноват examplemod. Решение: обновить/убрать мод.
2) Несовместимость библиотек или версий API.
NoSuchMethodError:
[18:45:12] [Server thread/ERROR]: Encountered an unexpected exception
java.lang.NoSuchMethodError: 'void net.minecraft.world.level.block.Block.func_235480_a_(Ljava/lang/String;)V'
at com.examplemod.ExampleFeature.onInitialize(ExampleFeature.java:25)
at net.fabricmc.loader.impl.entrypoint.EntrypointUtils.invoke0(EntrypointUtils.java:47)
at net.fabricmc.loader.impl.entrypoint.EntrypointUtils.invoke(EntrypointUtils.java:36)
Здесь видно, что examplemod пытается вызвать метод func_235480_a_, которого в этой версии Minecraft уже нет. Значит, мод не подходит под версию ядра.
NoClassDefFoundError:
[20:13:05] [Server thread/ERROR]: Could not load 'mods/ExampleMod.jar' in folder 'mods'
java.lang.NoClassDefFoundError: net/minecraftforge/event/entity/PlayerEvent$Clone
at com.examplemod.ExampleEvents.register(ExampleEvents.java:15)
at com.examplemod.Main.init(Main.java:42)
Caused by: java.lang.ClassNotFoundException: net.minecraftforge.event.entity.PlayerEvent$Clone
at net.minecraft.launchwrapper.LaunchClassLoader.findClass(LaunchClassLoader.java:191)
Это означает - мод ищет класс (файл с кодом), которого вообще нет в сборке.
Причины: либо версия Forge не та, либо мод сделан под Forge, а сервер запущен на Fabric.
3) Неверные значения.
IllegalStateException:
[21:47:32] [Server thread/ERROR]: Encountered an unexpected exception
java.lang.IllegalStateException: Cannot register new dimension after initialization!
at net.minecraft.server.MinecraftServer.createWorlds(MinecraftServer.java:1234)
at com.examplemod.ExampleDimension.load(ExampleDimension.java:56)
at com.examplemod.Main.onServerStart(Main.java:22)
Здесь мод ExampleDimension пытается зарегистрировать измерение уже после того, как сервер завершил свой запуск. То есть действие выполняется в неправильный момент.
IllegalArgumentException:
[19:15:08] [Server thread/ERROR]: Encountered an unexpected exception
java.lang.IllegalArgumentException: Invalid spawn weight - must be >= 0
at net.minecraft.world.biome.MobSpawnInfo$Builder.addSpawn(MobSpawnInfo.java:103)
at com.examplemod.ExampleMobConfig.load(ExampleMobConfig.java:48)
Здесь в конфиге мода для моба указан spawn weight = -5. Это недопустимое значение, поэтому сервер крашается.
4) Серверу/Клиенту не хватило памяти.
[22:41:19] [Server thread/ERROR]: Encountered an unexpected exception
java.lang.OutOfMemoryError: Java heap space
at net.minecraft.world.chunk.Chunk.<init>(Chunk.java:167)
at net.minecraft.world.server.ChunkManager.func_219200_b(ChunkManager.java:134)
at com.examplemod.ExampleWorldGen.generate(ExampleWorldGen.java:92)
at net.minecraft.server.MinecraftServer.tick(MinecraftServer.java:875)
Какая ситуация здесь произошла:
- Сервер пытался загрузить чанки.
- Мод ExampleWorldGen генерировал слишком сложный мир.
Другой вариант - утечка памяти.
[14:12:07] [Server thread/WARN]: Can't keep up! Is the server overloaded?
java.lang.OutOfMemoryError: GC overhead limit exceeded
at java.util.HashMap.newNode(HashMap.java:1797)
at java.util.HashMap.putVal(HashMap.java:642)
at com.examplemod.ExampleCache.add(ExampleCache.java:55)
Здесь видно, что ExampleCache (часть мода) постоянно добавлял новые объекты в память и не очищал их. В итоге Java проводит 98% времени в GC (сборке мусора) и всё равно не хватает RAM.
Как отличать данные ошибки?
- Java heap space - памяти реально мало
В случае CUSTOM тарифа - нужно приобрести больше ресурсов для сервера.
В случае Обычных тарифов - увеличить тариф или приобрести новый тариф.
- GC overhead limit exceeded - утечка памяти (мод держит всё в оперативной памяти и не отдаёт).
Что делать?
1. Увеличить или приобрести тариф с большим количеством ресурсов (Оперативной Памяти).
2. Проверить, нет ли модов, вызывающих утечку (через Spark).
3. Оптимизировать сервер (менее тяжёлые моды генерации, лимит мобов).
Как читать логи и не пугаться?
1. Ищите слова "ERROR", "WARN", "Exception", "Caused by:".
2. Чаще всего проблема описана в двух-трёх строчках.
3. По имени мода/плагина быстро определяем виновника.
Советы для администраторов.
- Сохраняйте резервные копии или определенных файлов через вкладку "Бэкапы" и "Планировщик Задач".
- Если лог огромный - используйте сервис "mclo" для удобного чтения логов.
- Экономьте время: если сервер крашится при запуске, сразу проверяйте список последних добавленных модов.
- Не бойтесь обращаться в нашу Тех.Поддержку, через вкладку "Поддержка", если сложно разобрать какой-то лог, то обращайтесь именно к нам!
Чаще всего:
- если тормозит игра - дело в большом количестве сущностей или определенных плагинах/модах.
- если не грузится мир - проверяйте версию карты или загрузите еще раз на сервер проблемный мир.
- если не запускается плагин/мод - установите зависимости (библиотеки) или загрузите плагин/мод из официального источника.
Главное - не удалять ничего в панике, а внимательно посмотреть лог. Красные буквы - это подсказка к решению проблемы.
Если хотите увидеть полный разбор логов, то посмотрите наши подробные видео-уроки. Снизу Paper & Spigot и вверху Forge & Fabric!
❗️❗️ КАК ЗАКАЗАТЬ СЕРВЕР МАЙНКРАФТ СМОТРИТЕ - ЗДЕСЬ ❗️❗️
ПРОМО-КОД НА СКИДКУ 15%: ready-steady-go
