PathWeaver

A path-building assistant mod for Minecraft Forge. Select a road cross-section as a template, mark path points along the terrain, and generate a complete road with one click.

Compatibility

• Minecraft: 1.20.1
• Forge: 47.x
• Dedicated Server / LAN Multiplayer: Fully supported, with data stored separately for each player

Getting the Item

Craft the Path Weaver using 7 sticks in a crafting table with the following pattern:

Stick Stick Stick
      Stick
Stick Stick Stick

You can also obtain it directly from the PathWeaver creative tab in Creative Mode. The item is non-stackable.

Controls Overview

Step 1: Select the Template Cross-Section

The template is the road's cross-section. The tool repeats this cross-section along the path direction. Multiple selected regions are supported and merged as a union, which is useful for non-rectangular cross-sections.

Basic Selection

1. Right-click one corner block of the cross-section to mark Corner 1 (gold cross marker)
2. Right-click the opposite corner block to mark Corner 2 and complete one selection region
3. Repeat the above steps to add more regions; all regions are merged into the final template
4. Face the forward path direction, then Shift + Right-click any block to confirm the template

• After confirmation, corner selections are cleared automatically, but the template is kept
• Re-selecting while a template already exists: the old template remains temporarily, and is replaced only after the new one is confirmed; all path points are cleared
• If path points already exist, right-clicking a block shows a confirmation prompt: "This will clear all current path points. Continue?"
• If Corner 1 is already set and you right-click a block: if there are no path points, it marks Corner 2; if path points exist, the action is rejected

Delete a Selection Region

• Left-click any block inside an existing selected region to remove the smallest region containing that position
• Left-clicking outside the selection does not break the block; the action is intercepted

Undo Selection

• /pathweaver undo corner - Cancel the current pending Corner 1
• /pathweaver undo region - Remove the most recently added selection region

Step 2: Mark Path Points

After the template is confirmed, the tool enters path point mode.

• Left-click a ground block to add a path point, up to 256 points
• The XZ-plane projected distance from the new point to the previous point must be at least the template length, otherwise the action is rejected with a "Too close" message
• Shift + Right-click an existing path point to remove that path point
• /pathweaver undo point removes the most recently added path point

Step 3: Generate the Path

Shift + Left-click any block to generate the path.

• Survival Mode: automatically counts required materials by item type. Different block states or orientations of the same block are merged together. If materials are insufficient, the mod shows the missing item names and quantities and consumes nothing. If materials are sufficient, the required items are deducted and the path is generated
• Creative Mode: no material check, no consumption, generate immediately
• After generation, path points are cleared while the template remains, so you can keep building more paths

Placement Modes

Use Shift + Mouse Wheel to switch modes. Switching modes clears all current path points.

LINEAR · Linear Mode (Default)

• Requires at least 2 path points
• Places template instances at equal intervals along straight segments between adjacent path points, with Y coordinates linearly interpolated
• One cross-section is placed every "template length"
• At corners between segments, patch blocks are inserted automatically to fill gaps

BEZIER · Bezier Curve Mode

• Requires at least 3 path points
• Every 3 points form one quadratic Bezier segment, with adjacent segments sharing endpoints
• Odd-numbered points (#1, #3, #5…) are curve endpoints and also serve as shared joints between neighboring segments
• Even-numbered points (#2, #4, #6…) are control points that determine the bend direction and curvature; control points are not necessarily on the curve itself
• Recommended point counts are 2n+1 (3, 5, 7…). Any extra final point will be ignored
• Points are sampled at equal arc-length intervals along the curve, and patch blocks are inserted automatically to fill turning gaps

Undo Operations

Use /pathweaver commands for four specific undo actions:

Generation Undo Details

• Up to the most recent 10 generation records are kept; older ones are discarded automatically
• Blocks are restored in reverse placement order, with proper cross-dimension restoration
• In Survival Mode, consumed materials are refunded. They are returned to the inventory first; if the inventory is full, they are dropped on the ground
• In Creative Mode, only block restoration is performed

Visual Effects

While holding the tool, the client renders real-time effects:

Selection Phase

Path Point Phase

Placement Preview

Notes

• Material checks are aggregated by item type; different block states or orientations of the same item count as the same material
• The Y coordinate of each path point is determined by the clicked block position; the template's vertical layers are applied relative to that Y level
• Bezier control point Y coordinates are also included in curve calculation, so they affect vertical curvature as well
• All cached player data is cleared automatically when the player leaves; rejoining resets everything to empty
• In multiplayer, each player's data is completely independent

PathWeaver

一款用于 Minecraft Forge 的路径铺设辅助 Mod。框选路面截面作为模板，沿地形标记路径点，一键生成完整道路。

兼容性

• Minecraft：1.20.1
• Forge：47.x
• 服务端 / 局域网联机：完全支持，数据按玩家独立存储

获取物品

使用 7 根木棍在工作台中按以下图案合成「路径编织器」：

棍 棍 棍
   棍
棍 棍 棍

也可以在创造模式的 PathWeaver 物品栏标签页中直接拿取。物品不可堆叠。

操作总览

第一步：框选模板截面

模板是路面的「横截面」，工具会沿路径方向重复铺出这个截面。支持框选多个区域取并集，适合非矩形截面场景。

基本框选

1. 右键单击截面的一个角落方块 → 标记角点1（金色十字标记）
2. 右键单击截面的对角落方块 → 标记角点2，完成一个框选区域
3. 可重复以上步骤，继续添加更多框选区域，所有区域取并集构成最终模板
4. 面朝路径前进方向，Shift+右键单击任意方块 → 确认模板

• 模板确认后，角点选区自动清除，模板持久保留
• 已有模板时重新框选：旧模板暂留，确认新模板后旧模板被替换，路径点清空
• 已有路径点时右键方块会弹出确认框：「将清空当前所有路径点，确认继续？」
• 有角点1时右键方块：若没有路径点直接标记角点2；若有路径点则拒绝操作

删除某个框选区域

• 左键单击已框选区域内的任意方块 → 删除包含该位置的最小框选区域
• 左键框外方块 → 不会破坏方块，只拦截操作

撤销框选

• /pathweaver undo corner — 取消当前待定的角点1
• /pathweaver undo region — 删除最近添加的一个框选区域

第二步：标记路径点

模板确认后进入路径点模式，此时可标记路径点。

• 左键单击地面方块 → 添加路径点，上限 256 个
• 新增路径点与上一个点的 XZ 平面投影距离必须 ≥ 模板长度，否则拒绝并提示「间距过近」
• Shift+右键单击已存在的路径点 → 移除该路径点
• /pathweaver undo point → 移除最后一个路径点

第三步：生成路径

Shift+左键单击任意方块 → 生成路径。

• 生存模式：自动统计所需材料（按物品类型汇总，不同朝向的同种方块合并计算），不足时提示缺少的物品名和数量，不消耗任何材料；满足时扣除并生成
• 创造模式：不检查不消耗，直接生成
• 生成后路径点被清除，模板保留，可继续标记新路径生成

铺设模式

按 Shift+滚轮 切换模式，切换时路径点被清除。

LINEAR · 直线模式（默认）

• 至少需要 2 个路径点
• 相邻路径点之间按直线等距铺设，Y 坐标线性插值
• 每隔「模板长度」放置一次截面
• 段间转角处自动插入补丁砖填补空隙

BEZIER · 贝塞尔曲线模式

• 至少需要 3 个路径点
• 每 3 个点构成一段二阶贝塞尔曲线，相邻段共用端点
  • 奇数序号点（#1, #3, #5…）：曲线端点，也作为相邻两段的连接点
  • 偶数序号点（#2, #4, #6…）：控制点，决定弯曲方向和程度，控制点本身不一定在曲线上
• 建议路径点数量为 2n+1（3、5、7…），多余的最后一个点会被忽略
• 沿曲线弧长等距采样放置点，转弯处自动插入补丁砖填补转角空隙

撤销操作

通过 /pathweaver 命令执行四种指定撤销：

生成撤销详情

• 最多保留最近 10 次生成记录，超出自动丢弃最早的
• 按放置逆序还原方块，支持跨维度正确还原
• 生存模式下返还消耗的材料（优先放入背包，背包满时掉落地面）
• 创造模式下仅还原方块

视觉效果

持握工具时在客户端实时渲染：

框选阶段

路径点阶段

铺砖预览

注意事项

• 材料检查按物品类型汇总，同一物品不同朝向的方块状态视为同一种材料
• 路径点的 Y 坐标由点击方块时的位置决定，模板的高度层在该 Y 坐标基础上叠加
• 贝塞尔控制点的 Y 坐标同样参与曲线计算，会影响路径在垂直方向上的弯曲
• 玩家退出时自动清理所有缓存数据，重新登录时重置为空状态
• 多人模式下各玩家数据完全独立