RoadWeaver

# RoadWeaver (https://img.shields.io/modrinth/dt/6jk8Pote?style=flat-square&logo=Modrinth&label=Modrinth)](https://modrinth.com/mod/roadweaver) (https://img.shields.io/curseforge/dt/1358489?style=flat-square&logo=CurseForge&label=CurseForge&color=f16436)](https://www.curseforge.com/minecraft/mc-mods/roadweaver) (https://img.shields.io/badge/Discord-Join-5865F2?logo=discord&logoColor=white&style=flat-square)](https://discord.gg/tUJMJkbbr2) (https://img.shields.io/github/stars/shiroha-233/RoadWeaver?logo=github&style=flat-square)](https://github.com/shiroha-233/RoadWeaver) English | (README_CN.md) 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 (https://modrinth.com/mod/countereds-settlement-roads), map inspired by (https://github.com/FranckRJ/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. 智能道路生成 - **智能路径生成**：多种寻路算法，避开陡峭与危险区域；根据地形高度、生物群系与地面稳定性调整路线 - **贝塞尔曲线**：对寻路得到的折线路径应用贝塞尔曲线平滑插值，将其变为更自然的平滑曲线，避免生硬拐弯 - **多种道路类型**： - 人工道路：（石砖