NetJS (KubeJS Addon)
Если вы когда-нибудь писали сложные скрипты на KubeJS и внезапно понимали, что не хватает всего одной вещи — возможности забрать данные из сети прямо из игрового кода, то NetJS (KubeJS Addon) создан ровно для этого. Это небольшое, но крайне полезное расширение, которое открывает скриптам доступ к внешним ресурсам через ограниченный и безопасный интерфейс. Сам мод ничего не меняет в геймплее, зато даёт разработчикам паков инструмент, которого раньше приходилось добиваться костылями.
Что умеет NetJS (KubeJS Addon) для Minecraft
Дополнение добавляет обёртку под названием NetJS, доступную в любом месте ваших скриптов. Через неё можно обращаться к популярным сервисам хранения текста — PasteBin и GitHub Gist. По сути, вы получаете два метода: NetJS.getPasteBin и NetJS.getGists. Первый забирает содержимое пасты по её идентификатору, второй — данные гиста по хешу. Всё остальное — дело вашей фантазии: конфиги, таблицы рецептов, списки предметов, тексты квестов и прочие данные, которые удобно держать вне пака.
Ключевая фишка — режимы работы. По умолчанию запрос выполняется асинхронно: обращение к сети уходит в отдельный поток, игра продолжает работать, а колбэк вызывается, когда результат уже получен. Это значит, что даже медленный ответ сервера не превратит ваш мир в слайд-шоу.
Асинхронный и линейный режимы
- Асинхронный режим — рекомендуемый. Вызов вида NetJS.getPasteBin('3zCF8MM6', result => {}) не блокирует основной поток, а результат приходит в колбэк.
- Линейный режим — активируется вторым аргументом false. Запрос выполняется синхронно и останавливает главный поток клиента или сервера до получения ответа. Использовать стоит только в крайних случаях, когда без результата дальше никак.
Для гистов работает та же логика: NetJS.getGists('3f1cd831af032e52238ef161bdd715b3', result => {}) в асинхронном варианте и с флагом false — в линейном. Такой подход даёт гибкость: вы сами решаете, чем готовы пожертвовать ради простоты кода.
Совместимость и загрузчик
NetJS (KubeJS Addon) — это аддон к KubeJS, поэтому он требует установленного KubeJS и работает на загрузчике Forge для актуальных версий Minecraft (в том числе 1.19.x и 1.20.x). Перед установкой проверьте, что версия аддона совпадает с версией KubeJS и вашей сборки — иначе скрипты просто не увидят обёртку. Мод не влияет на ванильный контент и не конфликтует с другими расширениями, если те не переопределяют те же глобальные объекты.
Кстати, если не хочется вручную сверять версии Forge, KubeJS и самого аддона, удобно поставить всё через лаунчер foxygame.net: в его каталоге дополнений NetJS (KubeJS Addon) подбирается под вашу сборку автоматически, а обновления прилетают без ручной возни с файлами.
Как установить
Установка не требует навыков программиста. Достаточно скачать NetJS (KubeJS Addon) и положить файл в папку mods рядом с KubeJS. Порядок действий простой:
- Убедитесь, что у вас установлен Forge нужной версии и сам KubeJS.
- Скачайте NetJS (KubeJS Addon), соответствующий вашей версии Minecraft.
- Поместите jar-файл в папку mods и запустите игру.
- Проверьте работу обёртки в тестовом скрипте через NetJS.getPasteBin.
После запуска аддон не выдаст никаких видимых изменений — это нормально, ведь сам мод ничего не делает. Вся его сила раскрывается только в скриптах. Если обёртка не находится, проверьте логи: чаще всего проблема в несовпадении версий KubeJS и аддона.
Кому пригодится аддон
В первую очередь NetJS (KubeJS Addon) оценят авторы модпаков и датапаков, которые хотят обновлять данные без пересборки архива. Держите список предметов или настройки квестов в гисте — и правки будут подхватываться при следующем запросе. Это удобно для сезонных ивентов, ротации наград и централизованных конфигов на несколько серверов. Обычным игрокам аддон не нужен, но если вы заглядываете в скрипты хотя бы изредка, он заметно упрощает жизнь.
Единственное, о чём стоит помнить: сетевые запросы — это всегда внешняя зависимость. Недоступный PasteBin или Gist не должен ломать логику пака, поэтому асинхронный режим с обработкой ошибок в колбэке — правильный выбор по умолчанию. Линейный режим оставьте для случаев, когда без данных играть дальше невозможно.
Вывод
NetJS (KubeJS Addon) — узкоспециализированный, но аккуратно сделанный инструмент. Он не пытается быть универсальной сетевой библиотекой, а честно решает одну задачу: дать скриптам KubeJS безопасный доступ к внешнему тексту. Асинхронные вызовы, понятный API и минимальное вмешательство в игру делают его отличным выбором для тех, кто строит сложные паки на Forge и хочет держать данные под контролем.