KubeJS Offline

Что такое KubeJS Offline и зачем он нужен

Если вы работаете с KubeJS - мощным инструментом для создания скриптов, рецептов и модификаций в Майнкрафт - то наверняка сталкивались с ситуацией, когда нужно быстро найти информацию о конкретном событии или типе данных. Обычно приходится лезть в документацию на GitHub или вики, но это не всегда удобно, особенно если интернет под рукой нестабилен.

KubeJS Offline решает эту проблему раз и навсегда. Это мод, который генерирует полную офлайн-документацию по всем событиям, свойствам и типам данных, которые использует KubeJS. Всё это собирается в один аккуратный HTML-файл, который можно открыть в браузере без доступа к сети.

Как это работает

Всё просто: запускаете одиночный мир (single-player), вводите команду /kubejsoffline - и мод автоматически собирает всю документацию по вашему текущему экземпляру игры. Файл сохраняется в папку /<instance>/kubejs/documentation (она создаётся сама после успешной генерации). Когда процесс завершится, в чате появится ссылка - кликайте по ней и сразу открывайте доку.

Никаких сложных настроек, никаких дополнительных действий. Просто запустил - получил результат.

Что внутри документации

В сгенерированном HTML-файле вы найдёте:

• Полный список всех событий KubeJS - от BlockEvents до EntityEvents и RecipeEvents.
• Свойства каждого события - какие данные доступны, какие типы у параметров, как их использовать в скриптах.
• Примеры использования - прямо в документации показано, как обращаться к тем или иным методам.
• Типы данных - все интерфейсы, классы и структуры, которые KubeJS предоставляет для работы.

Это буквально шпаргалка для разработчика. Не нужно гадать "а есть ли у этого события такой метод" - просто открываешь файл и смотришь.

Для кого этот мод

• Скриптеры и мододелы - те, кто пишет свои скрипты на KubeJS для серверов или сборок модов.
• Администраторы серверов - если вы настраиваете кастомные рецепты или механики через KubeJS, офлайн-документация сэкономит кучу времени.
• Все, кто ценит автономность - не нужно каждый раз тянуться к интернету, чтобы вспомнить синтаксис или название метода.

Совместимость и версии

Мод доступен для Forge и Fabric на версиях Minecraft 1.18.2 и 1.19.2. Если хотите посмотреть, как выглядит готовая документация до установки - вот ссылки на примеры:

• Forge 1.19.2: https://hunter19823.github.io/kubejsoffline/1.19.2/forge/
• Fabric 1.19.2: https://hunter19823.github.io/kubejsoffline/1.19.2/fabric/
• Forge 1.18.2: https://hunter19823.github.io/kubejsoffline/1.18.2/forge/
• Fabric 1.18.2: https://hunter19823.github.io/kubejsoffline/1.18.2/fabric/

Итог

KubeJS Offline - это не мод, который меняет геймплей или добавляет новые блоки. Это инструмент для разработчиков, который делает работу с KubeJS удобнее и быстрее. Если вы пишете скрипты для Майнкрафт или администрируете сервер с кастомными рецептами - скачайте KubeJS Offline и держите всю документацию под рукой, даже без интернета.