RoadArchitect icon

# RoadArchitect **RoadArchitect** is a **Fabric / Quilt / NeoForge** mod for **Minecraft 1.21–1.21.8** that automatically scans the world for villages and other structures and connects them with roads to form a persistent travel network. Roads adapt their style to the biome, and the network is saved between game sessions. > **Current version:** `v1.4.0` > **Wiki:** RoadArchitect Wiki ## ✨ Features - 🏘 **Automatic detection** of villages and other structures - 🎨 **Biome-aware road styles** for better immersion - 🧭 **Smart pathfinding** using A* with terrain caching - 💾 **Persistent network** — roads remain between sessions - 🔄 **Fully automated**, minimal setup - 🧰 **Configurable** via **Cloth Config** *(required on Fabric / Quilt / NeoForge)* - 🌐 **Localization** included: English, Russian, Ukrainian, Spanish, French, German, Chinese - 🛰 **Visual road-graph debugger** with pan/zoom, tooltips, and a color legend; in singleplayer, clicking a node teleports to it (default hotkey **H**) - 🗺 **Terralith-ready** — works out of the box with the Terralith world-generation datapack --- ## 📷 Screenshots ### Plains (with lamp decorations)

### Plains

### Savanna

### Desert

### Forest

### Cherry grove

### Cherry grove (with lamp decorations)

### Taiga

### Swamp

### Old growth spruce taiga

### River

--- ## 🗒️ Recent changes

v1.4.0 — Add-ons support

### Highlights - 🧩 **Add-ons support**: official API so other mods can extend Road Architect (events, read-only core views, and per-world storage). - 📴 **No changes out of the box**: there are no built-in add-ons; gameplay stays the same unless you install one. **Compatibility:** No visible gameplay changes by default; add-ons are optional.

v1.3.0 — Smarter scans & deterministic decorations

### Highlights - 🧠 Smarter scanning: major performance boost for large-area scans and many structure types—smoother gameplay, cleaner road graphs, and more reliable structure detection. - 🌲 Deterministic decorations: consistent, per-path placement of decorations (lamps, buoys, side pieces) across chunk loads—less pop-in and cleaner chunk borders. Also fixes common issues like floating fence posts or off-grid buoys. - 💡 New Lamp decorations: fresh styles and better fence integration where appropriate. - 🧭 Debug map: shows your position and direction (red dot + arrow). - ⚙️ New settings (all loaders): - Lamp interval - Side decoration interval - Buoy interval - Mask erosion near land/water transitions - Toggle for deterministic decorations - 🛤️ Smoother road profiles: post-processing reduces spikes and clamps extreme slopes for cleaner elevation transitions. - 🌐 Localization & UI: updated strings (EN/RU/ES/FR/DE/ZH) and a small progress-stage label fix (“initialisation”). **Compatibility:** No breaking changes; existing worlds remain compatible.

v1.2.0 — Vanilla loading, convenient settings, visual debug

### Highlights - 🪄 **Progress screen**: dropped `owo-lib` and switched to vanilla rendering (Fabric/Quilt and NeoForge), showing the current pipeline stage. - 🧭 **Road-graph debug screen**: pan/zoom, tooltips, and a color legend; in singleplayer, clicking a node teleports to it. Opens with **H**. - 🧰 **Settings**: **Cloth Config** on all loaders; **Mod Menu** support (Fabric/Quilt); **Catalogue** support (NeoForge). - 🌐 **Localizations**: English, Russian, Spanish, French, German, Chinese. **Compatibility:** No breaking changes; existing worlds remain compatible.

v1.1.0 — Smoother paths, smarter junctions, cleaner buoys

### Highlights - ⚙️ Pathfinding (A* / ARA*): adjusted heuristic, removed early termination, expanded profiling. - 🏗️ Post-processing: trimming roads near nodes, improved junction merging and stabilization. - 🌊 Buoys: placed only on “clean” water, spaced by real distance, interval increased **12 → 18**. - 🔧 Fixed client ↔ server sync when registering command arguments. - 🐛 Fixed swamp style: uses `MOSSY_COBBLESTONE_WALL` instead of `MOSSY_COBBLESTONE`. - 📦 Reduced mod size. **Compatibility:** No breaking changes; worlds from `1.0.1` remain fully compatible.

--- ## ❓ FAQ

Is this mod server side? or is it both server-client sided?

The mod is both server and client sided. To join a server, the mod must be installed on both the server and the client.

Does it work with the Terralith world-generation datapack?

Yes — RoadArchitect is fully compatible with Terralith. Roads scan and connect structures in Terralith biomes out of the box.

Only villages are being connected?

Not only! RoadArchitect can connect any structure discoverable via `/locate structure`. Add the structure IDs or a `#tag` in the config, then reload/restart the world to rescan.

--- ## 📜 License This project is licensed under the **Apache License 2.0** — see the [LICENSE](LICENSE) file for details. Full license text: [Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0)

_{Crafted with ❤️ for the Minecraft community}

0xCoDSnet

0xCoDSnet

RoadArchitect Plus (Core & Add-ons)