RoadWeaver

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> 贝塞尔曲线平滑

注意事项

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