Easier World Creator (ewc) - библиотека для генерации мира

Easier World Creator (ewc) - библиотечный мод для Minecraft, созданный в первую очередь для разработчиков других модификаций. Он помогает быстро собирать собственные элементы генерации мира из простых геометрических форм, размещать крупные структуры и управлять их появлением без написания всей математики вручную.

Проект пригодится, если вы делаете мод с необычной генерацией, гигантскими постройками, процедурными объектами или многочанковыми структурами. В обычной разработке такие задачи быстро превращаются в расчёты координат, проверку границ чанков и оптимизацию вычислений. Easier World Creator берёт значительную часть этой рутины на себя.

Что делает Easier World Creator

Библиотека позволяет создавать геометрические формы, объединять их между собой и превращать в полноценные объекты игрового мира. Так можно строить не только простые сферы или цилиндры, но и более сложные композиции из нескольких фигур.

С помощью ewc можно:

• создавать собственные элементы генерации мира;
• размещать структуры и геометрические формы в мире;
• работать с объектами, которые занимают больше 3×3 чанков;
• комбинировать несколько форм в одну сложную конструкцию;
• анимировать процесс размещения структуры или формы;
• использовать конфигурационный API;
• применять готовые математические и вспомогательные инструменты для worldgen;
• работать с шумом Перлина (Perlin noise);
• размещать объекты как во время генерации мира, так и после неё.

В результате разработчик получает не готовый контентный мод, а набор инструментов для создания собственного контента. На игру напрямую библиотека почти не влияет, пока другой мод не использует её API. Зато для авторов генераторов миров это может заметно сократить объём однотипного кода.

Внутренняя страница проекта: /mod/ewc

Какие формы можно создавать

На данный момент библиотека поддерживает основные геометрические примитивы, которых хватает для большого числа задач в Minecraft:

• круги;
• сферы;
• цилиндры;
• двумерные и трёхмерные эллипсоиды;
• линии между двумя точками;
• спирали и их варианты;
• торы.

Фигуры можно использовать по отдельности или объединять. Например, из сфер и цилиндров можно собрать процедурную пещеру, из линий и тороидов - необычную структуру, а спирали подойдут для винтовых башен, тоннелей и декоративных элементов генерации.

Это не редактор построек для обычного игрока. Easier World Creator рассчитан на разработчиков, которые хотят описывать форму объекта через код и затем автоматически размещать блоки в мире.

Работа с крупными структурами

Одна из заметных особенностей ewc - поддержка многочанковых объектов. Библиотека рассчитана на структуры, выходящие за пределы стандартной области 3×3 чанка. Это важно для гигантских деревьев, подземных комплексов, высоких башен, огромных руин и других объектов, которые нельзя удобно разместить в пределах одной небольшой области.

Для таких генераторов особенно важны корректная обработка границ чанков и порядок установки блоков. Easier World Creator предоставляет основу, с которой разработчику проще управлять размещением большой формы и не собирать подобную систему с нуля.

Анимация размещения

Формы и структуры можно размещать не мгновенно, а с учётом различных параметров. Это позволяет создавать постепенное появление объектов, поэтапное формирование конструкции или специальные эффекты для генераторов мира.

Конкретное поведение зависит от мода, который использует библиотеку. Сам ewc не добавляет отдельный сюжетный режим или готовые события, а предоставляет API для управления процессом размещения.

Математические функции и производительность

В библиотеке есть собственные математические утилиты, ориентированные на задачи генерации мира. Особенно полезны быстрые функции для расчёта косинуса, который часто используется при построении окружностей, сфер, спиралей и других форм.

В описании проекта приводится такой тест на миллионе вычислений:

• Math.cos() - примерно 476 мс;
• FastMaths.getFastCos() - примерно 7 мс;
• FastMaths.getPreciseCos() - примерно 14 мс.

Это не означает одинаковый прирост скорости в каждом моде. Итоговая производительность зависит от железа, версии Java, количества блоков и логики самого генератора. Но при массовом создании геометрии подобные оптимизации могут быть полезны: генерация меньше упирается в повторяющиеся тригонометрические вычисления.

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

API для разработчиков модов

Методы библиотеки используют несколько общих параметров. Среди них:

• StructureWorldAccess world - доступ к миру, куда устанавливается структура или форма. Благодаря этому объект можно использовать во время генерации мира и в других сценариях;
• BlockPos pos - центральная позиция размещаемой структуры;
• List<BlockLayer> layers - список слоёв блоков, из которых формируется объект;
• параметры размеров - значения, необходимые конкретной форме для расчёта её границ и масштаба.

BlockLayer отвечает за описание слоёв блоков. Через такую систему можно задавать, какие материалы будут использоваться внутри формы или на разных её уровнях. Это удобнее, чем вручную прописывать отдельную обработку каждого блока в сложной конструкции.

Библиотека рассчитана на подключение к исходному коду другого мода. Поэтому обычному игроку не нужно искать в ней новые предметы, команды или отдельное меню. Её основная ценность раскрывается именно при создании собственного worldgen-мода для Minecraft.

Конфигурационный API

Easier World Creator включает API для конфигураций. Он может пригодиться модам, в которых нужно вынести параметры генерации в настройки: размеры объектов, используемые слои, частоту появления или другие значения, связанные с процедурным миром.

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

Что пока не реализовано

В описании проекта отдельно указано, что поддержки пользовательских форм частиц пока нет. То есть библиотека умеет работать с геометрией структур и блоков, но не предоставляет готовый инструмент для создания собственных particle-форм.

Если вашему модификационному проекту нужны сложные визуальные частицы, эту систему придётся реализовывать отдельно или подключать другой подход. Не стоит рассчитывать, что формы ewc автоматически будут работать как частицы.

Совместимость и установка

Easier World Creator относится к категориям Library, Utility и World Generation. Это библиотека, а не самостоятельная контентная модификация, поэтому её обычно устанавливают вместе с модом, который использует API.

Подтверждённая совместимость включает:

• Minecraft Java 1.20.x;
• Minecraft 1.21-1.21.4;
• Fabric;
• NeoForge;
• Quilt;
• клиентскую и серверную установку.

Для сборок на Fabric и Quilt требуется Fabric API. Автор также рекомендует устанавливать библиотеку и на клиент, и на сервер, если зависимый мод работает в сетевой игре. Точные требования лучше сверять с версией подключаемого мода и конкретным файлом ewc.

Подтверждённый файл для Minecraft 1.21.4 имеет версию 2.4.8-1.21.4 и предназначен для Fabric/Quilt. В линейке проекта также встречается версия 3.0.0+1.21.1: в ней переработали генерацию форм, добавили команды для многочанковых объектов и заявили ускорение генерации примерно до 90 процентов.

Не смешивайте файлы разных версий Minecraft. Для библиотеки это особенно критично: несовпадение API может привести не просто к отключению отдельной функции, а к ошибке запуска зависимого мода.

Лицензия

Easier World Creator распространяется по лицензии MIT. Библиотеку можно использовать как основу для собственных модификаций с учётом условий этой лицензии.

Кому пригодится ewc

Easier World Creator стоит рассматривать разработчикам, которые создают:

• моды с процедурной генерацией;
• большие подземелья и многочанковые руины;
• сложные природные объекты;
• спиральные, сферические и тороидальные конструкции;
• генераторы на основе шума Перлина;
• структуры с постепенным или управляемым размещением;
• серверные или клиентские проекты, которым нужен общий API для работы с формами.

Для игрока без собственного моддинга это вспомогательная зависимость, а не мод с новым измерением, мобами или предметами. Но внутри сборки модов Easier World Creator может быть важной частью другого worldgen-проекта: без него зависимый мод просто не запустится или потеряет функции генерации.

По факту это инструмент для тех, кто хочет строить генерацию мира не из набора жёстко заданных координат, а через понятные формы, слои и математические правила. Для разработчика Minecraft-модов такой подход заметно удобнее, особенно когда проект работает с крупными структурами и большим количеством вычислений.