VoxelWeave织界

把 Axiom 和 VoxelWeave 一起放进客户端的 mods 文件夹，启动游戏。进入世界后按 右 Shift 打开 Axiom，在工具栏找 VoxelWeave 图标，鼠标悬停能看到工具名。

笔刷和建模，差在哪

1. 选素材。笔刷 → 个人 → 组 → 官方预设_原版树林。里面有橡树、白桦、云杉、金合欢和樱花，都是原版生成器长出来的。
2. 调参数。半径 30、间距 12、数量 8、分布 均匀。先别拉满，看得清最重要。
3. 看虚影。鼠标移到已加载的地面上，树的虚影跟着鼠标走。这时世界还没变。
4. 右键落笔。等这一笔放完再刷下一笔。每一笔都会换随机种子，两笔长得不一样是正常的。
5. 撤销。用 Axiom 的撤销，通常是 Ctrl + Z，整笔一起消失。没反应的话，先点一下节点图空白处，多半是输入框占着键盘。

为什么设了 8 棵，有时只种下 5 棵

下面是笔刷的俯视模拟。虚线圈是半径，每个点周围的淡圈是间距。把半径拉小、间距拉大，看实际落点怎么变。

只想放一棵？切到「单体」。单体一次放一个，所以没有数量和间距这些参数。

笔刷节点点击放大

VoxelWeave 里能保存的东西分四层。单体存方块，组和群存“怎么挑素材”的配方，程序存整张建模图。

动手搭

1. 在左侧节点栏选「单体」，加两棵不同的树。在节点图空白处右键也能打开添加菜单。
2. 加一个「组」，把两棵树分别拖到组的两个输入口，再把组连到「输出」。
3. 左键选中组，调每个成员的权重。300 和 100 的意思是“前者更常出现”，不保证每一笔都严格三比一。
4. 需要的话，在通往输出的路上加处理节点（见下表）。
5. 点「保存到个人」。想分享时再选「保存到服务器（公开）」，详情看保存与分享。

先在页面上走一遍。每按一次“下一步”，多接一个节点，看结果怎么一步步出现。

到游戏里做一遍

1. 加载预设。打开建模，在程序下拉框里选 官方预设（仅个人）→「案例 1 · 阶梯山地」。四个节点已经连好。
2. 选位置。鼠标指着地面，右键固定虚影。
3. 改阶梯。左键选中「阶梯高度」，把高度步长从 3 改成 1，再改成 4。数字越大，台阶越明显。
4. 改起伏。在「高度噪声」里一次只改一项：振幅管高低差，尺度管山丘胖瘦，基础高度管整体抬多高。
5. 调位置和大小。用 X / Y / Z 微调锚点，下拉框选锚在中心还是某个角。宽 X、深 Z、高 Y 各自独立，不锁比例。
6. 生成。虚影更新完后按 Enter 或点「应用」。不满意就 Ctrl + Z。

笔刷里右键是落笔，建模里右键只是固定位置。切换工具后，留意左侧的操作提示。

建模节点点击放大

同一座山，只换中间那个节点。点节点名，拖参数，按“对比原山”看差别。滑条的范围和游戏里一致。这里的算法做过简化，到游戏里形状不会一模一样，但变化的方向相同。

连线时看端口：高度接高度，材质接材质。类型不同时要加转换节点。

先玩一下。下面的山由砂岩和石头组成，你只改“选中石头的范围”。过渡带的方块不会变成中间色，而是两种方块按比例混杂，这也是游戏里的效果。

到游戏里接出来

1. 把「连续高度噪声」接到「连续场地形」，这条线做出地形。同一份高度场再接到「世界坡角权重」，这条线算坡度。
2. 加两个「方块材质」，一个选砂岩（A），一个选石头（B）。把 A、B 和坡角权重接到「按权重混合材质」。
3. 把连续场地形和混合后的材质接到「应用材质」，再接「输出」。
4. 最小坡角 30、最大坡角 90、过渡宽度 5。30° 以上选中石头，25° 以下保留砂岩，中间是混杂带。

换成按高度分带

把「世界坡角权重」换成「世界高度权重」，接同一份高度场。例如最小 Y 78、最大 Y 86、过渡 4：78～86 选中石头，74～78 和 86～90 是混杂带，再往外是砂岩。这是选一段高度，不是越高越偏向 B。想让整个山顶都是石头，就把最大 Y 设到山顶以上。

这里用的是世界坐标。整个地形上下移动后，高度带会落到山的另一个位置。界面里直接输入 78 就是 78 格。

让过渡更明显

在权重和材质之间接「权重重映射」。原始比例选取输入的一段，结果比例决定映射后的强弱：0% 选材质 A，100% 选材质 B。「权重反相」把两者对调。

参数可以拖滑条，也可以直接输入，按 Enter 或离开输入框生效。右键参数能复制、粘贴、重置默认值。

先定形状，再定表面。半砖和楼梯改形状，表层绘制只改材质。下面是一刀切开的侧面，方便看到内部。

支持半砖和楼梯的是六种方块族：石头、砂岩、圆石、石砖、红砖、橡木板。草地配色下需要细化的位置会用石材。这几个节点只接地形计划，不能接树和房子的实例计划。

试做时把范围缩小。虚影在小范围内是实心的，大范围会简化成表面，所以别只凭虚影判断内部。生成后从正面和侧面都看一眼。

建模里摆东西要回答两个问题：放什么（素材来源）和放在哪（点集）。「实例化」把两者合在一起，每个点放一次。下面换素材和换点集互不影响，可以分开试。

1. 加「素材来源」，从个人或服务器库选单体、组或群。
2. 加点集节点。规则排列用「点阵」「路径点集」「环形点集」，想要笔刷那样的控制用「笔刷分布」。
3. 把素材和点集分别接到「实例化」，再接输出。要放几种不同的素材，就各做一条，用「合并实例计划」合起来。
4. 改点集参数看虚影。移动点集只改位置，不会放大树或房子。
5. 保存程序，连线、参数和素材引用都会留下。

节点放不下时，游戏会拒绝这组数值并说明原因，原值保留。调小数量或间距就好。「笔刷分布」可以接中心点和范围面罩，多个中心共用同一个数量上限。

存到自己这边

笔刷里点「保存到个人」，建模里点「保存程序」。文件在 Axiom 蓝图目录下的 VoxelWeave 文件夹，默认是 config/axiom/blueprints/VoxelWeave，第一次用会自动创建。改过 Axiom 蓝图位置的话，以游戏实际目录为准。

• 再次保存会更新当前这一份，旧版本留在历史记录里。
• 同名新程序会让你选择覆盖哪一份，或者另存带编号的副本。
• 在程序列表里右键可以重命名或删除。删除的文件移到 VoxelWeave/.trash/models，不会直接抹掉。

和 Axiom 的 BP 互通

1. 把原生 BP 放进本地蓝图库的 VoxelWeave 子目录，两边都刷新列表。
2. 先确认这个单体能显示和放置，再拿它搭组或程序。
3. SCH 文件用素材库的「导入 / 格式互转」转成 BP。原文件留着，转换后检查方块和朝向。

组、群、程序就算和 BP 放在同一个目录，Axiom 也读不了。想把程序的结果变成 BP：先生成到世界，再用 Axiom 框选保存。

传到服务器，就是公开

进入装了配套插件的服务器后，可以选「保存到服务器（公开）」。按下之前，先想好这三件事：

服务器库可以按类型浏览，也能搜素材名、玩家名或 UUID。找到合适的，引用到自己的笔刷或程序里继续搭。

素材库点击放大

把想法说具体，AI 更容易接对节点。比如：“做一块低矮的阶梯山，平地用砂岩，陡坡用石头。”草稿出来后，你可以像手搭的节点一样继续改。生成世界这一步始终由你来按。

在游戏里配置 API

1. 进入可编辑的单人世界或已配对的服务器，打开 AI 面板，填地址、模型和密钥。地址要填完整的 Chat Completions 接口，通常以 /chat/completions 结尾。
2. 点「保存接口」。写下你想做的东西，带上大致尺寸、材质和形状。
3. 点「检查发送内容」，看清楚会发什么。确认后点「确认发送」，模型服务可能会计费。
4. 草稿到了之后点「接纳」，它就进了建模图。如果用到素材，先在本机选好绑定哪一份。
5. 看虚影、改参数，满意后按 Enter 生成。

用 MCP 连接外部 Agent

1. 进入世界，在 AI 面板点「打开 MCP」。想让 Agent 直接改图稿和虚影，再勾选「允许 Agent 编辑本机图稿与虚影」；不勾的话它只能提交草稿给你审。
2. 点「复制 MCP 地址」，在 Agent 的 MCP 设置里添加 HTTP 服务，填入地址和认证头。令牌不要发到聊天或服务器。
3. 让 Agent 先读当前世界和建模图，再说需求。下面这段可以直接复制过去。
4. 回游戏看虚影，继续调整。满意后按 Enter 或点「应用」。

AI 面板点击放大

不用一次认全。先看常用节点，照着接出一条线；需要别的功能时，按游戏里的分类找，或者直接搜你想做的事。