Repository navigation
Releases
easyRoad's_0.7_beta
🛣️ EasyRoads v0.5.1 — Voxelizer Hotfix
🛠️ Voxelizer & Geometry Fixes
- Voxelization Artifacts Resolved — Completely overhauled curve rasterization, eliminating misplaced and phantom blocks.
- Fixed Diagonal Road Width — Normalized grid stepping so diagonal paths maintain consistent, uniform width without stretching.
- Clean End Caps & Intersections — Strict boundary clipping now prevents overlapping and jagged edges at curve endpoints.
- Smooth Spline Geometry — Eradicated bulging and wave distortions across multi-point Bézier segments.
easyRoad's_0.5_alpha
🛣️ EasyRoads — Patch Notes
🌟 New Features & Studio Improvements
- Preset Name Editing — You can now rename presets directly inside the Preset Studio GUI via the new interactive text box.
- Preset Management — Added one-click buttons to create new presets, duplicate existing configurations, and delete unwanted ones.
- Modular Stack Elements — Expanded customization with dedicated layers: Sidewalks, Curbs, Lanes, Dashed & Solid Markings (long, short, double), Median Dividers, and Shoulders.
- Studio View Toggles — Easily preview individual road components (Road, Viaducts, Tunnels, Embankments, and Slopes) in real time before building.
⚡ Geometry & Voxelizer Engine
- Smooth C¹ Curve Continuity — Implemented Catmull-Rom to Cubic Bézier spline chain conversion, eliminating bulges, wave distortions, and uneven widths on multi-point curves.
- Intersection & Junction Support — Significantly improved roadway merging at intersections and connecting angles.
- Strict Boundary Clipping — Added half-space perpendicular end-cap clipping, ensuring roads terminate cleanly without rogue overhang blocks.
- Diagonal Step Normalization — Fixed block density distortion on diagonal road sections for consistent cross-section thickness.
- Quick Undo (
Ctrl+Z) — Roll back the last built road segment instantly with hotkeys or/road undo.
🌐 Localization & Polish
- Full Bilingual Support — Complete English (
en_us) and Russian (ru_ru) translations for all tools, overlay hints, studio buttons, and chat messages. - Crisp Overlay Hints — Improved action bar notifications showing point coordinates, elevation controls, and remaining nodes.
easyRoad's_0.4_alpha
EasyRoads (Road Builder)
Интуитивное, плавное и процедурное строительство дорог в Minecraft в 3D.
Возможности • Управление и горячие клавиши • Команды • Студия пресетов • Сборка из исходников
Warning
Проект находится на стадии Альфа-тестирования!
EasyRoads активно разрабатывается и тестируется. Некоторые механики могут меняться, также возможны баги и шероховатости. Рекомендуем делать резервные копии миров перед масштабным тестированием. Обо всех найденных ошибках и пожеланиях пишите в GitHub Issues!
🌟 О проекте
EasyRoads кардинально меняет подход к строительству дорог в Minecraft. Забудьте о долгой и рутинной расстановке блоков вручную или некрасивых ломаных линиях под прямыми углами! EasyRoads позволяет проектировать реалистичные, плавные шоссе, городские улицы, горные серпантины и просёлочные тропы с помощью трехмерных кривых Безье (3D Bézier curves) и интерактивного внутриигрового редактора.
Оценивайте будущую трассу в реальном времени с помощью 3D-гизмо, настраивайте высоту подъемов и радиусы поворотов, выбирайте структуру слоев и дорожных профилей, и стройте готовую дорогу нажатием одной клавиши.
✨ Возможности
- 🛣️ 3D геометрия кривых Безье: Плавные повороты, скоростные дуги шоссе и аккуратные переходы высоты без угловатых ступенек.
- 🎯 Интерактивный редактор в игре (Edit Mode):
- Инструмент «Добавить» (Add): Ставьте опорные точки трассы прямо по ландшафту щелчком мыши (ЛКМ).
- Инструмент «Выбрать» (Select): Выбирайте существующие точки для контроля и редактирования.
-
Инструмент «Двигать» (Adjust): Точное позиционирование точки в 3D (высота
$Y$ с помощью колесика мыши, смещение в плоскости$XZ$ стрелками или WASD). - Инструмент «Удалить» (Delete): Быстрое удаление лишних точек прямо в процессе работы.
- 👁️ Визуализация в реальном времени (3D Gizmo Preview): Вы сразу видите точную траекторию полотна, ширину и наклон дороги до установки блоков в мир.
- 🎨 Студия пресетов дорог (Preset Studio):
- Настройка многослойных профилей (асфальтовое покрытие, гравийное основание/подушка, бордюры, тротуары, разметка).
- Быстрое переключение и сохранение собственных стилей дорог.
- ↩️ Безопасная система отмены (Undo): Промахнулись или построили трассу не там? Команда отмены аккуратно вернет исходный ландшафт без лишнего мусора и дыр.
- ⚡ Оптимизированная серверная вокселизация: Быстрая генерация блоков, рассчитанная на плавный TPS сервера.
🎮 Управление и горячие клавиши
Все клавиши можно переназначить в настройках игры: Настройки
| Клавиша | По умолчанию | Описание |
|---|---|---|
| Режим редактирования | F7 |
Вход / выход из режима создания дорог |
| Студия пресетов | Caps Lock |
Открыть GUI для выбора материалов и стилей дороги |
| Построить дорогу (Финализация) | Enter |
Сгенерировать блоки вдоль активной кривой |
| Поставить опорную точку | Левый клик (ЛКМ) |
Поставить новую точку на земле (в режиме «Добавить») |
| Высота точки ( |
Колесико мыши |
Изменить высоту выбранной точки (в режиме «Двигать») |
| Горизонтальное смещение ( |
Стрелки / WASD
|
Точная подстройка точки по координатам |
⌨️ Команды
| Команда | Уровень прав | Описание |
|---|---|---|
/road undo |
OP (Уровень 2) | Отменяет последнюю построенную дорогу и восстанавливает ландшафт |
/road clear |
OP (Уровень 2) | Очищает активные точки трассы и режим предпросмотра |
/road stats |
OP (Уровень 2) | Выводит статистику текущего графа дорожной сети |
/road test |
OP (Уровень 2) | Создает тестовый отрезок дороги для проверки |
🛠️ Студия пресетов дорог
Нажмите Caps Lock во время игры, чтобы открыть Road Preset Studio:
- Выбирайте готовые стили (шоссе, городская улица, деревенская дорожка).
- Задавайте ширину проезжей части и тротуаров.
- Подбирайте палитру блоков для дорожного основания, асфальта, линий разметки и ограждений.
💻 Сборка из исходников
Требования
- Java 21 или новее
- Git
Инструкция по сборке
Склонируйте репозиторий и соберите проект через Gradle:
git clone https://github.com/kirichVRX/EasyRoads.git
cd EasyRoads
# В Windows:
.\gradlew build
# В Linux / macOS:
./gradlew buildСкомпилированный файл мода (.jar) будет находиться в папке build/libs/.
📜 Лицензия и авторство
Автор: kirichVRX. Разработано для Minecraft NeoForge.
Идеи, отзывы и сообщения об ошибках приветствуются в GitHub Issues!