# RoadWeaver
\n
\n
\n
\n<\/p>\n
English | [\u7b80\u4f53\u4e2d\u6587](README_CN.md)<\/p>\n
A Minecraft mod that automatically generates beautiful roads between villages or custom structures.<\/p>\n
## Key Features<\/p>\n
### 1. Smart Road Generation<\/p>\n
– **Intelligent Pathfinding**: Multiple pathfinding algorithms that avoid steep and dangerous areas; adjusts routes based on terrain height, biomes, and ground stability
\n– **Bezier Curves**: Applies Bezier curve smoothing to polyline paths, creating natural smooth curves and avoiding sharp turns
\n– **Multiple Road Types**:
\n – Artificial roads: (stone bricks, slabs), (dirt, mud bricks), etc., or customize your own in the preset editor
\n – Natural roads: Biome-adaptive road materials
\n– **Obstacle Avoidance**: Cuts, fills terrain and removes trees to ensure road passability
\n– **Tunnel & Bridge System**: Tunnels through mountains, bridges over water
\n– **Slab System**: Fills slabs at elevation changes to improve passability
\n– **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<\/p>\n
### 2. Decoration System<\/p>\n
– **Lamp System**: Redstone lamps with automatic day\/night control
\n– **Signpost System**: Distance markers and directional signs
\n– **Roadside Structure Decorations**: Randomly generates benches, campfires and other decorative structures along roads<\/p>\n
### 3. Configuration Options<\/p>\n
– **Performance Optimization**: Multi-threaded async generation with concurrency control; height and terrain caching to reduce redundant calculations
\n– **Multiple Network Planning Algorithms**: KNN (sparsest) \/ Delaunay (densest) \/ RNG (balanced)
\n– **Multiple Pathfinding Algorithms**: A* \/ Bidirectional A* \/ Fluid Simulation
\n– **Road Block Customization**: Mix and match in the preset editor<\/p>\n
### 4. Visualization Tools<\/p>\n
– **Visual Debugging**: Road network map; status colors (planned\/generating\/completed\/failed); interactions (drag, zoom, right-click teleport); statistics for road count, length and status
\n– **Manual Link Mode**: Plan road networks according to your preferences<\/p>\n
## Compatibility<\/p>\n
– New versions (2.0.0+) completely abandon the old `\/locate` command search mechanism, no longer blocking the game main thread
\n– Structure prediction, road network planning and pathfinding all run in dedicated thread pools; main thread only handles driving and result application<\/p>\n
### Known Compatibility & Performance Issues<\/p>\n
– This mod (2.0.6+) is compatible with Tectonic-V2 \/ Epic Terrain \/ Terralith, but **incompatible with Tectonic-V3**
\n– This mod relies on vanilla mechanics, so it’s incompatible with mods that overhaul vanilla mechanics like TerraFirmaCraft: The Next Generation<\/p>\n
**Incompatibility symptoms:**
\n– Extremely slow road generation
\n– Very slow or blank map data loading
\n– Map shows roads as generated but nothing appears when approaching<\/p>\n
**Performance factors:**
\n– World terrain complexity
\n– Pathfinding step size and weight configuration
\n– Concurrent road generation count and thread pool size<\/p>\n
## Usage<\/p>\n
– **Auto Generation**: Roads automatically generate between structures after entering the world
\n– **Road Network Map**: Press **H** to open the debug map and view the road network
\n– **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<\/p>\n
## Inspiration<\/p>\n
Based on Countered’s Settlement Roads, map inspired by RoadArchitect.<\/p>\n
## Future Plans<\/p>\n
– [ ] More roadside decorations?
\n– [x] Link multiple structure types
\n– [ ] Link biomes?
\n– [ ] More beautiful buildings?
\n– [ ] Road events?
\n– [x] Custom linking
\n– [ ] Main road system?
\n– [x] Slab transitions
\n– [x] Bezier curve smoothing<\/p>\n
## Notes<\/p>\n
– The more structures configured to locate when loading a world, the longer world creation takes, but the more complete the road network
\n– Roads cannot generate on already-loaded chunks, so don’t approach road segments before they finish generating<\/p>\n
\u7b80\u4f53\u4e2d\u6587<\/p>\n
\u81ea\u52a8\u5728\u6751\u5e84\u6216\u81ea\u5b9a\u4e49\u7ed3\u6784\u4e4b\u95f4\u751f\u6210\u7f8e\u89c2\u9053\u8def\u7684 Minecraft \u6a21\u7ec4\u3002<\/p>\n
## \u4e3b\u8981\u7279\u6027<\/p>\n
### 1. \u667a\u80fd\u9053\u8def\u751f\u6210<\/p>\n
– **\u667a\u80fd\u8def\u5f84\u751f\u6210**\uff1a\u591a\u79cd\u5bfb\u8def\u7b97\u6cd5\uff0c\u907f\u5f00\u9661\u5ced\u4e0e\u5371\u9669\u533a\u57df\uff1b\u6839\u636e\u5730\u5f62\u9ad8\u5ea6\u3001\u751f\u7269\u7fa4\u7cfb\u4e0e\u5730\u9762\u7a33\u5b9a\u6027\u8c03\u6574\u8def\u7ebf
\n– **\u8d1d\u585e\u5c14\u66f2\u7ebf**\uff1a\u5bf9\u5bfb\u8def\u5f97\u5230\u7684\u6298\u7ebf\u8def\u5f84\u5e94\u7528\u8d1d\u585e\u5c14\u66f2\u7ebf\u5e73\u6ed1\u63d2\u503c\uff0c\u5c06\u5176\u53d8\u4e3a\u66f4\u81ea\u7136\u7684\u5e73\u6ed1\u66f2\u7ebf\uff0c\u907f\u514d\u751f\u786c\u62d0\u5f2f
\n– **\u591a\u79cd\u9053\u8def\u7c7b\u578b**\uff1a
\n – \u4eba\u5de5\u9053\u8def\uff1a\uff08\u77f3\u7816\u3001\u77f3\u677f\uff09\u3001\uff08\u6ce5\u571f\u3001\u6ce5\u7816\uff09\u7b49\uff0c\u4e5f\u53ef\u5728\u9884\u8bbe\u7f16\u8f91\u5668\u4e2d\u81ea\u884c\u642d\u914d
\n – \u81ea\u7136\u9053\u8def\uff1a\u6309\u751f\u7269\u7fa4\u7cfb\u81ea\u9002\u5e94\u9053\u8def\u6750\u6599
\n– **\u907f\u969c\u7cfb\u7edf**\uff1a\u4e3a\u786e\u4fdd\u9053\u8def\u7684\u901a\u8fc7\u6027\uff0c\u4f1a\u5bf9\u5730\u5f62\u8fdb\u884c\u5207\u524a\u3001\u586b\u8865\u3001\u79fb\u9664\u6811\u6728\u7b49\u5904\u7406
\n– **\u96a7\u9053 & \u6865\u6881\u7cfb\u7edf**\uff1a\u9047\u5c71\u5f00\u5c71\u3001\u9047\u6c34\u642d\u6865
\n– **\u534a\u7816\u7cfb\u7edf**\uff1a\u4e3a\u9053\u8def\u6709\u9ad8\u5ea6\u5dee\u7684\u5730\u65b9\u586b\u8865\u534a\u7816\u63d0\u9ad8\u901a\u8fc7\u6027
\n– **\u8def\u57fa\u751f\u6210**\uff1a\u6839\u636e\u9053\u8def\u9ad8\u5ea6\u5bf9\u5468\u56f4\u9ad8\u5ea6\u573a\u8fdb\u884c\u5e73\u6ed1\u63d2\u503c\uff0c\u53ea\u5728\u9053\u8def\u9ad8\u4e8e\u539f\u59cb\u5730\u5f62\u65f6\u586b\u5145\u8def\u57fa\uff0c\u5f62\u6210\u81ea\u7136\u7684”\u51f8”\u5b57\u5f62\u5761\u9762\uff0c\u907f\u514d\u9053\u8def\u60ac\u7a7a\u7684\u540c\u65f6\u53c8\u5b8c\u7f8e\u878d\u5165\u4e86\u5730\u5f62<\/p>\n
### 2. \u88c5\u9970\u7cfb\u7edf<\/p>\n
– **\u8def\u706f\u7cfb\u7edf**\uff1a\u7ea2\u77f3\u706f\u4e0e\u663c\u591c\u81ea\u52a8\u63a7\u5236
\n– **\u8def\u6807\u7cfb\u7edf**\uff1a\u8ddd\u79bb\u6807\u5fd7\u548c\u65b9\u5411\u6307\u5f15
\n– **\u8def\u8fb9\u7ed3\u6784\u88c5\u9970**\uff1a\u5728\u8def\u65c1\u968f\u673a\u751f\u6210\u5ea7\u6905\u3001\u5c0f\u706b\u5806\u7b49\u7ed3\u6784\u88c5\u9970<\/p>\n
### 3. \u914d\u7f6e\u9009\u9879<\/p>\n
– **\u6027\u80fd\u4f18\u5316**\uff1a\u591a\u7ebf\u7a0b\u5f02\u6b65\u751f\u6210\u5e76\u53d1\u63a7\u5236\uff1b\u9ad8\u5ea6\u4e0e\u5730\u5f62\u7f13\u5b58\u51cf\u5c11\u91cd\u590d\u8ba1\u7b97
\n– **\u591a\u79cd\u8def\u7f51\u89c4\u5212\u7b97\u6cd5**\uff1a\u63d0\u4f9b KNN\uff08\u6700\u7a00\u758f\uff09\/ Delaunay\uff08\u6700\u5bc6\u96c6\uff09\/ RNG\uff08\u9002\u4e2d\uff09\u4e09\u79cd\u8def\u7f51\u89c4\u5212\u7b97\u6cd5
\n– **\u591a\u79cd\u5bfb\u8def\u7b97\u6cd5**\uff1a\u63d0\u4f9b A* \/ \u53cc\u5411 A* \/ \u6d41\u4f53\u6a21\u62df \u4e09\u79cd\u5bfb\u8def\u7b97\u6cd5
\n– **\u9053\u8def\u65b9\u5757\u81ea\u5b9a\u4e49**\uff1a\u53ef\u5728\u9884\u8bbe\u7f16\u8f91\u5668\u4e2d\u81ea\u884c\u642d\u914d<\/p>\n
### 4. \u53ef\u89c6\u5316\u5de5\u5177<\/p>\n
– **\u53ef\u89c6\u5316\u8c03\u8bd5**\uff1a\u9053\u8def\u7f51\u7edc\u5730\u56fe\uff1b\u72b6\u6001\u989c\u8272\uff08\u8ba1\u5212\/\u751f\u6210\/\u5b8c\u6210\/\u5931\u8d25\uff09\uff1b\u4ea4\u4e92\uff08\u62d6\u62fd\u3001\u7f29\u653e\u3001\u53f3\u952e\u4f20\u9001\uff09\uff1b\u7edf\u8ba1\u9053\u8def\u6570\u91cf\u3001\u957f\u5ea6\u4e0e\u72b6\u6001
\n– **\u624b\u52a8\u94fe\u63a5\u6a21\u5f0f**\uff1a\u6309\u81ea\u5df1\u7684\u559c\u597d\u6765\u89c4\u5212\u8def\u7f51<\/p>\n
## \u517c\u5bb9\u6027<\/p>\n
– \u65b0\u7248\u672c\uff082.0.0 \u7248\u672c\u4ee5\u4e0a\uff09\u5b8c\u5168\u629b\u5f03\u4e86\u65e7\u7248\u4f9d\u8d56\u7684\u539f\u7248\u6307\u4ee4 `\/locate` \u641c\u7d22\u673a\u5236\uff0c\u4e0d\u4f1a\u963b\u585e\u6e38\u620f\u4e3b\u7ebf\u7a0b
\n– \u7ed3\u6784\u9884\u6d4b\u3001\u8def\u7f51\u89c4\u5212\u548c\u5bfb\u8def\u5747\u5728\u4e13\u7528\u7ebf\u7a0b\u6c60\u4e2d\u6267\u884c\uff0c\u4e3b\u7ebf\u7a0b\u53ea\u8d1f\u8d23\u9a71\u52a8\u4e0e\u7ed3\u679c\u5e94\u7528<\/p>\n
### \u5df2\u77e5\u517c\u5bb9\u6027\u4e0e\u6027\u80fd\u95ee\u9898<\/p>\n
– \u672c\u6a21\u7ec4\uff082.0.6 \u7248\u672c\u4ee5\u4e0a\uff09\u4e0e Tectonic-V2 \u7248 \/ \u53f2\u8bd7\u5730\u5f62 \/ Terralith \u6a21\u7ec4\u517c\u5bb9\uff0c\u4e0e Tectonic-V3 \u7248\u4e0d\u517c\u5bb9
\n– \u672c\u6a21\u7ec4\u4f9d\u8d56\u539f\u7248\u673a\u5236\uff0c\u6240\u4ee5\u4e0e\u7fa4\u5ce6\u4f20\u8bf4\uff1a\u6b21\u4e16\u4ee3\u7b49\u98a0\u8986\u4e86\u539f\u7248\u673a\u5236\u7684\u6a21\u7ec4\u4e0d\u517c\u5bb9<\/p>\n
**\u4e0d\u517c\u5bb9\u5177\u4f53\u8868\u73b0\u4e3a\uff1a**
\n– \u9053\u8def\u751f\u6210\u6781\u4e3a\u7f13\u6162
\n– \u5730\u56fe\u6570\u636e\u52a0\u8f7d\u6781\u4e3a\u7f13\u6162\u751a\u81f3\u957f\u65f6\u95f4\u7a7a\u767d
\n– \u5730\u56fe\u663e\u793a\u5df2\u751f\u6210\u4f46\u8d70\u8fd1\u5374\u5b8c\u5168\u6ca1\u6709<\/p>\n
**\u6027\u80fd\u5f71\u54cd\u56e0\u7d20\uff1a**
\n– \u4e16\u754c\u5730\u5f62\u590d\u6742\u5ea6
\n– \u5bfb\u8def\u6b65\u957f\u3001\u6743\u91cd\u914d\u7f6e
\n– \u9053\u8def\u540c\u65f6\u751f\u6210\u6570\u91cf\u4e0e\u7ebf\u7a0b\u6c60\u6570\u91cf<\/p>\n
## \u4f7f\u7528\u65b9\u5f0f<\/p>\n
– **\u9ed8\u8ba4\u81ea\u52a8\u751f\u6210**\uff1a\u8fdb\u5165\u4e16\u754c\u540e\u9053\u8def\u4f1a\u81ea\u52a8\u5728\u7ed3\u6784\u95f4\u751f\u6210
\n– **\u8def\u7f51\u5730\u56fe**\uff1a\u6309 **H** \u6253\u5f00\u8c03\u8bd5\u5730\u56fe\u67e5\u770b\u9053\u8def\u7f51\u7edc
\n– **\u914d\u7f6e\u9009\u9879**\uff1a\u6a21\u7ec4 Cloth Config API \u914d\u7f6e\u754c\u9762\uff082.0.2 \u4ee5\u4e0a\u7248\u672c\u5df2\u5185\u5d4c\uff09\uff0c\u53ef\u5728\u65b0\u5efa\u4e16\u754c\u754c\u9762\u6216\u5728\u6e38\u620f\u4e2d\u6309\u5feb\u6377\u952e **H** \u6253\u5f00\u5730\u56fe\u540e\u5728\u53f3\u4e0a\u89d2\u6253\u5f00<\/p>\n
## \u6a21\u7ec4\u7075\u611f<\/p>\n
\u6a21\u7ec4\u57fa\u4e8e Countered’s Settlement Roads \u5236\u4f5c\uff0c\u5730\u56fe\u7075\u611f\u6765\u6e90 RoadArchitect\u3002<\/p>\n
## \u672a\u6765\u8ba1\u5212<\/p>\n
– [ ] \u66f4\u591a\u8def\u8fb9\u88c5\u9970\uff1f
\n– [x] \u94fe\u63a5\u591a\u79cd\u7ed3\u6784
\n– [ ] \u94fe\u63a5\u7fa4\u7cfb\uff1f
\n– [ ] \u66f4\u591a\u7cbe\u7f8e\u5efa\u7b51\uff1f
\n– [ ] \u8def\u9014\u4e8b\u4ef6\uff1f
\n– [x] \u81ea\u5b9a\u4e49\u94fe\u63a5
\n– [ ] \u4e3b\u8def\u7cfb\u7edf\uff1f
\n– [x] \u534a\u7816\u8fc7\u6e21
\n– [x] \u8d1d\u585e\u5c14\u66f2\u7ebf\u5e73\u6ed1<\/p>\n
## \u6ce8\u610f\u4e8b\u9879<\/p>\n
– \u8bbe\u7f6e\u91cc\u52a0\u8f7d\u4e16\u754c\u65f6\u5b9a\u4f4d\u7684\u7ed3\u6784\u6570\u91cf\u8d8a\u591a\uff0c\u521b\u5efa\u4e16\u754c\u7684\u65f6\u95f4\u5c31\u8d8a\u4e45\uff0c\u5b8c\u6574\u5ea6\u8d8a\u9ad8
\n– \u9053\u8def\u65e0\u6cd5\u5728\u5df2\u52a0\u8f7d\u533a\u5757\u4e0a\u751f\u6210\uff0c\u6240\u4ee5\uff0c\u5982\u9053\u8def\u672a\u751f\u6210\u5b8c\u6bd5\uff0c\u8bf7\u4e0d\u8981\u8d70\u8fd1\u8be5\u8def\u6bb5<\/p>\n","protected":false},"excerpt":{"rendered":"
RoadWeaver is a Fabric mod designed for Minecraft Java Edition, which automatically weaves elegant road networks between in-game structures such as villages.<\/p>\n","protected":false},"featured_media":133743,"template":"","meta":{"_minecraft_slug":"roadweaver","_minecraft_project_id":"6jk8Pote","_minecraft_author":"shiroha","_minecraft_license":"MIT","_minecraft_downloads":290508,"_minecraft_follows":218,"_minecraft_client_side":"required","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"roadweaver.zip","_minecraft_size_bytes":211928663,"_minecraft_version_count":38,"_minecraft_updated_at":"2026-05-16T19:09:49.172027Z","_minecraft_date_created":"2025-10-06T05:49:46.250189Z","_minecraft_date_modified":"2026-05-03T11:01:00.768250Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/roadweaver","_minecraft_icon_attachment_id":133743,"_minecraft_imported_at":"2026-06-07T21:25:27+00:00","_minecraft_import_hash":"e2370cd2b715dfad297aa288d00ac99c","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,156,97,104,158,869,159],"mod_loader":[99,106,160],"minecraft_version":[36,37,41],"class_list":["post-133742","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-decoration","mod_category-fabric","mod_category-forge","mod_category-neoforge","mod_category-transportation","mod_category-worldgen","mod_loader-fabric","mod_loader-forge","mod_loader-neoforge","minecraft_version-1-20-1","minecraft_version-1-21-1","minecraft_version-1-21-11"],"yoast_head":"\n