本篇是版本覆盖升级：本站原先是 v1.2.3，这一版是 v1.2.8。两者差别不在功能清单，而在交互方式——1.2.3 是「点一下刷一片」，1.2.8 是「按住鼠标拖着画」。如果你要的是像 ZBrush 那样在曲面上直接刷，这个差别是本质的。
先把一件容易误会的事说清楚：这不是「一键生成地形」的傻瓜工具。StyleForge 卖的是风格化环境的制作手感——地形、石头、草、树都是从零开生成，世界主题只是给了你一套配色和参数起点，做出来好不好看还得你自己调。官方海报上那句 Paint it. Style it. Bring your world to life! 重点在 Paint（画），不在 Generate（生成）。
它把做卡通/游戏风自然场景时最烦的四件事做成了按钮，全塞在 3D Viewport 的 N 侧栏里：往平面上画草（Scatter）、给小物件加描边（Outline）、给模型涂色块（Face Palette）、一键换世界主题（World & Assets）。
整个包只有 818 KB——因为它全部是 Python 代码，不含任何模型、贴图资产。场景里的石头草树都是运行时用 Geometry Nodes 现生成的。这一点买之前该知道。
一、散点绘制：在视口里「画」出一片草，这是它最出圈的功能
官方演示的动作是：在平面上按住左键拖过去，草就长出来了——不是「撒一堆实例」，而是基于顶点（vertex）的散点绘制：一个被刷中的顶点生成一个可见物体。
这套笔刷的行为细节（官方逐条列出，我照抄）：
· 拖过表面形成连续的散布轨迹；
· 按住 Ctrl 拖动 = 擦除已撒的物体；
· 笔刷半径、强度、衰减三个参数都可调；
· 绘制时自动刷新 Geometry Nodes，不用手动重建；
· 自动创建 scatter mask，并显示 mask 与 scatter 层的状态；
· 自动准备默认 Blender 平面，网格细分（划分数）可配——细分越多，能布的点越密；
· 支持平面、地形、其他网格表面；可重建/更新已有 scatter 层；不同资产类型可有各自的 scatter 层。
可以画什么：草、石头、树、花、蘑菇。生成的源资产来自它自己的程序化生成器（见下一条），也可以是你自己的模型。
实现上：包内 scatter_paint.py（33,469 字节）就是这套 modal 笔刷，natural_assets.py（7,861 字节）负责生成石头/草/树。
二、程序化散布：不靠手画，按规则撒
手画适合「这一片我要草、那一片我要石头」的构图控制；大范围就用程序化撒。官方给的参数相当细：
· 密度、随机种子、缩放 min/max、随机旋转、多物体变体、可选 realised geometry；
· 高度控制：min/max scatter height；
· 平面区 / 陡坡区分别放置，坡度上限可调；
· 水面避让（water-level avoidance）+ 岸线安全距离；
· 噪声斑块分布：patch scale / patch detail / patch threshold 三个参数。
还有一个实用设计：手画的散布可以绕过地形过滤，直接放在你想要的位置。也就是说两种方式可以混用——大面积用程序化打底，关键位置手动画。
三、程序化资产生成器：石头、草、树都是现算出来的
· 不规则石头：随机形状、多个变体；
· 草叶/草丛：clump（丛）生成；
· 树：随机变体；
· 生成出来的资产可直接喂给散点系统。
这条解释了为什么包只有 818 KB——它不打包资产，而是打包「造资产的能力」。好处是体积小、可无限变化；代价是风格上限由参数决定，做不到「直接给你一张成品模型」。
四、Smart Outline：三种描边方式自动选，平面不会多出一层皮
描边（outline）在卡通渲染里是刚需，但实现很挑网格类型。StyleForge 的做法是按网格类型自动选方法：
· 平面网格（flat meshes）→ 专用方案；
· 开放网格（open meshes）→ 专用方案；
· 闭合 3D 物体（closed objects）→ inverted-hull 扩展描边。
模式上分 Edge-outline（锐边描边，角度可调） 与 Silhouette-outline（剪影）；另有平面边界描边。宽度、颜色可调。
管理面也齐：创建/更新、移除选中、清空全部、描边集合管理，以及自动清理没用的描边物体与数据。
官方特意标了一个技术点：「Plane-safe」——平面上不会多出一层重复表面。这是很多描边脚本的老毛病：给一个平面做 inverted-hull，结果平面上下各多一层壳，从侧面看就露馅了。它专门处理了这一点。
五、Face Palette：逐面涂色 + 从图片提调色板
涂色部分：逐面（individual faces）上色、从可复用调色板选色、flood-fill 整片填充、自定义颜色、十六进制输入、从主题导入颜色、从程序化材质导入颜色、替换或追加、重复色过滤，调色板直接在 Blender 内管理。
Image-to-Palette（从图片提调色板）：主色提取、唯一色提取；最大色数、采样上限、色彩分离度、透明像素过滤、alpha 阈值五项可调。支持格式很全：PNG / JPG / JPEG / BMP / TGA / TIFF / WebP / EXR / HDR。
十六进制调色板文件：可导出成可读 TXT、可从 TXT 导入、能用普通文本编辑器改。这一点对团队协作有用——配色表可以进版本管理。
还有程序化与主题材质：生成程序化 Blender 材质、直接赋给选中物体、主题预设、造型化材质选项，材质颜色可以反向导入 Face Palette（配色和材质同源）。
六、World & Assets：14 套世界主题，一键搭出整个世界
这是「省时间」最直接的部分。包内 world_presets.json（22,056 字节）里就是这 14 个主题，每套都写了 world_size、terrain_height、terrain noise、植被数量 一整套参数：
写实向：CARTOON（鲜艳卡通：起伏丘陵、彩色橡树、野花、清澈水面）、VIKING（奇幻维京：灰绿高地、松树、暗色水面、冷雾）、TROPICAL（热带岛屿：抬升沙岸、棕榈、明亮海洋）、SNOW（雪山：覆雪松树、冰面、冷蓝）、HAUNTED（闹鬼森林：暗色沼泽、扭曲枯树、发光蘑菇、紫雾）、SCIFI（科幻殖民地：压平异星地形、霓虹晶体、金属岩石）、PIXELFANTASY（像素奇幻：浓烈 RPG 绿、宝蓝与金 + 方块废墟）、SPACEARCADE（太空街机：暗异星地形、青紫信标、金属小行星）。
复古/风格向：NEON80S（80 年代霓虹：黑紫地形、桃红与青、霓虹巨碑）、ARCADE（经典街机：暗色地板配色、饱和红黄蓝方块、辉光）、SYNTHWAVE（落日：品红丘陵、青色点缀、暗色反光水面）、VAPORWAVE（蒸汽波粉彩：柔粉/薰衣草/薄荷/青 + 粉彩柱）、RETROPC（复古电脑：近黑地形、荧光绿高光、琥珀点缀、终端感）、LASERGRID（激光网格：极简暗色地貌、电蓝表面、红色激光）。
流程是：选主题 → 设 world size、地形高度、植被数量 → Build a World → 不满意就 Clear Generated World 一键清掉。另有 UV 工具（Smart UV unwrap、UV 准备、平面自动细分）与图像平面工具（把参考图放到 Blender 平面上）。
包内容（52 个文件 1,047,362 字节，其中原包 50 个文件 818,102 字节）：styleforge/__init__.py 184,065 B（主程序：bl_info + 全部面板与运算符）；styleforge/face_palette.py 67,389 B（逐面涂色）；styleforge/scatter_paint.py 33,469 B（散点绘制的 modal 笔刷）；styleforge/world_presets.json 22,056 B（14 个世界主题参数）；styleforge/natural_assets.py 7,861 B（石头/草/树生成器）；styleforge/palette_bridge.py 6,680 B（调色板与材质互通）；styleforge/ui_icons.py 1,989 B（30 个自定义彩色图标加载器）；icons/ 30 个 PNG（石头、草、树、笔刷、橡皮、调色板、世界、UV、导出、帮助等，每个几百字节到 1 KB）；
文档 9 份：README.md、CHANGELOG.md、QUICK_START.md、UI_GUIDE.md、INSTALLATION.md、TROUBLESHOOTING.md、KNOWN_LIMITATIONS.md、RELEASE_STATUS.md、RELEASE_TEST_CHECKLIST.md、SUPPORT.md，另有完整 PDF 手册 273,041 B 与 Word 手册 187,457 B。原包未改动任何文件。
版本核实（包内一致，官方更新）：__init__.py 的 bl_info 为 "name": "StyleForge"、"author": "SammieYT"、"version": (1, 2, 8)、"blender": (5, 2, 0)、"location": "3D Viewport > Sidebar > StyleForge"、"category": "3D View"。本包是 1.2.8；官方 Gumroad 页当前已写 v1.2.9，本包落后 1 个修订版。
⚠ 本包是 RC 版（作者自己标注）：Documentation/RELEASE_STATUS.md 原文写「Status: Final release」，但同一份文件的下半段又写「This release candidate adds the live multi-face surface brush with [ / ] resizing. Static Python/package validation has passed; the new face brush still requires a Blender 5.2 runtime smoke test before final commercial release.」即：新面笔刷只过了静态校验，作者自己说还要在 Blender 5.2 运行时做冒烟测试才算正式发布。这也是它版本号带 RC、且官方已经发到 1.2.9 的原因。
1.2.8 相对上一版到底改了什么（包内 CHANGELOG.md 原文，逐条）：
1.2.8 RC「Responsive Live Paint」：① Live Paint Faces 批量更新网格、每个鼠标事件只重建一次 GPU 预览；② 降低笔触插值开销，同时保留高精度表面拾取；③ SpaceMouse / NDOF 导航立即穿透，不再强制红raw；④ 去掉 modal 阻塞标志，画画时侧栏控件仍可用；⑤ 画画中可直接选/改调色板颜色，下一笔就用新色；⑥ Ctrl+Z 撤销上一笔且不退出 Live Paint 模式。
1.2.6「Precision Live Paint + Navigation」：精度半径细到 0.000001 场景单位；覆盖面积按真实三角面算（不再按多边形中心）；拖拽每 2 个视口像素重采样；[ 减半 ] 加倍，Shift 微调；最小半径时光标正下方的面一定被包含；导航全穿透。
1.2.4「Live Face Brush」：Face Painting 重做成实时表面笔刷，加 Face Brush Radius、视口圆形预览、多面高亮。
1.2.3 / 1.2.2 / 1.1.0：UI 与文档迭代（1.2.3 把公开作者名统一为 SammieYT、重建 PDF/DOCX 手册；1.2.2 恢复分组面板 UI + 30 个彩色图标）。
安装方式有个容易踩的坑：ZIP 不要解压。官方 INSTALLATION.md 明确写「The downloaded ZIP must remain zipped during installation」「Do not extract the ZIP」。步骤：Edit → Preferences → Add-ons → Install from Disk → 选 ZIP → 搜 StyleForge 并勾选启用 → 关 Preferences → 3D Viewport 按 N → 出现 StyleForge 标签页。
★ 干净更新（装新版前必做）：官方专门写了一节。① 关 Blender；② 到 addons 目录里删掉旧的 styleforge 和 styleforge_ultimate_beta 两个文件夹；③ 重开 Blender；④ 装完整的新版 ZIP（仍不解压）；⑤ 启用。官方原话：不删旧文件夹，Blender 会加载早期版本的缓存模块。从 1.2.3 升到 1.2.8 的人务必照做。
验证装好了：3D Viewport → N 面板 → StyleForge → Help & About，应显示 STYLEFORGE v1.2.8、Author: SammieYT，以及「打开 PDF 手册」「打开文档文件夹」两个按钮。卸载：Preferences 里取消勾选，或关 Blender 后删 addons 目录的 styleforge 文件夹。
官方自认的限制（Documentation/KNOWN_LIMITATIONS.md 原文，逐条）：
① 必须 Blender 5.2 或更新；
② 面板配色跟随你的 Blender 主题，只能靠自定义图标与彩色 badge 区隔，无法任意改面板底色（官方原话）；
③ 自动散点准备会改变默认单面平面的拓扑（给它做细分）；
④ 画出来的散点是「mask 超过阈值的每个顶点生成一个实例」——网格切得越多密度越高、处理开销也越大；
⑤ [ / ] 实时缩放只在 modal 散布笔刷激活且 3D Viewport 有键盘焦点时有效；
⑥ 剪影描边只适合闭合 3D 网格，平面与开放网格请用 Automatic 或 Edge；
⑦ 生成的源集合属于 Geometry Nodes 系统，modifier 激活时别删；
⑧ 世界数量大、realised 实例多、细分值高都会吃内存与视口性能；
⑨ 导出到 Unreal 的结果要在目标工程里自己核（材质、缩放、碰撞要求各项目不同）；
⑩ Blender 新版本可能改 Python API，升级后要重跑 Support Diagnostics。
价格与授权：官方 Gumroad 页结构化数据里同时存在两处币种口径——product:price:amount 写 10.0 GBP，JSON-LD 的 offers.price 写 13.37 USD。两处不一致，以页面实时显示为准。包内 Documentation 提到含 GPL licence 文件说明。
和本站上一篇（v1.2.3）的实质差别：1.2.3 → 1.2.8 之间新增的主要是交互手感而非功能面——实时面笔刷（1.2.4）、精度半径与 2 像素重采样（1.2.6）、导航穿透 + 批量 GPU 更新 + 画画中改色 + Ctrl+Z 不退出（1.2.8）。1.2.3 时仍是「点一下刷一片」的旧模式，1.2.8 才是「按住拖着画」。
顺带说明：本站另有 StyleForge for Maya 条目（v1.0.5，文章 1876），那是同作者的 Maya 版本，功能侧重「一体化风格化世界创建」，与本篇的 Blender 版本不是同一个包。
正版获取：Gumroad 官方页——作者 SammieYT，页面上有完整的逐条功能清单与实时价格。建议从官方买：能拿到 1.2.9 及之后的更新，也能拿到技术支持（作者在包里放了 SUPPORT.md 与 Support Report Checklist，说明他是按工单接支持的）。
原产品页：https://1186312809049.gumroad.com/l/dhzofm
封面图片来自作者官方产品页。本文为中文整理，功能与兼容性信息以作者官方页面与包内说明为准。资源仅供学习交流，商业使用请购买正版授权。
暂无评论内容