ProbeJS в Minecraft: как получить умные подсказки для KubeJS и ускорить разработку модпаков
Если ты настраиваешь Minecraft не только через меню, но и через скрипты, то наверняка сталкивался с KubeJS: мощным инструментом для изменения рецептов, механик, лута и поведения контента на серверах и в одиночной игре. Проблема у такого подхода обычно одна — скрипты быстро растут, и без автодополнения легко запутаться в названиях блоков, предметов, жидкостей и событий. Именно здесь и нужен ProbeJS: мод, который генерирует типизацию и делает работу с KubeJS заметно удобнее.
По сути, ProbeJS превращает хаотичное редактирование JavaScript-файлов в более предсказуемый процесс, где IDE понимает структуру проекта. Для тех, кто делает сложные сборки с модами, кастомным crafting и уникальными механиками, это экономит часы времени и снижает количество ошибок перед запуском сервера.
Что такое ProbeJS и зачем он нужен
ProbeJS — это специализированный мод-генератор типизации для KubeJS-окружения. После запуска команды дампа внутри игры он формирует служебные файлы, благодаря которым в VSCode появляются автоподсказки, сниппеты и контекстная информация. Когда ты пишешь скрипт на изменение рецептов в определенном биоме или на поведение редкого блока в новой версии модпака, редактор начинает «понимать», что именно ты вводишь.
В реальной практике это дает несколько преимуществ:
- меньше опечаток в идентификаторах предметов, блоков и флюидов;
- быстрее написание скриптов для crafting и кастомных механик;
- удобная навигация по большим KubeJS-проектам;
- более аккуратная поддержка обновлений и версий модов;
- снижение числа «тихих» ошибок, которые проявляются только в игре.
Ключевые изменения версии 7.0.0
Один из самых важных моментов в актуальной ветке ProbeJS — переработка генерации кода. Теперь для корректных type hints скрипты нужно размещать в папке src внутри соответствующего каталога сценариев (например, в startup_scripts/src). Для разработчиков это сначала кажется дополнительным шагом, но на практике структура проекта становится чище, а подсказки — стабильнее.
Если у тебя ранее скрипты лежали «плоско» без разделения, стоит заранее спланировать миграцию, особенно в сборках с десятками модов. При переходе между версиями Minecraft такая дисциплина помогает быстрее адаптировать код под новые API и изменения мод-экосистемы.
Как ProbeJS работает вместе с KubeJS
Стандартный сценарий использования довольно понятный: устанавливаешь мод, запускаешь игру, выполняешь команду /probejs dump, после чего открываешь папку инстанса Minecraft в VSCode. В результате появляются файлы типизации и вспомогательная структура, на основе которой редактор выдает автодополнение в js-файлах папки KubeJS.
В этом месте ProbeJS особенно полезен для тех, кто пишет сложные сценарии без event.custom-оберток и хочет типизировать рецепты более «нативно». В версиях для 1.20.1 мод также получил возможность подтягивать предопределенные recipe support скрипты из публичного репозитория сообщества. Это значит, что совместимость с модами расширяется быстрее, а тебе не нужно каждый раз писать много ручного кода для типизации новых рецептов.
Кстати, если ты часто экспериментируешь с разными сборками, этот мод можно быстро поставить через лаунчер foxygame.net: он удобный, гибкий и современный, а моды устанавливаются прямо из меню без лишней рутины. Такой подход хорошо экономит время, когда нужно оперативно проверить новую связку модов и скриптов.
Совместимость, IDE и важные ограничения
Здесь важно понимать главный нюанс: генерация ориентирована в первую очередь на VSCode. Другие IDE иногда читают declaration-файлы, но полноценные сниппеты и поведение автодополнения могут отличаться. Поэтому если ты делаешь серьезную скриптовую инфраструктуру для сервера, лучше сразу тестировать в целевой среде разработки.
Также ProbeJS поддерживает и Forge, и Fabric, что удобно для команд, работающих с разными платформами и версиями Minecraft. Но старые версии мода обычно не в приоритете поддержки, так что перед репортом багов всегда обновляйся до последнего релиза.
Типичные проблемы и быстрая диагностика
Иногда после дампа кажется, что ничего не работает: нет подсказок, сниппеты не появляются, hover-информация пустая. На практике проблема чаще всего в структуре файлов или настройках VSCode-проекта.
- проверь, что в папке .vscode появились JSON-файлы, связанные с ProbeJS;
- убедись, что в каталоге KubeJS есть папка probe и файлы .d.ts;
- посмотри, нет ли синтаксических ошибок в сгенерированных declaration-файлах;
- убедись, что открыт именно корень инстанса Minecraft, а не только отдельная подпапка;
- проверь, активны ли расширения JS/TS и не отключен ли встроенный JavaScript language service.
Если всё на месте, но подсказки не появились, это может быть ограничение самого окружения VSCode на конкретной машине. В таком случае помогает перегенерация дампа, перезапуск окна редактора и проверка версии мода.
Расширенные возможности для модпаков и серверов
В больших проектах ProbeJS раскрывается сильнее всего. Когда у тебя кастомные крафты, баланс предметов, правки мобов по биомам и сезонные механики на сервере, ручное запоминание API становится узким местом. Автоподсказки позволяют держать темп разработки и не ломать логику после каждого обновления модов.
Дополнительный плюс — более предсказуемый onboarding для команды. Новому разработчику проще разобраться в скриптах, когда IDE сразу показывает доступные методы, параметры и допустимые типы. Это особенно полезно в долгоживущих сборках, где контент обновляется по версиям, а скрипты постепенно усложняются.
Итог: стоит ли ставить ProbeJS
Если ты серьезно работаешь с KubeJS, ProbeJS — практически обязательный инструмент. Он не добавляет новый биом или красивый блок в мир напрямую, но радикально улучшает «закулисную» часть разработки: автодополнение, стабильность скриптов и скорость правок. Для авторов модпаков, администраторов серверов и технических игроков это один из самых полезных модов в категории инфраструктуры.
Главная стратегия простая: держи актуальную версию, соблюдай структуру src для скриптов, регулярно запускай дамп после изменений и тестируй поведение в целевой версии Minecraft. Тогда ProbeJS станет не просто вспомогательным модом, а основой комфортной и надежной работы с KubeJS в любых масштабах проекта.
--- **Обновление 11.05.2026:** Добавлено 1 файл для версии 1.21.1 (NeoForge). --- **Обновление 17.05.2026:** Добавлено 1 файл для версии 1.21.1 (NeoForge). --- **Обновление 21.05.2026:** Добавлено 1 файл для версии 1.21.1 (NeoForge). --- **Обновление 26.08.2026:** Добавлено 1 файл для версии 1.21.1 (NeoForge).