RoadWeaver

Quick rating

RoadWeaver

No reviews yet

A Minecraft mod that automatically generates beautiful roads between structures like villages and outposts.

No Theme
Adventure/Exploration
Misc Structures
World Gen Improvements
Mod Loaders
Forge
NeoForge
Fabric
Minecraft
Hosting Partner

Want to reach Minecraft players?

We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!

Get in touch

Community voices

Reviews

Versions
Loading versions…
Match includes

Click once to include, again to exclude, again to clear

Rating Any
Any 0.5 1.0 1.5 2.0 2.5 3.0 3.5 4.0 4.5 5.0
Min
Max
Play Status
Reviews
Time Played
hrs+
Verified developers only
Has developer response
List view
Grid view
Compact view
Sort by
Date
Rating
Helpful
Unhelpful
Edited
Sort ascending
Delete this review?

This removes your review from the project. You can write a new review after.
Review submitted for moderation

Your review has been sent to moderators, who will check that it meets our guidelines before it appears publicly.

No reviews yet. Be the first to review this project!

Get it on

Available Platforms

CurseForge logo CurseForge Modrinth logo Modrinth

Compatibility

Supported Environments

Dev Environment
Client Required
Server Required

About

Project Details

Type
Mod
License
MIT License
Latest Version
roadweaver-fabric-2.3.1-1.21.1-hotfix.jar
Authors
CurseForge
Modrinth

For authors

Embed Badge

If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.

Custom banner text
ModDex rating badge preview

Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.

Identifiers

Platform IDs

CurseForge ID
Modrinth ID

Resources

External Links

Source Issues Wiki Discord

About

Description

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

  • <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;"> More roadside decorations?
  • <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;" checked> Link multiple structure types
  • <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;"> Link biomes?
  • <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;"> More beautiful buildings?
  • <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;"> Road events?
  • <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;" checked> Custom linking
  • <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;"> Main road system?
  • <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;" checked> Slab transitions
  • <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;" checked> 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。

未来计划

  • <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;"> 更多路边装饰？
  • <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;" checked> 链接多种结构
  • <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;"> 链接群系？
  • <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;"> 更多精美建筑？
  • <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;"> 路途事件？
  • <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;" checked> 自定义链接
  • <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;"> 主路系统？
  • <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;" checked> 半砖过渡
  • <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;" checked> 贝塞尔曲线平滑

注意事项

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

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。

未来计划

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

注意事项

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

Screenshots

Gallery

  • 屏幕截图 2025-11-22 170302 (1).jpg
    屏幕截图 2025-11-22 170302 (1).jpg 屏幕截图 2025-11-22 170302 (1).jpg
  • Roadside decoration
    Roadside decoration
  • Bézier curve roads
    Bézier curve roads 屏幕截图 2025-11-21 192146.jpg
  • Terrain cutting and filling
    Terrain cutting and filling 屏幕截图 2025-10-29 091407_compressed.png
  • New map UI
    New map UI 屏幕截图 2025-10-29 070636.png
  • Exquisite roads
    Exquisite roads 屏幕截图 2025-10-04 044902.jpg
  • Intelligent obstacle avoidance
    Intelligent obstacle avoidance Equipped with intelligent obstacle avoidance algorithm
  • Roadside structure decoration
    Roadside structure decoration
  • new map
    new map Brand-new adventure map
  • Tree generation blocking
    Tree generation blocking
  • Bridge
    Bridge
  • Terrain Adaptation
    Terrain Adaptation 根据地形来进行切削和填补
  • Winding paths
    Winding paths Bezier curve

Versions

Files

Relations

Project Relations

More like this

Similar Mods

Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.

On ModDex

Community snapshot

0
Ratings
0
Followers
0
In stacks

By the numbers

Statistics

~610,000
Total Downloads
CurseForge
~74,000
Modrinth
~540,000
Last Updated
CurseForge
Modrinth
Created
CurseForge
Modrinth
Last synced
When ModDex last fetched this project from CurseForge or Modrinth. Every project is re-checked on a schedule, and any project that ships a new file is synced automatically within hours of the release.
New file updates sync automatically
How syncing works