Nautilus Studio - Packs Editor IDE

📖 Об моде 📖

Nautilus Studio — это внутриигровой верстак для дата- и ресурспаков. Вместо того чтобы вручную писать JSON и угадывать нужные поля, он открывает полноценный редактор прямо рядом с игрой: выбери файл, заполни сгенерированную форму, нажми перезагрузку — и изменение появится в запущенном мире.

Формы строятся автоматически на основе собственных определений контента игры, так что мод работает и с контентом модов, и с ванильным.

🖼️ Медиа 🖼️

📦 Возможности 📦

Что можно редактировать

• Генерация мира: configured и placed features, carvers, биомы, настройки шума, density functions, пресеты мира
• Структуры: структуры, наборы структур, jigsaw pools
• Лут и предикаты: таблицы лута, модификаторы предметов, предикаты
• Рецепты и достижения
• Зачарования
• Мир и измерения: измерения, типы измерений
• Варианты мобов, украшения и шаблоны, предметы и звуки и многое другое
• Всё, что регистрирует мод. Например, Polytone регистрирует свои colormaps, эффекты частиц и кастомные модели
• Любой кастомный codec, указанный по имени класса, даже для контента, который редактор никогда не видел
• Всё, что он не может распарсить, откатывается к редактору сырого JSON с подсветкой синтаксиса и живой валидацией

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

• Сначала зайдите в мир: редактору нужны живые реестры для построения форм и перезагрузки
• Откройте его через пункт Mod Menu на Fabric или через кнопку экрана конфигурации в списке модов на NeoForge
• Верстак открывается в отдельном окне рядом с игрой
• Нажмите перезагрузку, чтобы применить изменения в запущенном мире

Nautilus Studio лучше всего работает на Fabric. На NeoForge окно редактора иногда может не открыться из-за ограничений Java на headless-окна.

🛠️ Для разработчиков модов 🛠️

В большинстве случаев мод должен просто работать. Но если вы хотите нормальную совместимость, вот что можно сделать:

Чтобы зарегистрировать свой codec и чтобы он по умолчанию появлялся в редакторе, зарегистрируйте его так:

NautilusStudioApi.register(
    "My Mod",                  // название группы, отображается рядом с "Minecraft"
    "Widget Layout",           // название этого типа контента
    MY_CODEC,                  // ваш Codec для файла (DIRECT_CODEC)
    Side.CLIENT_RESOURCES,     // CLIENT_RESOURCES (assets/) или SERVER_DATA (data/)
    "mymod/widgets"            // папка, в которой лежат файлы
);

Чтобы получить более удобные виджеты — выбор цвета, слайдер, выпадающий список для sum type — постройте свой codec как SchemaCodec из CodecUI и передайте его вместо обычного. Он остаётся настоящим Codec с тем же форматом передачи. Всё, что CodecUI не может прочитать, откатывается к редактору сырого JSON с валидацией, так что регистрация всегда безопасна.

Просто добавь эти строки (jar-in-jar, так что CodecUI будет поставляться внутри твоего мода) и замени свои вызовы Codec на вызовы SchemaCodec, следуя API в этом классе:

repositories {
    maven { url "https://registry.somethingcatchy.net/repository/maven-public/" }
}

dependencies {
    // Fabric (Loom)
    modImplementation "net.mehvahdjukaar:codecui-fabric:1.21.11-0.4.0"
    include           "net.mehvahdjukaar:codecui-fabric:1.21.11-0.4.0"

    // NeoForge (ModDevGradle)
    implementation "net.mehvahdjukaar:codecui-neoforge:1.21.11-0.4.0"
    jarJar         "net.mehvahdjukaar:codecui-neoforge:1.21.11-0.4.0"
}

Полный DSL и примеры смотри в репозитории CodecUI.

❓ ЧаВо ❓

В: Это только клиентский мод?

О: Да. Редактор — клиентский инструмент: он редактирует файлы паков на диске и перезагружает твой клиент. На сервере он не нужен.

В: Нужен ли игрокам этот мод, чтобы использовать мой пак/мод?

О: Нет. Nautilus Studio — инструмент для создания. Паки, которые ты делаешь с его помощью, — это обычные ванильные паки данных/ресурсов, работающие у всех.

В: Работает ли он с модовым контентом?

О: Да. Любой мод, регистрирующий свой codec (одна строчка благодаря CodecUI), появляется автоматически. Также можно добавлять свои codec'и по имени класса.

В: Что, если Nautilus Studio не понимает файл?

О: Он переключается на редактор сырого JSON с проверкой в реальном времени и подсветкой синтаксиса, так что редактировать можно что угодно.

В: Нужен ли CodecUI как зависимость?

О: Нет. Nautilus Studio включает его в себя. CodecUI напрямую нужен только если хочешь вручную настроить виджеты редактора.

В: Fabric или NeoForge?

О: Поддерживаются оба. На Fabric опыт плавнее; на NeoForge внешнее окно иногда может упираться в ограничения AWT headless.

❤️ Поддержи меня ❤️

🦉 Наши моды 🦉