ChunkDebug - расшифровываем чанки в Майнкрафте

ChunkDebug - это мод для Minecraft (на Фабрике), который решает одну из самых головных болей технарей и администраторов серверов - отладку загрузки чанков. В ванильной игре ты можешь только догадываться, какие именно чанки сейчас загружены, почему лагает редстоун-ферма или куда пропали мобы. Этот мод показывает всё наглядно и в реальном времени.

Что это и зачем нужно

Если ты когда-нибудь ловил себя на мысли "Почему у меня не работают фермы?" или "Откуда эти лаги?", то ChunkDebug - штука для тебя. Он выводит живую карту всех загруженных чанков в любом измерении - от обычного мира до Края. Причём показывает не просто "загружен/не загружен", а полную картину: текущий статус чанка, его билеты (chunk tickets) и стадию генерации мира. В общем, не гадалка, а диагност.

Изначально мод создавался под CarpetClient для Майнкрафт 1.12.2, но я переписал его с нуля под современные версии. Поддерживаю только последнюю версию Minecraft, так что без обид.

Как пользоваться

Тут важно: мод нужен и на клиенте, и на сервере. Для одиночной игры достаточно установить на клиент - всё само подхватится.

На сервере всё строже:

• Нужны права оператора или пермишен "chunk-debug" от системы прав типа Luck Perms
• Если хочешь дать доступ всем, поставь "require_permissions" в конфиге chunk-debug-server.json в false. Только осторожно - инструмент мощный.

Когда зашёл в игру, жми F6 (дефолтный хоткей) - откроется карта чанков. Хоткей можно поменять в настройках управления Майнкрафта.

Разбираемся с интерфейсом

Карта чанков

В центре - та самая карта в реальном времени. Можно зумить и панорамировать, всё как в картах. Сразу видно, какие чанки чем занимаются.

Меню настроек (слева)

Слева - панель с опциями. Можно спрятать через F1 или кнопкой в левом нижнем углу.

Наверху меняешь режим миникарты:

• No Minimap - без миникарты
• Static Minimap - показывает то, что в центре чанковой карты
• Following Minimap - следует за твоим игроком

Дальше - управление навигацией: прыгай по разным измерениям, ищи кластеры чанков (соседние загруженные участки). Полезно, когда хочешь найти все активные чанки в мире. Можно ещё вбить координаты вручную или вернуться к игроку.

Внизу - опции рендера:

• Render Generation Stages - раскрашивает чанки по стадиям генерации мира. Местами каша, но для детальной отладки - самое то. Можно отключить.
• Render Ticket Types - раскрашивает по типам билетов чанков. Показывает, почему чанк держится в памяти.
• Render Minimap - рендерит миникарту поверх карты чанков. Удобно для прицеливания.
• Chunk Retention - сколько тиков после выгрузки чанк будет плавно исчезать (фейд-аут). Выручает, когда чанки выгружаются рывками и надо понять, что происходит.

Миникарту можно настроить: выбери угол экрана для привязки (Minimap Corner), а если включишь Render Minimap, то сможешь перетаскивать её мышкой. Скроллинг на миникарте меняет её размер - удобно.

Меню выбора чанка (справа)

Кликаешь правой кнопкой по чанку на карте - он подсвечивается красным, справа вылезает меню с инфой по этому чанку. Закрывается так же - F1 или кнопкой в правом нижнем углу.

Что покажет:

• Координаты чанка
• Статус чанка (можно почитать на официальной вики Майнкрафта)
• Status Level и Ticking Status Level - да, это два разных уровня, из-за разделения симуляционной и рендер-дистанции
• Список всех билетов для выбранного чанка: тип, уровень, всё как надо
• Generation Stage - насколько далеко зашла генерация
• Флаг запланированной выгрузки

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

Так зачем всё это?

ChunkDebug - инструмент для настоящих профи. Он помогает:

• Найти чанки, которые не выгружаются и жрут память
• Понять, почему редстоун-схемы глючат вдали от игрока
• Отладить работу ферм и загрузчиков чанков
• Оптимизировать сервер, убирая лишние тикеты

Если ты строишь технические фермы, админишь сервер или просто любишь копаться в механике Майнкрафта - скачай мод ChunkDebug и забудь про гадания на кофейной гуще. Работает на последней версии Minecraft, требует Fabric и правильные пермишены. Скачивай, пробуй, дебажь!