Перейти к содержимому
Mineforgian

RoadWeaver

RoadWeaver is a Fabric mod designed for Minecraft Java Edition, which automatically weaves elegant road networks between in-game structures such as villages.

463K загрузок252 подписчиковMITfabricforgeneoforge

Обновлён 17 мая 2026 г. · опубликован 3 октября 2025 г.

  • Winding paths
  • Intelligent obstacle avoidance
  • Roadside structure decoration
  • new map
  • Tree generation blocking
  • Bridge

RoadWeaver

Modrinth Downloads CurseForge Downloads Discord Invite Github Stars

English | 简体中文

A Minecraft mod that automatically generates beautiful roads between villages or custom structures.

Key Features

1. Smart Road Generation

  • Intelligent Pathfinding: Multiple pathfinding algorithms that avoid steep and dangerous areas; adjusts routes based on terrain height, biomes, and ground stability
  • Bezier Curves: Applies Bezier curve smoothing to polyline paths, creating natural smooth curves and avoiding sharp turns
  • Multiple Road Types:
    • Artificial roads: (stone bricks, slabs), (dirt, mud bricks), etc., or customize your own in the preset editor
    • Natural roads: Biome-adaptive road materials
  • Obstacle Avoidance: Cuts, fills terrain and removes trees to ensure road passability
  • Tunnel & Bridge System: Tunnels through mountains, bridges over water
  • Slab System: Fills slabs at elevation changes to improve passability
  • Road Foundation: Smoothly interpolates surrounding height field based on road elevation, fills foundation only when road is above original terrain, creating natural convex slopes that blend seamlessly with the landscape

2. Decoration System

  • Lamp System: Redstone lamps with automatic day/night control
  • Signpost System: Distance markers and directional signs
  • Roadside Structure Decorations: Randomly generates benches, campfires and other decorative structures along roads

3. Configuration Options

  • Performance Optimization: Multi-threaded async generation with concurrency control; height and terrain caching to reduce redundant calculations
  • Multiple Network Planning Algorithms: KNN (sparsest) / Delaunay (densest) / RNG (balanced)
  • Multiple Pathfinding Algorithms: A* / Bidirectional A* / Fluid Simulation
  • Road Block Customization: Mix and match in the preset editor

4. Visualization Tools

  • Visual Debugging: Road network map; status colors (planned/generating/completed/failed); interactions (drag, zoom, right-click teleport); statistics for road count, length and status
  • Manual Link Mode: Plan road networks according to your preferences

Compatibility

  • New versions (2.0.0+) completely abandon the old /locate command search mechanism, no longer blocking the game main thread
  • Structure prediction, road network planning and pathfinding all run in dedicated thread pools; main thread only handles driving and result application

Known Compatibility & Performance Issues

  • This mod (2.0.6+) is compatible with Tectonic-V2 / Epic Terrain / Terralith, but incompatible with Tectonic-V3
  • This mod relies on vanilla mechanics, so it's incompatible with mods that overhaul vanilla mechanics like TerraFirmaCraft: The Next Generation

Incompatibility symptoms:

  • Extremely slow road generation
  • Very slow or blank map data loading
  • Map shows roads as generated but nothing appears when approaching

Performance factors:

  • World terrain complexity
  • Pathfinding step size and weight configuration
  • Concurrent road generation count and thread pool size

Usage

  • Auto Generation: Roads automatically generate between structures after entering the world
  • Road Network Map: Press H to open the debug map and view the road network
  • Configuration: Cloth Config API settings screen (built-in since 2.0.2), accessible from the world creation screen or by pressing H in-game and clicking the top-right corner

Inspiration

Based on Countered's Settlement Roads, map inspired by RoadArchitect.

Future Plans

  • More roadside decorations?
  • Link multiple structure types
  • Link biomes?
  • More beautiful buildings?
  • Road events?
  • Custom linking
  • Main road system?
  • Slab transitions
  • Bezier curve smoothing

Notes

  • The more structures configured to locate when loading a world, the longer world creation takes, but the more complete the road network
  • Roads cannot generate on already-loaded chunks, so don't approach road segments before they finish generating

简体中文

自动在村庄或自定义结构之间生成美观道路的 Minecraft 模组。

主要特性

1. 智能道路生成

  • 智能路径生成:多种寻路算法,避开陡峭与危险区域;根据地形高度、生物群系与地面稳定性调整路线
  • 贝塞尔曲线:对寻路得到的折线路径应用贝塞尔曲线平滑插值,将其变为更自然的平滑曲线,避免生硬拐弯
  • 多种道路类型
    • 人工道路:(石砖、石板)、(泥土、泥砖)等,也可在预设编辑器中自行搭配
    • 自然道路:按生物群系自适应道路材料
  • 避障系统:为确保道路的通过性,会对地形进行切削、填补、移除树木等处理
  • 隧道 & 桥梁系统:遇山开山、遇水搭桥
  • 半砖系统:为道路有高度差的地方填补半砖提高通过性
  • 路基生成:根据道路高度对周围高度场进行平滑插值,只在道路高于原始地形时填充路基,形成自然的"凸"字形坡面,避免道路悬空的同时又完美融入了地形

2. 装饰系统

  • 路灯系统:红石灯与昼夜自动控制
  • 路标系统:距离标志和方向指引
  • 路边结构装饰:在路旁随机生成座椅、小火堆等结构装饰

3. 配置选项

  • 性能优化:多线程异步生成并发控制;高度与地形缓存减少重复计算
  • 多种路网规划算法:提供 KNN(最稀疏)/ Delaunay(最密集)/ RNG(适中)三种路网规划算法
  • 多种寻路算法:提供 A* / 双向 A* / 流体模拟 三种寻路算法
  • 道路方块自定义:可在预设编辑器中自行搭配

4. 可视化工具

  • 可视化调试:道路网络地图;状态颜色(计划/生成/完成/失败);交互(拖拽、缩放、右键传送);统计道路数量、长度与状态
  • 手动链接模式:按自己的喜好来规划路网

兼容性

  • 新版本(2.0.0 版本以上)完全抛弃了旧版依赖的原版指令 /locate 搜索机制,不会阻塞游戏主线程
  • 结构预测、路网规划和寻路均在专用线程池中执行,主线程只负责驱动与结果应用

已知兼容性与性能问题

  • 本模组(2.0.6 版本以上)与 Tectonic-V2 版 / 史诗地形 / Terralith 模组兼容,与 Tectonic-V3 版不兼容
  • 本模组依赖原版机制,所以与群峦传说:次世代等颠覆了原版机制的模组不兼容

不兼容具体表现为:

  • 道路生成极为缓慢
  • 地图数据加载极为缓慢甚至长时间空白
  • 地图显示已生成但走近却完全没有

性能影响因素:

  • 世界地形复杂度
  • 寻路步长、权重配置
  • 道路同时生成数量与线程池数量

使用方式

  • 默认自动生成:进入世界后道路会自动在结构间生成
  • 路网地图:按 H 打开调试地图查看道路网络
  • 配置选项:模组 Cloth Config API 配置界面(2.0.2 以上版本已内嵌),可在新建世界界面或在游戏中按快捷键 H 打开地图后在右上角打开

模组灵感

模组基于 Countered's Settlement Roads 制作,地图灵感来源 RoadArchitect

未来计划

  • 更多路边装饰?
  • 链接多种结构
  • 链接群系?
  • 更多精美建筑?
  • 路途事件?
  • 自定义链接
  • 主路系统?
  • 半砖过渡
  • 贝塞尔曲线平滑

注意事项

  • 设置里加载世界时定位的结构数量越多,创建世界的时间就越久,完整度越高
  • 道路无法在已加载区块上生成,所以,如道路未生成完毕,请不要走近该路段

Версии

ВерсияКаналИграЗагрузчикиДатаСкачать
2.2.2-1.21.1Релиз1.21.1neoforge17 мая 2026 г..jar (5.3 МБ)
2.2.2-1.21.1Релиз1.21.1fabric17 мая 2026 г..jar (5.3 МБ)
2.2.2-1.20.1Релиз1.20.1forge3 мая 2026 г..jar (5.3 МБ)
2.2.2-1.20.1Релиз1.20.1fabric3 мая 2026 г..jar (5.2 МБ)
2.2.1-1.21.11Альфа1.21.11neoforge10 марта 2026 г..jar (5.3 МБ)
2.2.1-1.21.11Альфа1.21.11fabric10 марта 2026 г..jar (5.3 МБ)
2.2.1-1.20.1Релиз1.20.1forge10 марта 2026 г..jar (5.2 МБ)
2.2.1-1.20.1Релиз1.20.1fabric10 марта 2026 г..jar (5.2 МБ)
2.2.1-1.21.1Релиз1.21.1neoforge10 марта 2026 г..jar (5.3 МБ)
2.2.1-1.21.1Релиз1.21.1fabric10 марта 2026 г..jar (5.3 МБ)
2.2.0-1.20.1Релиз1.20.1fabric4 марта 2026 г..jar (5.2 МБ)
2.2.0-1.20.1Релиз1.20.1forge4 марта 2026 г..jar (5.2 МБ)
2.1.1-1.21.1Релиз1.21.1fabric16 января 2026 г..jar (6.3 МБ)
2.1.1-1.21.1Релиз1.21.1neoforge16 января 2026 г..jar (6.3 МБ)
2.1.1-1.20.1Релиз1.20.1forge15 января 2026 г..jar (6.3 МБ)

Показаны последние 15 из 40 версий. Все версии — на Modrinth.

Ченджлог

2.2.2-1.20.1Релиз1.20.1 · 3 мая 2026 г.

1.新增路边结构 2.重构地形高度采样系统,高精度模式解决了浮空路/水中桥等问题,大幅提升道路生成质量 3.强烈推荐使用高精度寻路,在道路质量大幅提升的同时,寻路速度也大幅提升 4.可调整辐射宽度进一步提升道路质量

2.2.1-1.21.11Альфа1.21.11 · 10 марта 2026 г.

Transplanted for the first time, the function is imperfect, use with caution

2.2.1-1.21.1Релиз1.21.1 · 10 марта 2026 г.

Added map opening permission command

2.2.0-1.20.1Релиз1.20.1 · 4 марта 2026 г.
  • Added adjacent road adsorption function
  • New road network planning algorithm*新的路网规划算法
  • Connect road placement to the original Beardifier process*将道路放置连接到原始的Beardifier过程
  • Added contour wayfinding method
  • Fix the street sign system*修复路牌系统
  • Added idle road generation function/modified configuration items
  • Improve the quality of road generation*提高道路生成的质量
2.1.1-1.20.1Релиз1.20.1 · 15 января 2026 г.
  1. Significant performance improvement, road generation speed increased more than tenfold
  2. Tree generation blocking system compatible with c2me mod
  3. More bridges
  4. The database is converted from SQLite to H2
  5. Mod size significantly reduced
2.1.1-1.20.1Релиз1.20.1 · 15 января 2026 г.
  1. Significant performance improvement, road generation speed increased more than tenfold
  2. Tree generation blocking system compatible with c2me mod
  3. More bridges
  4. The database is converted from SQLite to H2
  5. Mod size significantly reduced
2.1.0-1.20.1Релиз1.20.1 · 31 декабря 2025 г.

Roadweaver Update Introduction

New content:

  1. Highway System (Test), the Highway System is still in the early testing stage and is only for enjoyment. Please do not enable it in your commonly used save file.
  2. Multi-dimensional road system (testing), and road system in the same way, only a portion of the normal dimensions can be placed on the road, such as "PasterDream | PasterDream"PasterDream | PasterDream mod;
  3. New structure template bridgeBridge (triggered only when the bridge width exceeds 20), this feature comes from Hello-LuckyHuang, thank you very much! (currently only two styles of templates, more types to be updated in the future)

Optimize content. Optimize the structure selection to make it more beautiful and simple. 2. Optimize the preset editor, more concise, support natural road editing. 3. Natural roads support half bricks over. Optimize the default generation of bridges as a straight line.

Compatible with:

  1. Compatibility with c2me/c2mef: Now c2me will no longer affect the generation of trees to block systems. 2.sqlite redirection: resolve conflicts between sqlite and other mods.
  2. Roadway preset editor adds a rollback mechanism to prevent crashes due to rendering issues with certain mods.

Fix:

  1. Fix the issue of structure selection.

Congratulations to everyone on New Year's!

2.1.0-1.20.1Релиз1.20.1 · 31 декабря 2025 г.

Roadweaver Update Introduction

New content:

  1. Highway System (Test), the Highway System is still in the early testing stage and is only for enjoyment. Please do not enable it in your commonly used save file.
  2. Multi-dimensional road system (testing), and road system in the same way, only a portion of the normal dimensions can be placed on the road, such as "PasterDream | PasterDream"PasterDream | PasterDream mod;
  3. New structure template bridgeBridge (triggered only when the bridge width exceeds 20), this feature comes from Hello-LuckyHuang, thank you very much! (currently only two styles of templates, more types to be updated in the future)

Optimize content. Optimize the structure selection to make it more beautiful and simple. 2. Optimize the preset editor, more concise, support natural road editing. 3. Natural roads support half bricks over. Optimize the default generation of bridges as a straight line.

Compatible with:

  1. Compatibility with c2me/c2mef: Now c2me will no longer affect the generation of trees to block systems. 2.sqlite redirection: resolve conflicts between sqlite and other mods.
  2. Roadway preset editor adds a rollback mechanism to prevent crashes due to rendering issues with certain mods.

Fix:

  1. Fix the issue of structure selection.

Congratulations to everyone on New Year's!

Полная история изменений — на Modrinth.

Комментарии

Загружаем…