RoadArchitect
RoadArchitect 是一个模组，它能自动扫描世界中的村庄和其他结构，并用道路将它们连接起来，形成一个持久的旅行网络。
道路风格会根据生物群系自适应调整，并且网络会在游戏会话之间保存。
> Wiki: RoadArchitect Wiki
✨ 特性
- 🏘 自动检测 村庄和其他结构
- 🎨 生物群系感知的道路风格，增强沉浸感
- 🧭 智能寻路，使用带地形缓存的 A* 算法
- 💾 持久网络 — 道路在会话间保留
- 🔄 完全自动化，设置简单
- 🧰 可通过 Cloth Config 配置 (Fabric / Quilt / NeoForge 必需)
- 🌐 包含本地化：英语、俄语、乌克兰语、西班牙语、法语、德语、中文
- 🛰 可视化道路图调试器，支持平移/缩放、工具提示和颜色图例；在单人游戏中，点击节点可传送到该处 (默认热键 H)
- 🗺 兼容 Terralith — 开箱即用支持 Terralith 世界生成数据包
🧩 附加组件
- RoadArchitect Encounters: Modrinth / Curseforge / Github
📷 截图
平原 (带路灯装饰)
平原
热带草原
沙漠
森林
樱花树林
樱花树林 (带路灯装饰)
针叶林
沼泽
原始云杉针叶林
河流
🗒️ 近期更新
v1.6.0 — 性能改进、生物群系风格、更灵活的配置
亮点
- ⚡ 性能：结构扫描和寻路速度显著提升 (最高约 2 倍)；
- 🌲 路线清理：自动清除道路走廊上的树木；
- 🎨 生物群系风格：为原版生物群系添加了更多默认预设；广泛覆盖 Biomes O' Plenty；
- 🧰 配置：
- 跨维度工作；
- 道路风格自定义；
- 路灯柱自定义；
- 道路宽度自定义；
- 🔧 调试：配置中新增“调试与诊断 (高级)”选项卡；输出调试信息和流水线分析器结果；
- 🐞 修复：修正了 NeoForge 的翻译键。
兼容性：无需重置世界。存档格式未变。现有设置保留。对 Biomes O' Plenty 的支持是可选的，当模组存在时激活。“详细调试日志”标志默认关闭。
v1.5.0 — 更智能的寻路、地形分析器 (测试版)
亮点
- 🧭 地形分析器 (测试版)：更清晰地识别山地地形，提供新的配置选项和完整翻译
- 🧠 寻路控制：可配置的陆地偏好和水体行为 (可接受的水位、海岸缓冲区、最大海岸速度)
- 🛣️ 部分路径：当无法完成完整路线时，高进度搜索可以返回最佳的部分路径
- 🌊 更安全的默认设置：海洋不再被硬性阻挡；默认“禁止生物群系”现在包括 #minecraft:isocean 和 #minecraft:isdeep_ocean
- 🔒 稳定性：线程安全的生物群系选择器缓存 (消除了并发扫描中的竞态条件)
- 🔧 修复：修正了调试地图上的玩家方向和可靠的点传送数据包处理；RA 配置调整
- 🧩 兼容性：改进了安装 Distant Horizons 时的启动行为
- 🌐 本地化与数据：更新了类别标签，为新选项添加了新键，翻译文件拆分并刷新 (EN/RU/ES/FR/DE/ZH/UK)
兼容性：无需重置世界。水体/海洋行为的默认设置已更改 — 如果你依赖自定义配置，请查看新的寻路选项。
v1.4.0 — 附加组件支持
亮点
- 🧩 附加组件支持：官方 API，允许其他模组扩展 Road Architect (事件、只读核心视图和每世界存储)。
- 📴 默认无变化：没有内置附加组件；除非你安装一个，否则游戏玩法保持不变。
兼容性：默认情况下没有可见的游戏玩法变化；附加组件是可选的。
v1.3.0 — 更智能的扫描和确定性装饰
亮点
- 🧠 更智能的扫描：大幅提升大面积扫描和多种结构类型的性能 — 游戏更流畅，道路图更清晰，结构检测更可靠。
- 🌲 确定性装饰：跨区块加载时，装饰物 (路灯、浮标、侧边部件) 的放置位置按路径保持一致 — 减少突然出现的情况，区块边界更整洁。同时修复了常见问题，如漂浮的栅栏柱或偏离网格的浮标。
- 💡 新的路灯装饰：新样式，并在适当时更好地集成栅栏。
- 🧭 调试地图：显示你的位置和方向 (红点 + 箭头)。
- ⚙️ **新设置 (所有加载器)**：
- 路灯间隔
- 侧边装饰间隔
- 浮标间隔
- 陆地/水体过渡处的遮罩侵蚀
- 确定性装饰开关
- 🛤️ 更平滑的道路剖面：后处理减少了尖峰并限制了极端坡度，使高程过渡更整洁。
- 🌐 本地化与 UI：更新了字符串 (EN/RU/ES/FR/DE/ZH) 并修复了一个小的进度阶段标签 (“initialisation”)。
兼容性：无破坏性更改；现有世界保持兼容。
v1.2.0 — 原版加载、便捷设置、视觉调试
亮点
- 🪄 进度屏幕：移除了
owo-lib并切换到原版渲染 (Fabric/Quilt 和 NeoForge)，显示当前流水线阶段。 - 🧭 道路图调试屏幕：平移/缩放、工具提示和颜色图例；在单人游戏中，点击节点可传送到该处。按 H 键打开。
- 🧰 设置：所有加载器均支持 Cloth Config；支持 Mod Menu (Fabric/Quilt)；支持 Catalogue (NeoForge)。
- 🌐 本地化：英语、俄语、西班牙语、法语、德语、中文。
兼容性：无破坏性更改；现有世界保持兼容。
v1.1.0 — 更平滑的路径、更智能的交叉点、更整洁的浮标
亮点
- ⚙️ 寻路 (A / ARA)：调整了启发函数，移除了提前终止，扩展了性能分析。
- 🏗️ 后处理：修剪节点附近的道路，改进了交叉点合并和稳定性。
- 🌊 浮标：仅放置在“干净”的水体上，按实际距离间隔放置，间隔从 12 增加到 18。
- 🔧 修复了注册命令参数时的客户端 ↔ 服务器同步问题。
- 🐛 修复了沼泽风格：使用
MOSSYCOBBLESTONEWALL而不是MOSSY_COBBLESTONE。 - 📦 减小了模组体积。
兼容性：无破坏性更改；来自 1.0.1 的世界完全兼容。
❓ 常见问题
这个模组是服务端吗？还是服务端-客户端都需要？
该模组同时需要服务端和客户端。
要加入服务器，必须在服务器和客户端上都安装此模组。
它兼容 Terralith 世界生成数据包吗？
是的 — RoadArchitect 完全兼容 Terralith。道路可以开箱即用地扫描并连接 Terralith 生物群系中的结构。
只连接村庄吗？
不止！RoadArchitect 可以连接任何可通过 /locate structure 发现的结构。在配置中添加结构 ID 或 #tag，然后重新加载/重启世界以重新扫描。
🌉 相关模组与灵感
- Countered’s Settlement Roads — 在村庄之间生成带有弯曲路径和智能 A* 寻路的道路。
- All Roads — 自动在村庄和其他结构之间生成道路；包括水上的路径点。
感谢作者和社区推动了这个想法的发展。
📜 许可证
本项目采用 Apache License 2.0 许可证 — 详情请见 [LICENSE](LICENSE) 文件。
完整许可证文本：Apache 2.0
为 Minecraft 社区精心打造 ❤️
