E3 Agent探索参数化Minecraft世界实录


0. 开场白:一次“失控”的探索

那天下午我本来只是想试试 L-System 能不能做个好看的分形树。结果…21轮对话后,我面前出现了一个完整的、带地形起伏、湖泊、树林、草丛、花朵、猪鸡羊牛、还能拉滑块实时调参的Minecraft风格3D世界。

我不是在玩游戏,我是在 E3 Editor 里,跟它的内置AI编码助手“闲聊”出来的。

这不是一篇教程(虽然你照着做也能跑),这是一次技术探险的记录——我想把我和AI这趟从“Hello World”到“体素生态圈”的旅程原原本本讲给你听。里面全是坑,也全是爽点。


1. 起点:L-System 能做什么?

第一句话很随意:“L-System能做什么参数化艺术装置?”

AI没废话,直接甩了一段 C# + run_code 脚本——一个完整的L-System引擎加3D Turtle解释器,6种经典分形(Koch雪花、龙曲线、Sierpinski…)瞬间在3D视口里铺开。

当时我心想:这AI有点东西。

但它第一个版本用错了坐标系,树长在XY平面,我喊“搞错平面了”,它立刻把地面改成了XY平面,生长方向转Z+。那感觉就像一个能听懂人话的高级实习生——说一遍就改,再测就对了。


2. 三步跳:概率森林 → Perlin地形 → Minecraft化

2.1 随机森林(概率L-System)

我让AI把确定性规则变成概率的:

  • 40% 左右分叉 F[+F][-F]F
  • 25% 前后分叉 F[^F][&F]F
  • 15% 四向辐射……
  • 30棵树,位置、角度、步长、迭代数全随机。

代码跑起来,一片随机森林在XY平面上“长”了出来。但地面是线框,树是线条,像科幻片里的投影。

2.2 Perlin Noise 注入“灵魂”

我说:“这个结合PerlinNoise能碰撞出什么火花?”

AI立刻找到 E3.Mathematic.PerlinNoise,用三层噪声:

  • 地形场(地面起伏)
  • 密度场(决定哪里长树)
  • 参数场(每棵树高、角度、迭代数)

结果:树真的沿着山脊和山谷分布了,自然得像造物主随手洒的。

2.3 全面换装Minecraft体素

我提了一句“改成Minecraft风格吧”,AI一口气:

  • 把平滑Mesh地形换成 Box3方块堆叠(草/土/石三层)
  • 树干换棕色木块,树叶换绿色球簇
  • 用 PreviewObject 给每个方块上色(RGB精确到Minecraft色板)
  • 草皮做成 薄薄一层0.12高,下面0.88是土——这才是“草方块”的灵魂!

3. 最费劲的一关:Mesh 构建到底怎么用?

对话进行到第6轮时,AI想把地形从线框升级为实面Mesh。结果在 Tulo.Geometry.Mesh 上卡了近10分钟——API用法不对。

// ❌ 直接 Add 面会 IndexOutOfRange
mesh.Faces.Add(new MeshFace(0, 1, 2));

// ✅ 正确姿势:先设容量再设数量再赋值
mesh.Faces.Capacity = faceCount;
mesh.Faces.SetCount(faceCount);
mesh.Faces.SetFace(i, new MeshFace(a, b, c));

后来AI学乖了:遇到陌生API,先用反射或快速测试脚本探路,而不是硬猜。这条经验后来救了无数次。


4. 动物精细化:从“火柴盒”到“像素宠物”

第15轮,我嫌动物太简陋(就是几个方块叠一起)。AI立刻引入三级体素分辨率:

级别 尺寸 用途
TBlock 1×1 地形、树干、树叶
ABlock 0.5×0.5 动物身体段
DBlock 0.25×0.25 腿、鼻、角、尾巴

然后,AI为每种动物手写体素建模函数:

  • 猪:粉色5段身体 + 深粉鼻子 + 4条细腿 + 卷尾
  • 鸡:白色身体 + 红冠 + 黄嘴 + 2条细腿
  • 羊:2×2身体 + 羊毛外壳 + 黑脸 + 4腿
  • 牛:棕白棕三段 + 牛角 + 粉色乳房 + 4腿

每只动物大约20个方块,放在草地上,腿刚好从草皮表面露出来——这个高度计算调了整整一轮(第18轮)。


5. 掌控世界:14个滑块的调参面板

第19轮,我说:“给我一个控制面板,让我掌管这个世界。”

AI用 save_script 把整个脚本包装成参数化模板,暴露了14个参数,分组清晰:

  • :globe_showing_europe_africa: 世界:随机种子、地图大小(小/中/大)
  • :mountain: 地形:山体高度(低/中/高)、生成湖泊(开关)、湖泊大小
  • :deciduous_tree: 植被:树木/草丛/花朵数量
  • :paw_prints: 动物:猪/鸡/羊/牛各自数量

而且 select 类型参数真的是下拉列表,boolean 是勾选框——不再需要我手动改代码里的常量。调参效率提升10倍不止。


6. 那些“惊险一跳”的bug

  • 树变少了? 因为Perlin噪声偏移+100后,输出范围从[-1,1]变成[0.38,0.73],硬阈值0.1导致几乎所有候选位被拒绝。解决:改用地形高度百分位动态决定密度。
  • 动物腿被草皮遮住了? 因为动物起点放在了地面高度gz,而草皮在gz+1以下。修正:把动物抬高到草地表面 gz+1,腿从 gz+1-0.05 开始。
  • 雪花全朝一个方向? 因为它们只在XY平面旋转。修复:用Rodrigues旋转公式给每片雪花随机法向量+自旋,瞬间变成漫天飞舞的立体雪花。

这些坑,AI都跟我一起踩了,然后一起爬出来。


7. 最终成果长什么样?

以默认参数(40×40地图)为例:

  • 地形由约1600个草/土/石方块堆成,高度由Perlin噪声驱动,最多6层。
  • 中心一个蓝色圆形湖泊(可开关)。
  • 30棵树随机长在山谷和缓坡上,树冠是球状叶簇。
  • 150丛草、60朵花(红黄粉蓝)点缀地表。
  • 25只动物(猪鸡羊牛)在草地上悠闲“站立”。

打开E3 Editor的3D视口,用鼠标旋转、缩放——那画面真的像一个小型Minecraft demo,而且还是实时可调参的。


8. 经验总结(给后来的探险者)

对E3 Editor使用者:

  • 从简单开始,逐层叠加。不要一上来就写完整世界,先测L-System,再加噪声,再换体素,每一步都跑通。
  • 善用 save_script。一旦脚本变成参数面板,调参比改代码快10倍。
  • run_code 是试错利器。不确定某个API怎么用,写个5行测试脚本,比翻文档快。
  • 注意.NET版本。E3跑在.NET 10上,一些API的位置和传统文档不一样(比如Stack<T>已移到System.Collections)。

对AI编码助手:

  • 先探索,再写码。Mesh API、Box3构造器,用反射或搜索比“猜”快得多。
  • 噪声偏移是隐形杀手。大坐标偏移会改变噪声输出范围,阈值必须动态计算。
  • 用户对“看起来不对”超级敏感。坐标系、朝向、遮挡——视觉错误比逻辑错误更容易被吐槽。
  • 分级体素是精细化的捷径。1.0/0.5/0.25三层分辨率,让动物细节暴增,而代码只需多写几个辅助函数。
  • 参数类型要分层。select 给直观选择,boolean 给开关,number 给精细调节——每种都有用。

9. 写在最后:AI不是魔法,是“会聊天的工具箱”

这次对话让我深刻感受到:E3 Editor的AI编码助手不是“自动生成器”,而是一个能理解上下文、会试错、会修正、甚至会给你解释“为什么”的协作伙伴。

21轮里,我们翻了无数次车——坐标系错了、阈值失效、动物腿被埋、雪花朝向单一……但每一次,AI都能根据我的反馈调整,而且每次迭代都让成品更逼近我脑子里那个“理想世界”。

现在,我可以打开那个脚本,拖动“随机种子”滑块,瞬间生成一个完全不同地貌的世界;调整“湖泊大小”,湖水就涨退;关掉“生成湖泊”,洼地立即变成草地……

这种“对话式创造”的体验,比写几百行代码爽太多了。

如果你也在E3 Editor里尝试过类似的探索,欢迎留言交流。也许下一次,我们可以造个“会下雪的山脉”或者“有河流的峡谷”——谁知道呢,跟AI聊着聊着就出来了。


工具: E3 Editor(可视化节点编程IDE)
项目: /home/kaivnd/dev/e3-app/assets/empty
最终脚本: 保存为“Minecraft世界生成器”,含14参数面板
记录日期: 2026-07-08