Foundry Engine

FoundryEngine

Внутриигровая платформа для разработки и скриптовый движок, созданный как мод для NeoForge Minecraft.

Кратко

FoundryEngine — это мод для NeoForge, который позволяет создателям строить собственные игровые системы, предметы, катсцены и диалоги с помощью скриптов на Groovy и встроенного редактора. Благодаря модульным бандлам и горячей перезагрузке вы можете разрабатывать и тестировать контент прямо внутри Minecraft, не перезапуская игру.

Что такое FoundryEngine?

FoundryEngine предоставляет внутриигровую среду разработки для Minecraft. Он позволяет мапперам, владельцам серверов и создателям модпаков делать самостоятельные игры, кастомные механики и интерактивные сюжетные системы без компиляции отдельных JAR-модов. Контент пишется на скриптах Groovy и организуется в самодостаточные бандлы. Благодаря встроенному набору редакторов Dear ImGui и перезагрузке на лету (/engine reload) правки скриптов и обновления ассетов применяются сразу, пока игра запущена.

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

Ключевые возможности

Бандлы и скриптинг

• Самодостаточные пакеты: группируйте скрипты, модели, текстуры и звуки в изолированные папки внутри .minecraft/FoundryEngine/bundles/
• Горячая перезагрузка: тестируйте логику скриптов и изменения ассетов на лету с помощью /engine reload. (Изменения реестра требуют перезапуска игры и пока не поддерживают горячую перезагрузку.)
• Понятная структура: организуйте код по отдельным точкам входа common, server и client.

Внутриигровой редактор ImGui

• Редактор скриптов и JSON: редактируйте скрипты Groovy прямо внутри Minecraft с подсветкой синтаксиса и проверкой ошибок.
• Редактор диалогов: создавайте ветвящиеся разговоры с вариантами ответов игрока, кастомными требованиями и триггерами скриптов.
• Визуальная шкала катсцен: расставляйте камеры по сплайнам с ключевыми кадрами, фокусными точками и плавными переходами.
• Инструменты пространственных зон: размещайте 3D-ограничивающие боксы в мире, чтобы визуально настраивать триггерные зоны.
• Утилиты для разработки: просматривайте текстуры, листайте файлы, тестируйте рецепты, следите за логами консоли и коммитьте изменения в Git.

Игровые подсистемы

• API для билдеров: регистрируйте предметы, блоки, блочные сущности, рецепты, звуки, частицы и теги прямо из скриптов.
• Шина событий: подключайтесь к игровым тикам, кликам по блокам, взаимодействиям с игроком, бою и кастомным событиям жизненного цикла движка.
• Прогрессия по этапам: блокируйте предметы, блоки, мобов, рецепты и измерения за разблокируемыми этапами прогрессии.
• Инстансные измерения: создавайте временные копии измерений для кастомных игровых сессий, подземелий или мини-игр, не трогая сохранения основного мира.
• Экранные шейдеры: применяйте постобработку, включая виньетку, размытие по глубине, цветовые переходы и кастомные скайбоксы.

---

С чего начать

Для игроков и владельцев серверов

1. Установите NeoForge на Minecraft 26.1.2 или 26.2
2. Поместите FoundryEngine и его обязательные зависимости в папку mods/.
3. Положите скачанные пакеты контента в папку /FoundryEngine/bundles/.
4. Запустите игру или сервер.

Для создателей и авторов сборок

1. Загляните в вики FoundryEngine за руководствами, туториалами по билдерам и документацией по API.
2. Откройте внутриигровой редактор назначенной комбинацией клавиш или через меню.
3. Создайте новый бандл в папке /FoundryEngine/bundles/ или начните с шаблона ExampleBundle.
4. Напишите логику регистрации и геймплея в скриптах Groovy.
5. Запустите /engine reload, чтобы протестировать изменения скриптов и ассетов в реальном времени. (Изменения реестра требуют перезапуска игры.)

---

Требования и совместимость

• Загрузчик модов: NeoForge
• Версия Java: Java 25
• Поддерживаемые версии: Minecraft 26.1.2 и Minecraft 26.2
• Окружение: клиент, выделенный сервер и одиночная игра

---

Ссылки

• Вики с документацией: luckymcdev.github.io/FoundryEngine
• Исходный код: репозиторий на GitHub
• Стартовый шаблон: репозиторий Example Bundle
• Проблемы: GitHub Issues

---

Благодарности

• LuckyMcDev: создатель и ведущий разработчик
• Auseawesome: дизайн функций и логотип
• G_cat: альфа-тестирование
• Создано с использованием NeoForge, Apache Groovy, ImGuiMc и Stonecutter.