Введение: бесконечный цикл в проводах

Ошибка «java.lang.StackOverflowError» в контексте редстоуна — это результат зацикленной схемы. Редстоун-факел включает линию, линия выключает факел, факел включает линию... и так до бесконечности. Java отслеживает глубину вызовов и при превышении лимита (обычно 1000 вызовов) выбрасывает StackOverflowError и крашит сервер. В этом гайде — как найти зацикленную схему и предотвратить краш.

Как работает зацикливание редстоуна

Классический пример — «мигалка» из двух факелов, соединённых проводами. Каждый факел инвертирует сигнал другого, создавая бесконечный цикл переключений. Если частота переключений слишком высокая — сервер не успевает обрабатывать тики и падает.

Другой пример: компаратор, считывающий сигнал с сундука, который открывается/закрывается поршнем, активируемым тем же компаратором. Получается петля обратной связи.

Симптомы

• Сервер крашится при загрузке определённого чанка.
• В логах: «java.lang.StackOverflowError at net.minecraft.world.level.redstone.RedstoneWire.getSignal».
• Указаны координаты проблемного блока (редстоун-пыли, факела, компаратора).

Решение

1. Запишите координаты из лога.
2. Запустите сервер.
3. Быстро телепортируйтесь к координатам: /tp X Y Z.
4. Сломайте редстоун-компонент (факел, пыль, компаратор), чтобы разорвать цикл.
5. Если сервер крашится быстрее, чем вы успеваете — остановите сервер, удалите проблемный region-файл (world/region/r.X.Z.mca), запустите сервер снова. Чанк перегенерируется заново.

Профилактика

• В paper.yml включите защиту от зацикливания: redstone-implementation: ALTERNATE.
• Установите плагин AntiRedstoneClock — он автоматически отключает слишком быстрые мигалки.
• Ограничьте максимальную частоту редстоуна: в paper.yml max-redstone-clocks-per-tick: 16.

💡 Совет профи

Если вы нашли зацикленную схему, но не можете её сломать (сервер падает при загрузке чанка), используйте NBT Explorer для редактирования region-файла. Найдите проблемный чанк, найдите блок с редстоун-пылью или факелом и измените его BlockState на «air» (воздух). Сохраните файл и запустите сервер — цикл разорван, мир спасён.