简介HairNet是一款面向Blender用户的Python插件专门用于从网格对象生成毛发引导线适配角色头发、胡须、睫毛等造型设计降低毛发建模的难度与时间成本兼容Blender 2.80与2.79。压缩包共9个文件核心为5个py脚本涵盖主程序、属性导入模块等完整逻辑另附txt版本记录、md说明文档及gitignore配置整包仅24KB轻量易部署。已有765人学习下载。内容包含插件源码、安装指南及版本演进记录可帮助用户快速完成安装并在3D视图的N面板中调用毛发生成功能其中版本说明特别提示了2.80与2.79的界面差异方便不同版本用户对照操作。对于希望学习Blender插件开发或自定义工具的Python使用者清晰的模块划分与注释逻辑也提供了不错的参考可直接复用属性导入等写法。1. HairNet 插件到底是什么用网格拓扑把“刷头发”变成“调网格”Blender 的 HairNet 插件核心思路是让头发建模从“手动逐根刷粒子”变成“先摆网格拓扑再让粒子跟着网格长出来”。第一次用的时候我还在用原生粒子手刷发丝方向全靠笔刷力度刷完一个后脑勺至少要返工三次换成 HairNet 之后发丝方向、密度、长度随机都能通过一个贴合头皮的辅助网格去控制返工成本明显下降。它适合做角色毛发、拟真发型也适合给游戏初模出引导线。这篇笔记围绕几个实际问题展开插件怎么装、最小工作流怎么跑通、哪些参数最值得调、翻车时怎么排查以及如何把结果接进 Geometry Nodes 做动态风。2. HairNet 的底层逻辑网格引导发丝而不是逐根手工画发2.1 为什么选择“网格引导”传统粒子工作流的痛点原生 Blender 毛发工作流里最常见的方式是在粒子编辑模式下用 Comb、Add、Length 这些笔刷去梳发丝。笔刷的思路本身没问题但它有两个天然短板一是方向不连续尤其在头顶转向后脑勺的漩涡区笔刷一次只能带动一小片稍微转个角度发丝方向就阶梯式突变二是局部密度难以量化你很难对一个 50 平方厘米的区域说“这里要比旁边密 30%”只能靠反复刷。HairNet 换了个角度它先让你在头皮上建立一个低多边形网格然后用网格上的边、点和面去描述发流方向。举个直观例子额头发际线到头顶一连串边的走向就是发丝从额头到头顶的生长走向后脑勺的螺旋区用一个收拢的环形拓扑去表达到头旋的收束。这样做的好处是方向信息不再是笔刷压出来的手感数据而是可编辑的拓扑数据想改方向就改网格想加密度就细分网格所有信息都是可回退的。另一个容易被忽略的点是“可重复性”。手刷毛发刷到一个差不多能看的程度存的是粒子缓存换个机器打开缓存路径一断头发就散架。HairNet 的引导网格是普通 mesh 数据存进 .blend 文件里几乎不依赖外部缓存跨机器、跨版本打开方向还在。这一点尤其适合团队协作和需要反复迭代的动画场景。2.2 插件安装与界面入口从偏好设置到侧边栏先说安装。Blender 4.2 之后的版本插件分发主要走扩展仓库HairNet 这类社区插件一般可以在偏好设置的“扩展”页面里搜索安装也可以直接“从磁盘安装”你下载好的压缩包。老版本 Blender 则在“偏好设置 → 插件”里点“安装”选中 zip 包然后在搜索栏输入“HairNet”勾选启用。装完之后不需要重启但有时需要关掉偏好设置窗口界面才会刷新出插件面板。启用后面板不在默认的工具架上常见入口是 3D 视图右侧的 N 侧边栏展开后能找到以 HairNet 命名的标签页。不同小版本里面板里的按钮分组可能叫 Generate、Edit、Convert 这类名字位置略有差异但功能逻辑差不多。我一般会做的第一件事是把侧边栏拉宽一点避免按钮被折叠成省略号否则找 Add Hair Net 要找半天。安装过程中最常见的翻车点是版本不匹配。Blender 迭代很快API 常有变动一些旧版本插件在 4.x 上会直接报导入错误启用后插件列表里那一项会变成红色报错。遇到这种情况不要急着手动改代码先去确认你安装的 zip 是否明确支持当前小版本比如对方标注支持到 4.2就尽量别硬塞给 4.3。不是不能跑但很容易出现“按钮灰了”“面板整个消失”这类玄学问题。2.3 三类对象要认清头皮网格、辅助引导网格、粒子系统HairNet 工作流里其实涉及三类对象刚上手的人经常混成一团。第一类是头皮低模通常就是一个贴合头部形状、法线朝外的网格它负责定义“头发长在哪里”。做法是在编辑模式里选中要长头发的面插件基于这些面的区域生成引导信息。顶点组、权重、面选区的质量直接决定最终头发生长区域的边界。第二类是插件生成的辅助引导网格有些版本里叫 Hair Cap。它是一个依附在头皮表面的小型网格每个点/边都携带发丝方向、长度、密度等信息。你在后续调整发型时主要操作对象就是它而不是头皮网格本身。第三类才是粒子系统辅助网格作为发射源粒子系统负责生成最终的发丝数量与渲染效果。新手最容易犯的错是把粒子系统挂在头皮网格上。结果就是整颗头都长出头发且方向完全不受控制。正确的依赖关系是头皮网格提供选区与权重辅助引导网格承接这些信息并转化成方向粒子系统只负责数量与渲染。理解这三层关系之后再看面板里的按钮就不会觉得神秘了。3. 跑通最小 HairNet 工作流从空场景到一套可渲染发丝3.1 最小流程五步从建头模到出毛先不追求好看只求能跑通链路。我的习惯是用一个 UV Sphere 压扁成椭圆当头部占位具体操作如下第一步新建 UV Sphere进入编辑模式选中上半部分的面大概是从额头发际线到后脑勺发旋的区域反选后删掉其余面形成一个简化的头皮帽。“简化”是关键别在带头发前就抠细节拓扑越干净越容易看出 HairNet 的方向问题。第二步检查法线。编辑模式里打开面朝向显示确认头皮帽所有的面都朝外。法线朝内是后续所有方向的万恶之源发丝会往头皮里钻而不是向外生长。第三步全选头皮网格的面在 N 侧边栏的 HairNet 面板里找到“Add Hair Net”这类生成按钮点击后场景里会多出一个贴合头皮的辅助网格对象。生成后先看一眼网格结构确认它覆盖了你选中的全部头发生长区域。第四步选中辅助网格对象在粒子属性里新建一个粒子系统模式选择 Hair。有些新版本会由插件自动帮你建好粒子系统不用重复添加加了反而会有两套发丝叠加。第五步调整粒子数量、长度切换视图为“渲染预览”确认发丝是贴着头皮朝外长的。如果方向乱先别急着调粒子回去检查辅助网格的拓扑方向——这是最省时间的排查路径。3.2 用脚本校验插件、一键调整粒子参数两个可直接跑的最小示例界面点击能跑通之后可以把重复操作沉淀成脚本。下面这段代码用于校验插件是否加载适合在 Scripting 工作区里跑import bpy # 遍历已启用的插件模块名确认 HairNet 是否在列表里 addon_names set(bpy.context.preferences.addons.keys()) print(HairNet 已启用 if hairnet in addon_names else HairNet 未启用) # 顺便打印当前激活对象方便确认操作对象 print(当前激活对象:, bpy.context.active_object.name if bpy.context.active_object else 无)这段代码不依赖任何具体算子名只做环境确认。输出里如果显示未启用去偏好设置里重新勾选插件如果显示已启用但面板找不到多半是面板折叠或标签页命名不同切一下右侧边栏的各个标签页就能找到。把校验代码放在脚本开头能避免后面一堆操作报错时不知道是哪一步出的问题。插件工作正常后我最常做的是批量调粒子参数。在笔刷手头发阶段微调一次长度至少要在面板里点好几下而脚本可以直接锁定参数import bpy obj bpy.data.objects.get(HairNet) if obj is None: raise RuntimeError(场景里没有名为 HairNet 的对象请检查辅助网格命名) psys obj.particle_systems[0] settings psys.settings # 引导发丝数量实际渲染前不必一次拉满先用低值保证流畅 settings.count 300 # 子发数量HairNet 场景下子发是主要密度来源 settings.child_n 6 # 发丝长度单位是米0.15 表示 15 厘米左右 settings.hair_length 0.15 print(f已设置 count{settings.count}, child_n{settings.child_n})参数里值得多说一句的是hair_length的单位。Blender 默认是米制0.15 换算成现实长度差不多是 15 厘米。如果你建模时头部模型本身就只有 0.1 米高这个长度就明显过长需要先把模型缩放到真实比例再调。很多人的头发看起来像爆炸头不是插件问题是模型比例和长度单位对不上。3.3 发丝的“根”到底长在哪绑定关系与理解错位跑通流程后会有一个常见的理解错位你以为发丝是从头皮表面长出来的但实际上粒子系统的发射源是辅助网格发根位置对应的是辅助网格的顶点位置。这意味着辅助网格离头皮表面越远发根就偏离头皮越多渲染时会看到头发和头皮之间有一条可见的缝隙。解决办法有两个方向一是让辅助网格尽可能贴合头皮生成后通过形变或吸附把网格顶点贴到头皮表面二是在粒子系统里设置较短的“根长度”让发根从发射点向下回缩一点点视觉上贴住头皮。具体用哪种取决于你的模型精度。高模角色我倾向用根长度回缩低模快速验证则直接让辅助网格贴上去减少一个变量。4. 把发量、长度和分布调准确HairNet 的三个核心参数4.1 发根数量与分布粒子 Count 和 Density 顶点组怎么配合很多人调发量时只动 Count从 100 加到 10000结果不是卡成幻灯片就是渲染出来像钢丝球。HairNet 工作流里发量应该分两层来调辅助网格上的密度以及粒子系统里的 Count。辅助网格的密度决定的是“走向控制点的密度”网格越细你能控制的局部细节越多但调起来也越琐碎。粒子 Count 决定的是最终发丝根数。一个比较稳妥的配合方式是先用低粒子和高网格精度去调方向等方向定型后再拉高 Count 并配合 Density 顶点组做局部加密。换个说法就是别让 Count 去弥补网格精度不足那是拿数量换质量结果往往是卡。4.2 长度类参数Size、Rand Size、Fade 的搭配长度参数是毛发看起来自然与否的关键。HairNet 面板里常见的长度相关参数是 Size、Rand Size 和 Fade下面这张表是我自己在角色发型上常用的起始组合参数控制什么常见误解推荐起始值Size基准长度以为是“最终长度”0.12 ~ 0.18Rand Size长度随机比例调大等于均匀拉长0.3 ~ 0.5Fade发尾渐变只影响渲染粗细0.6 ~ 0.8最常见的误用是只调 Size 不调 Rand Size结果所有发丝长度高度统一看起来像戴了一顶剪得过于整齐的假发。真实头发在长度上有明显波动尤其发尾部分。Rand Size 并不是越大越好超过 0.7 之后短碎发会明显变多后脑勺会显得毛躁。Fade 这个参数则负责发尾的收束感。它不是让发梢变细而是控制发丝末段力度衰减让收尾不那么生硬。很多新手忽视它导致渲染出来的头发末梢像被剪刀一刀切平。把 Fade 稍微拉高观感会柔和很多。4.3 Child 粒子最终密度与观感的分水岭HairNet 里真正决定“看起来像不像头发”的往往不是 Count而是 Child 粒子设置。Count 只负责基础引导发丝Child 粒子在引导发丝之间做插值密度立刻上去。我常用的起始方案是Count 设在 200 到 500 之间Child 数量设在 6 到 10 之间。这个组合在 4K 渲染下已经能满足中近景需求而交互帧率还能保持在可控范围。如果画面里有大量角色同屏则优先降 Child把质量让给数量和景深。Child 粒子的“插值模式”也值得关注。简单插值适合快速验证渲染效果偏整齐插值模式则会在发丝之间做更复杂的分布发丝层次感更好但计算量上升。初调阶段用简单模式锁定发型后再切换插值模式做最终渲染能省下不少回头重调的时间。5. HairNet 避坑指南4 个常见的翻车点与排查方法5.1 发丝全部朝向头皮内或乱飞先查法线方向现象生成的头发不是贴在头皮上朝外长而是往颅内扎或者同一片区域发丝朝向五花八门。原因辅助网格的法线方向不统一。HairNet 生成发丝方向时会参考网格法线与边走向法线朝内的区域发丝就被翻转向内生长这在封闭头皮网格上尤其隐蔽。解决回到编辑模式打开“面朝向”显示检查是否有红色表示法线朝内的面全选后按快捷键重新计算外部法线。完成后重新生成或刷新辅助网格。这是我在排查方向问题时第一个检查的点比去调粒子参数高效得多。5.2 局部区域漏发成斑秃低模的细分密度决定“上限”现象发际线、鬓角这些区域总是缺一块粒子数量往上加也补不齐补上的部分还方向混乱。原因辅助网格在生成时基于头皮低模的面密度。低模三角面太稀疏发际线区域只有一两个顶点HairNet 能产生的引导信息就不足粒子插值再强也填不上“数据真空”。解决在生成辅助网格之前先把头皮低模在发际线区域做局部细分让边界处有足够的顶点承载方向信息。之后重新生成 HairNet 辅助网格而不是在旧网格上硬刷。记住一个原则粒子 Count 解决的是“量”网格密度解决的是“质的边界”两件事不能互相替代。5.3 渲染时发丝扎进头皮根点尺寸与根顶点组现象预览时头发看着正常渲染特写镜头时发现发根附近一堆发丝穿进头皮模型头皮表面像长了倒刺。原因发根位置虽然贴着辅助网格但辅助网格与头皮之间仍有细微间隙。粒子系统默认从发射点沿法线生长稍有偏差发丝起点就会低于头皮表面尤其是模型有大量褶皱或细分时误差会被放大。解决优先给粒子系统指定一个根顶点组权重控制发根向表面收缩的幅度也可以适当调短“根长度”参数让发根视觉上嵌进头皮但穿出表面。两种方式可以同时用以最终特写镜头里看不到穿模为准。不要用曲度或长度参数强行掩盖那样只会让发丝整体变形。5.4 Blender 升级后按钮变灰或菜单消失兼容性排查现象升级 Blender 小版本后HairNet 插件在列表里仍显示启用但 3D 视图侧边栏里面板整块消失或者按钮是灰色不可点状态。原因插件代码里调用的某些 API 在升级后被标记为废弃或改名插件没有针对新版本修复运行时只报 warning 不报 error界面相关部分直接不渲染。解决先看 Blender 系统控制台的输出通常会有 warning 日志指向具体 API 问题。快捷方式是切换到该插件的兼容版本或等待维护者发布对应新版的补丁。不要试图自己在不了解源码的情况下删改 API 调用很容易把其他功能也弄坏。我现在的习惯是Blender 大版本和小版本升级之前先查插件的支持声明升级后再用第 3 章那段校验脚本确认插件状态。6. 把 HairNet 的结果接进 Geometry Nodes动态风与卡牌发的进阶玩法HairNet 生成的是传统粒子系统粒子系统虽然渲染成熟但要做程序化动态、风吹拂动、发丝粗细变化时灵活性不如曲线和几何节点。我的做法是发型定稿后把粒子系统转换成曲线再接进 Geometry Nodes。第一条转换路径很直接选中带粒子系统的对象在对象菜单里找到“转换为曲线”或类似功能Blender 会把粒子发丝转成独立的曲线对象。转换完成后原有粒子参数就和曲线脱钩了所以一定要先定稿发型再做转换。转换后在 Geometry Nodes 里给曲线加几个关键节点用“重采样曲线”统一各发丝的控制点数量这一步非常影响后续性能再用“设置曲线半径”按发根到发尾做渐变模拟真实发丝的粗细收束之后用噪波纹理驱动曲线的位置偏移制造自然风感最后接“曲线转网格”配合一个圆环截面做实体化。整套链路的顺序是决定最终观感的骨架。这里有个踩过的坑某次我给 6000 条曲线全部保留了原始控制点再给每条加噪波偏移场景直接卡成 PPT。后来把每条曲线重采样到 8 个控制点再做曲线转网格实时预览立刻流畅渲染效果也没损失多少。控制点数量不是越多越好尤其做远景或中景时8 到 12 个点足够表达发丝动态。从此我做毛发动力学第一件事永远是先减控制点再谈效果。这个习惯帮我省下了大量等待时间希望帮到你。本文还有配套的精品资源点击获取